# Guida introduttiva allo streaming a bassa latenza IVS In questo documento sono illustrati i passaggi necessari per configurare il primo streaming live di Amazon Interactive Video Service (IVS). **Topics** + [Fase 1: Creazione di un account AWS](getting-started-create-account.md) + [Fase 2: Configurazione degli utenti root e amministrativi](getting-started-setup-users.md) + [Fase 3: Configurazione delle autorizzazioni IAM](getting-started-iam-permissions.md) + [Fase 4: Creazione di un canale con registrazione facoltativa](getting-started-create-channel.md) + [Fase 5: Configurazione del software di streaming](getting-started-set-up-streaming.md) + [Fase 6: Visualizzazione del live streaming](getting-started-view-stream.md) + [Fase 7: Verifica dei limiti delle Service Quotas (facoltativo)](getting-started-check-service-quota.md) + [Passaggio 8: Prevenzione dei contenuti e degli spettatori indesiderati (consigliato)](getting-started-prevent-undesired-content.md) # Fase 1: Creazione di un account AWS Per utilizzare Amazon IVS è necessario disporre di un account AWS. Se non si dispone di un account, ne richiederemo la creazione durante la registrazione. Per creare un account AWS: 1. Aprire la pagina all'indirizzo [https://portal.aws.amazon.com/billing/signup](https://portal.aws.amazon.com/billing/signup). 1. Seguire le istruzioni online. Come parte della procedura di registrazione si riceverà una telefonata o un messaggio di testo e dovrà essere inserito un codice di verifica. Inoltre, è necessario fornire informazioni di fatturazione anche se il livello di servizio di base è gratuito. Non addebiteremo alcun costo per i servizi AWS per cui si esegue la registrazione a meno che non si decida di utilizzarli. 1. Dopo aver creato l'account, si riceverà un'e-mail con l'**URL di accesso** e **Nome utente** e un'altra e-mail (dall'amministratore dell'account AWS) con la password. Al primo accesso sarà richiesto di modificare la password. Se intendi utilizzare un account AWS esistente, assicurati che utilizzi una regione AWS supportata per Amazon IVS: 1. Passa alla [console di Amazon IVS](https://console.aws.amazon.com/ivs). Se vedi la solita pagina della console IVS (che riporta "Soluzione globale, contenuto regionale"), è tutto normale; passa alla [Fase 2: Configurazione degli utenti root e amministrativi](getting-started-setup-users.md). Se vieni reindirizzato a una pagina di AWS "regione non supportata", devi selezionare una nuova regione. 1. Seleziona la scheda appropriata (**Diretta streaming** per IVS; **Chat in streaming** in Chat di IVS), quindi seleziona una delle regioni elencate. *Prendi nota della regione che scegli; ti servirà in seguito*. Puoi visualizzare l'attività corrente dell'account AWS e gestire l'account in qualsiasi momento accedendo all'indirizzo [https://aws.amazon.com/](https://aws.amazon.com/) e scegliendo **My Account** (Il mio account). # Fase 2: Configurazione degli utenti root e amministrativi Durante la registrazione per un account AWS, viene creato un utente root per l'account AWS stesso. L'utente root ha accesso a tutte le risorse e i servizi AWS in tale account. Come best practice di sicurezza, [assegna l'accesso amministrativo a un utente amministrativo](https://docs.aws.amazon.com/singlesignon/latest/userguide/useraccess.html) e utilizza l'utente root solo per eseguire [attività che richiedono l'accesso di un utente root](https://docs.aws.amazon.com/IAM/latest/UserGuide/root-user-tasks.html). ## Protezione dell'utente root dell'account AWS 1. Per accedere come utente amministrativo in l'utente nel Centro identità IAM, utilizza l'URL di accesso che è stato inviato al tuo indirizzo e-mail quando hai creato l'utente del Centro. Per assistenza nell'accesso mediante un utente del Centro identità IAM, consulta [Accesso al portale di accesso AWS](https://docs.aws.amazon.com/signin/latest/userguide/iam-id-center-sign-in-tutorial.html) nella *Guida per l'utente di Accedi ad AWS*. Per informazioni sull'accesso tramite utente root, consulta [Accesso come utente root](https://docs.aws.amazon.com/signin/latest/userguide/console-sign-in-tutorials.html#introduction-to-root-user-sign-in-tutorial) nella *Guida per l'utente di Accedi ad AWS*. 1. Abilita l'autenticazione a più fattori (MFA) per l'utente root. Per istruzioni, consulta [Abilitazione di un dispositivo MFA virtuale per l'utente root dell'account AWS (console)](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_mfa_enable_virtual.html#enable-virt-mfa-for-root) nella *Guida per l'utente di IAM*. ## Creazione di un utente amministrativo È necessario creare un utente amministrativo in modo da non utilizzare l'utente root per le attività quotidiane. + Per le tue attività amministrative quotidiane, assegna l'accesso amministrativo a un utente amministratore in Centro identità AWS IAM (successore di AWS Single Sign-On). Per istruzioni, consulta la [Nozioni di base](https://docs.aws.amazon.com/singlesignon/latest/userguide/getting-started.html) nella *Guida per l'utente del Centro identità AWS IAM (successore di AWS Single Sign-On)*. + Per accedere come utente amministrativo in l'utente nel Centro identità IAM, utilizza l'URL di accesso che è stato inviato al tuo indirizzo e-mail quando hai creato l'utente del Centro. Per assistenza nell'accesso mediante un utente del Centro identità IAM, consulta [Accesso al portale di accesso AWS](https://docs.aws.amazon.com/signin/latest/userguide/iam-id-center-sign-in-tutorial.html) nella *Guida per l'utente di Accedi ad AWS*. # Fase 3: Configurazione delle autorizzazioni IAM Successivamente, sarà necessario creare una policy AWS Identity and Access Management (IAM) che fornisca agli utenti un set di autorizzazioni di base (ad esempio per creare un canale Amazon IVS, ottenere informazioni in streaming e registrare automaticamente su S3) e assegnare tale policy agli utenti. È possibile assegnare le autorizzazioni durante la creazione di un [nuovo utente](#iam-permissions-new-user) o aggiungere le autorizzazioni a un [utente esistente](#iam-permissions-existing-user). Entrambe le procedure sono riportate di seguito. Per ulteriori informazioni (ad esempio, per informazioni sugli utenti e sulle policy IAM, su come collegare una policy a un utente e su come vincolare ciò che gli utenti possono fare con Amazon IVS), consultare: + [Creazione di un utente IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_create.html#Using_CreateUser_console) nella *Guida per l'utente di IAM* + Le informazioni in [Sicurezza di Amazon IVS](security.md) su IAM e "Policy gestite per IVS". + Per la funzionalità di registrazione su S3: [Utilizzo di ruoli collegati ai servizi](security-service-linked-roles.md) e [Registrazione automatica su Amazon S3](record-to-s3.md) nell'*Amazon IVS User Guide* (Guida per l'utente Amazon IVS) Puoi utilizzare una policy gestita da AWS esistente per Amazon IVS o crearne una nuova che personalizzi le autorizzazioni che desideri concedere a un insieme di utenti, gruppi o ruoli. Entrambi gli approcci sono descritti di seguito. ## Utilizza una policy esistente per le autorizzazioni IVS Nella maggior parte dei casi, ti consigliamo di utilizzare una policy gestita da AWS per Amazon IVS. Sono descritte in dettaglio nella sezione [Policy gestite per IVS](security-iam-awsmanpol.md) di *Sicurezza di IVS*. + Usa la policy gestita da AWS `IVSReadOnlyAccess` per consentire agli sviluppatori di applicazioni di accedere a tutte le operazioni dell'API IVS Get and List (per lo streaming sia a bassa latenza che in tempo reale). + Usa la policy gestita da AWS `IVSFullAccess` per consentire agli sviluppatori di applicazioni di accedere a tutte le operazioni dell'API IVS (per lo streaming sia a bassa latenza che in tempo reale). ## Facoltativo: creazione di una policy personalizzata per le autorizzazioni Amazon IVS Completare la procedura riportata di seguito. 1. Accedere alla Gestione della Console AWS e aprire la console IAM all'indirizzo [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/). 1. Nel riquadro di navigazione, selezionare **Policies (Policy)** e **Create Policy (Crea policy)**. Si apre una finestra **Specifica le autorizzazioni**. 1. Nella finestra **Specifica autorizzazioni** seleziona la scheda **JSON**, quindi copia e incolla la seguente policy IVS nell'area ti testo **Editor delle policy**. (La policy non include tutte le azioni di Amazon IVS. Puoi aggiungere/eliminare (consentire/negare) le autorizzazioni di accesso all'operazione in base alle esigenze. Consulta la [Documentazione di riferimento all'API di streaming a bassa latenza IVS](https://docs.aws.amazon.com//ivs/latest/LowLatencyAPIReference/Welcome.html).) ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "ivs:CreateChannel", "ivs:CreateRecordingConfiguration", "ivs:GetChannel", "ivs:GetRecordingConfiguration", "ivs:GetStream", "ivs:GetStreamKey", "ivs:GetStreamSession", "ivs:ListChannels", "ivs:ListRecordingConfigurations", "ivs:ListStreamKeys", "ivs:ListStreams", "ivs:ListStreamSessions" ], "Resource": "*" }, { "Effect": "Allow", "Action": [ "cloudwatch:DescribeAlarms", "cloudwatch:GetMetricData", "s3:CreateBucket", "s3:GetBucketLocation", "s3:ListAllMyBuckets", "servicequotas:ListAWSDefaultServiceQuotas", "servicequotas:ListRequestedServiceQuotaChangeHistoryByQuota", "servicequotas:ListServiceQuotas", "servicequotas:ListServices", "servicequotas:ListTagsForResource" ], "Resource": "*" }, { "Effect": "Allow", "Action": [ "iam:AttachRolePolicy", "iam:CreateServiceLinkedRole", "iam:PutRolePolicy" ], "Resource": "arn:aws:iam::*:role/aws-service-role/ivs.amazonaws.com/AWSServiceRoleForIVSRecordToS3*" } ] } ``` ------ 1. Sempre nella finestra **Specifica autorizzazioni**, scegli **Successivo** (scorri fino alla fine della finestra per visualizzare questa opzione). Si apre una finestra **Rivedi e crea**. 1. Nella finestra **Rivedi e crea** inserisci un **Nome per la policy** e, facoltativamente, aggiungi una **Descrizione**. Prendi nota del nome della policy poiché sarà necessario per creare gli utenti (di seguito). Scegli **Create policy** (Crea policy) nella parte inferiore della finestra. 1. Tornerai alla finestra della console IAM, dove dovresti vedere un banner che conferma che la tua nuova policy è stata creata. ## Creare un Nuovo utente e Aggiungere autorizzazioni ### Chiavi di accesso utente IAM Le chiavi di accesso IAM sono composte da un ID chiave di accesso e una chiave di accesso segreta. Vengono utilizzati per firmare le richieste a livello di programmazione che fai ad AWS. In mancanza di chiavi di accesso, puoi crearle utilizzando la Console di gestione AWS. Come best practice, non utilizzare le chiavi di accesso dell'utente root. *L'unico momento in cui è possibile visualizzare o scaricare la chiave di accesso segreta è durante la creazione delle chiavi di accesso. Non sarà possibile recuperarle successivamente.* Tuttavia, è possibile creare nuove chiavi di accesso in qualsiasi momento; è necessario disporre delle autorizzazioni per effettuare le operazioni IAM richieste. Conserva sempre le chiavi di accesso in modo sicuro. Non condividerle mai con terze parti (anche se sembra che una richiesta provenga da Amazon). Per ulteriori informazioni, consulta [Gestione delle chiavi di accesso per gli utenti IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html) nella *Guida per l'utente di IAM*. ### Procedura Completare la procedura riportata di seguito. 1. Nel riquadro di navigazione, seleziona **Utenti**, quindi **Crea utente**. Si apre una finestra **Specifica i dettagli dell'utente**. 1. Nella finestra **Specifica i dettagli dell'utente**: 1. Sotto a **Dettagli dell'utente**, digita il nuovo **Nome utente** da creare. 1. Seleziona la casella di controllo **Console di gestione AWS**. 1. Quando richiesto, seleziona **Desidero creare un utente IAM**. 1. Per **Console password** (Password della console), seleziona **Autogenerated password** (Password generata automaticamente). 1. Seleziona la casella di controllo **Gli utenti devono creare una nuova password all'accesso successivo**. 1. Scegli **Next (Successivo)**. Si apre una finestra **Imposta autorizzazioni**. 1. Sotto a **Imposta autorizzazioni**, seleziona **Collega direttamente le policy esistenti**. Si apre una finestra **Policy di autorizzazione**. 1. Nella casella di ricerca, inserisci il nome di una policy IVS (una policy gestita da AWS o personalizzata creata in precedenza). Una volta trovato, seleziona la casella per selezionare la policy. 1. Seleziona **Successivo** (nella parte inferiore della finestra). Si apre una finestra **Rivedi e crea**. 1. Nella finestra **Rivedi e crea**, conferma che tutti i dettagli dell'utente siano corretti, quindi scegli **Crea utente** (nella parte inferiore della finestra). 1. Si apre la finestra **Recupera password**, contenente i **Dettagli di accesso alla console**. *Salva queste informazioni in modo sicuro per l'utilizzo futuro*. Al termine, seleziona **Torna all'elenco utenti**. ## Aggiungere autorizzazioni a un utente esistente Completare la procedura riportata di seguito. 1. Accedere alla Gestione della Console AWS e aprire la console IAM all'indirizzo [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/). 1. Nel pannello di navigazione, scegliere **Utenti**, quindi un nome utente esistente da aggiornare. (Scegli il nome facendo clic su di esso; non selezionare la casella di selezione.) 1. Nella pagina **Riepilogo**, nella scheda **Autorizzazioni**, seleziona **Aggiungi autorizzazioni**. Si apre una finestra **Aggiungi autorizzazioni**. 1. Seleziona **Attach existing policies directly (Collega direttamente le policy esistenti)**. Si apre una finestra **Policy di autorizzazione**. 1. Nella casella di ricerca, inserisci il nome di una policy IVS (una policy gestita da AWS o personalizzata creata in precedenza). Una volta trovata la policy, seleziona la casella per selezionarla. 1. Seleziona **Successivo** (nella parte inferiore della finestra). Si apre una finestra **Rivedi**. 1. Nella finestra **Rivedi**, seleziona **Aggiungi autorizzazioni** (nella parte inferiore della finestra). 1. Nella pagina di **riepilogo**, verifica che la policy IVS sia stata aggiunta. # Fase 4: Creazione di un canale con registrazione facoltativa Un canale Amazon IVS memorizza le informazioni di configurazione relative allo streaming live. Per prima cosa è necessario creare un canale e poi contribuire al video utilizzando la chiave di flusso del canale per avviare lo streaming live. Come parte della creazione del canale, vengono assegnati i seguenti elementi: + Un *server di acquisizione* identifica uno specifico componente Amazon IVS che riceve il flusso insieme a un protocollo di acquisizione (RTMPS o RTMP). + Amazon IVS assegna una *chiave di streaming* quando si crea un canale e la utilizza per autorizzare lo streaming. ***Tratta la chiave di streaming come un segreto, poiché consente a chiunque di trasmettere in streaming al canale***. + A*URL di riproduzione* identifica l'endpoint per avviare la riproduzione per un canale specifico. Questo endpoint può essere utilizzato a livello globale. Seleziona automaticamente la posizione migliore dalla rete globale di distribuzione dei contenuti (CDN) Amazon IVS per consentire a uno spettatore di trasmettere il video. Tenere presente che Amazon IVS non supporta domini personalizzati per la riproduzione. *Non utilizzare un proxy per l'URL di riproduzione con il proprio dominio; ciò non funziona e causerà problemi*. È possibile creare un canale, con o senza registrazione, tramite la console Amazon IVS o con la AWS CLI. La creazione e la registrazione dei canali vengono trattate di seguito. # Registrazione automatica su Amazon S3 Si ha la possibilità di abilitare la registrazione per un canale. Se la funzione di registrazione automatica su S3 è abilitata, tutti i flussi sul canale vengono registrati e salvati in un bucket di archiviazione Amazon S3 di proprietà. Successivamente, la registrazione è disponibile per la riproduzione on demand. *L'impostazione di questa funzione è un'opzione avanzata.* Per impostazione predefinita, quando viene creato un canale la registrazione è disabilitata. Prima di poter configurare un canale per la registrazione, è necessario creare una *Configurazione di registrazione*. Si tratta di una risorsa che specifica una posizione Amazon S3 in cui vengono archiviati i flussi registrati per il canale. È possibile creare e gestire le configurazioni di registrazione utilizzando la console o la CLI; entrambe le procedure sono riportate di seguito. Dopo avere creato la configurazione di registrazione, la si associa a un canale quando si crea il canale (come descritto di seguito) o successivamente, aggiornando un canale esistente. (Nell'API, consultare [CreateChannel](https://docs.aws.amazon.com//ivs/latest/LowLatencyAPIReference/API_CreateChannel.html) e [UpdateChannel](https://docs.aws.amazon.com//ivs/latest/LowLatencyAPIReference/API_UpdateChannel.html).) È possibile associare più canali alla stessa configurazione di registrazione. Esiste la possibilità di eliminare una configurazione di registrazione non più associata ad alcun canale. Tenere presente le seguenti limitazioni: + È necessario essere proprietari del bucket S3. Vale a dire che l'account che imposta un canale da registrare deve possedere il bucket S3 in cui verranno archiviate le registrazioni. + Il canale, la configurazione di registrazione e la posizione S3 devono trovarsi nella stessa Regione AWS. Se si creano canali in altre Regioni e si desidera registrarli, è necessario anche impostare le configurazioni di registrazione e i bucket S3 in tali Regioni. La registrazione sul proprio bucket S3 richiede l'autorizzazione con le credenziali AWS. Per dare a IVS l'accesso richiesto, un [Ruolo collegato al servizio](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html)(SLR) AWS IAM viene creato automaticamente quando viene creata la configurazione di registrazione: l'SLR è limitato a dare il permesso di scrittura a IVS solo sul bucket specifico. Tenere presente che i problemi di rete tra la posizione di streaming e AWS o all'interno di AWS stesso possono causare una perdita di dati durante la registrazione del flusso. In questi casi, Amazon IVS assegna la priorità allo streaming live rispetto alla registrazione. Per la ridondanza, effettuare una registrazione locale tramite lo strumento di streaming. Per ulteriori informazioni (inclusa la configurazione della post-elaborazione o della riproduzione VOD sui file registrati), consultare [Registrazione automatica di IVS su Amazon S3 \$1 Streaming a bassa latenza](record-to-s3.md). ## Come disabilitare la registrazione Per disabilitare la registrazione di Amazon S3 su un canale esistente: + Console: nella pagina dei dettagli del canale pertinente, nella sezione **Registra e archivia i flussi**, selezionare **Disabilitato** quindi **Salva canale**. Ciò rimuove l'associazione della configurazione di registrazione con il canale; i flussi su quel canale non verranno più registrati. + CLI: eseguire il comando `update-channel` e inviare l'ARN di configurazione di registrazione come una stringa vuota: ``` aws ivs update-channel --arn "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh" --recording-configuration-arn "" ``` In questo modo viene restituito un oggetto canale con una stringa vuota per `recordingConfigurationArn`, che indica che la registrazione è disabilitata. # Istruzioni della console per la creazione di un canale IVS Questi passaggi sono suddivisi in tre fasi: configurazione iniziale del canale, impostazione sulla registrazione automatica per Amazon S3 (opzionale) e creazione finale del canale. ## Configurazione iniziale del canale 1. Aprire la [console Amazon IVS](https://console.aws.amazon.com/ivs). È possibile accedere alla console Amazon IVS anche dalla [Console di gestione AWS](https://console.aws.amazon.com/). 1. Dalla barra di navigazione, utilizzare il menu a discesa **Seleziona una Regione** per scegliere una regione. Il nuovo canale verrà creato in questa regione. 1. Nella casella **Nozioni di base** (in alto a destra), selezionare **Crea canale**. 1. In **Configurazione del canale**, accettare la **Configurazione predefinita**. Facoltativamente, specificare un **Nome canale**. I nomi dei canali non sono univoci, ma consentono di distinguere i canali diversi dall'ARN (Amazon Resource Name) del canale. Nota: la **configurazione personalizzata** può essere utilizzata per specificare determinati valori non predefiniti, come il tipo di canale o l'acquisizione RTMP (anziché RTMPS). Le specifiche personalizzate non sono documentate nel presente documento. ![\[Creare un canale utilizzando la console IVS: specificare la configurazione del canale nella finestra Creare canale.\]](http://docs.aws.amazon.com/it_it/ivs/latest/LowLatencyUserGuide/images/Accept_Default_Configuration.png) 1. Se si desidera eseguire la registrazione automatica su Amazon S3, continuare con [Impostazione della registrazione automatica su Amazon S3 (facoltativo)](#getting-started-create-channel-console-record-s3) di seguito. Altrimenti, saltare questa sezione e passare direttamente a [Creazione del canale finale](#getting-started-create-channel-console-final-creation). ## Impostazione della registrazione automatica su Amazon S3 (facoltativo) Seguire questi passaggi per abilitare la registrazione durante la creazione di un nuovo canale: 1. Nella pagina **Crea canale**, in **Registra e archivia i flussi**, attiva **Abilita la registrazione automatica**. Vengono visualizzati altri campi per scegliere una **Configurazione di registrazione** esistente o crearne una nuova. ![\[Creare un canale utilizzando la console IVS: scegliere Registrazione automatica su Amazon S3.\]](http://docs.aws.amazon.com/it_it/ivs/latest/LowLatencyUserGuide/images/Select_Auto_Record.png) 1. Scegliere **Crea configurazione di registrazione**. Appare una nuova finestra, con le opzioni per creare un bucket Amazon S3 e collegarlo alla nuova configurazione di registrazione. ![\[Creare un canale utilizzando la console IVS: specificare le opzioni di archiviazione per la configurazione della registrazione.\]](http://docs.aws.amazon.com/it_it/ivs/latest/LowLatencyUserGuide/images/Click_Create_Recording_Config.png) 1. Compilare i campi: 1. Opzionalmente, inserire un **Nome di configurazione di registrazione**. 1. In **Configurazione del canale**, accettare la **Configurazione di registrazione**. Nota: per specificare determinati valori non predefiniti, come le renderizzazioni registrate o l'unione di flussi frammentati, è possibile utilizzare una **configurazione personalizzata**. Le specifiche personalizzate non sono documentate nel presente documento. 1. Immettere **Bucket name (Nome bucket)**. 1. Selezionare **Creazione di una configurazione di registrazione** per creare una nuova risorsa di configurazione di registrazione con un ARN univoco. In genere, la creazione della configurazione di registrazione richiede poco, ma può durare fino a 20 secondi. Quando viene creata la configurazione di registrazione, viene visualizzata di nuovo la finestra **Crea canale**. In questa finestra, la sezione **Registra e archivia flussi** riporta la nuova **configurazione di registrazione** con lo **stato** impostato su **Attivo** e il bucket S3 (**Archiviazione**) che è stato creato. ![\[Creare un canale utilizzando la console IVS: creazione di una nuova configurazione di registrazione.\]](http://docs.aws.amazon.com/it_it/ivs/latest/LowLatencyUserGuide/images/Create_Recording_Config.png) ## Creazione del canale finale 1. Nella parte inferiore della finestra **Crea canale**, scegli **Crea canale** per creare un nuovo canale con un ARN univoco. Per visualizzare i dettagli del canale, espandi **Dettagli**. Nota: se la registrazione non è stata abilitata, la funzione **Registrazione automatica su S3** è impostata su **Disabilitata** e nella schermata la sezione **Configurazione di registrazione** non è presente. ![\[Creare un canale utilizzando la console IVS: visualizzare la configurazione dello streaming, della riproduzione e della registrazione del canale e le sessioni di streaming nella finestra Dettagli canale.\]](http://docs.aws.amazon.com/it_it/ivs/latest/LowLatencyUserGuide/images/Final_Channel_Creation.png) 1. **Importante**: + Nella sezione **Configurazione dello stream**, prendere nota del **server di acquisizione** e della **chiave di flusso**. Questi valori saranno utilizzati nel passaggio successivo per impostare lo streaming. + Nell'area **Configurazione della riproduzione**, prendere nota dell'**URL di riproduzione**. Lo si userà in seguito per riprodurre il proprio streaming. **Nota**: per visualizzare i valori SRT (endpoint e passphrase), espandi **Altre opzioni di importazione** nell'area **Configurazione del flusso**. # Istruzioni della CLI per la creazione di un canale IVS La creazione di un canale con la AWS CLI è un'opzione avanzata e richiede prima di scaricare e configurare la CLI sul computer. Per maggiori dettagli, consultare la [Guida per l'utente dell'interfaccia a riga di comando di AWS](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html). Seguire una delle due procedure riportate a seconda che si desideri creare un canale con o senza registrazione abilitata. ## Creazione di un canale senza la registrazione 1. Eseguire il comando `create-channel` e inviare un nome facoltativo: ``` aws ivs create-channel --name test-channel ``` 1. Viene restituito un nuovo canale: ``` { "channel": { "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh", "authorized": false, "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net", "insecureIngest": false, "latencyMode": "LOW", "name": "channel-live", "playbackRestrictionPolicyArn": "arn:aws:ivs:us-west-2:123456789012:playback-restriction-policy/abcdABCDefgh", "playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel.abcdEFGH.m3u8", "recordingConfigurationArn": "none", "srt": { "endpoint": "a1b2c3d4e5f6.srt.live-video.net", "passphrase: "ZU5A3yrjGAkghUNDr0c5NXBhsPrjlmtcKMNBluh7oImwJQ3ijeyClvMKxlpPcGAMziICJ", }, "tags": {}, "type": "STANDARD" }, "streamKey": { "arn": "arn:aws:ivs:us-west-2:123456789012:stream-key/g1H2I3j4k5L6", "channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh", "tags": {}, "value": "sk_us-west-2_abcdABCDefgh_567890abcdef" } } ``` 1. **Importante**: prendere nota di `ingestEndpoint`, `streamKey value` e `playbackUrl`. Si useranno questi valori per configurare lo streaming e la riproduzione. ## Creazione di un canale con la registrazione **Prerequisito:** prima di iniziare questa procedura, è necessario creare un bucket Amazon S3 e prendere nota del relativo ARN. Consultare [Nozioni di base su Amazon S3](https://docs.aws.amazon.com//AmazonS3/latest/userguide/GetStartedWithS3.html). Il bucket S3 deve trovarsi nella stessa regione in cui verrà creata una configurazione di registrazione; fare riferimento al problema noto riportato nella Fase 1 di seguito. Quindi, completare la procedura indicata per creare il canale: 1. Eseguire il comando `create-recording-configuration` e inviare l'ARN di un bucket Amazon S3 esistente: ``` aws ivs create-recording-configuration --name configuration-1 --destination-configuration s3={bucketName=test-bucket} ``` Facoltativamente, passare il parametro `thumbnail-configuration` per impostare manualmente la modalità di registrazione delle anteprime e l'intervallo delle anteprime: ``` aws ivs create-recording-configuration --name configuration-1 --destination-configuration s3={bucketName=s3_bucket_name} --thumbnail-configuration recordingMode="INTERVAL",targetIntervalSeconds=60 ``` Facoltativamente, passare il parametro `recording-reconnect-window-seconds` per abilitare la funzionalità di unione di flussi frammentati: ``` aws ivs create-recording-configuration --name configuration-1 --destination-configuration s3={bucketName=test-bucket} --recording-reconnect-window-seconds 60 ``` **Problema noto:** nella Regione us-east-1, se si utilizza AWS CLI per creare una configurazione di registrazione, l'operazione riesce anche se il bucket S3 si trova in una Regione diversa. In questo caso, la `state` della configurazione di registrazione è `CREATE_FAILED` (anziché `ACTIVE`). In altre aree, se il bucket si trova in una regione diversa la CLI restituisce un errore. **Soluzione alternativa:** verificare che il bucket S3 si trovi nella stessa regione della configurazione di registrazione. Se si crea una configurazione di registrazione in una regione diversa da quella del bucket S3, eliminarla e creane una nuova con un bucket S3 dalla regione corretta. 1. In questo modo si avrà una nuova configurazione di registrazione con un ARN univoco. Lo stato della configurazione di registrazione è `CREATING`, a indicare che è in fase di creazione. ``` { "recordingConfiguration": { "arn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/mhndauNaO1te", "name": "configuration-1", "destinationConfiguration": { "s3": { "bucketName": "s3_bucket_name" } }, "recordingReconnectWindowSeconds": 60, "state": "CREATING", "tags": {}, "thumbnailConfiguration": { "recordingMode": "INTERVAL", "targetIntervalSeconds": 60 } } } ``` 1. In genere, la creazione della configurazione di registrazione richiede poco, ma può durare fino a 20 secondi. Per verificare che la configurazione di registrazione sia stata creata, emettere il comando `get-recording-configuration`: ``` aws ivs get-recording-configuration --arn "arn:aws:ivs:us-west-2:123456789012:recording-configuration/mhndauNaO1te" ``` 1. Sarà restituita una risposta che indica che la configurazione di registrazione è stata creata (`state` è `ACTIVE`): ``` { "recordingConfiguration": { "arn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/mhndauNaO1te", "name": "configuration-1", "destinationConfiguration": { "s3": { "bucketName": "s3_bucket_name" } }, "recordingReconnectWindowSeconds": 60, "state": "ACTIVE", "tags": {}, "thumbnailConfiguration": { "recordingMode": "INTERVAL", "targetIntervalSeconds": 60 } } } ``` 1. Per creare un canale e abilitare la registrazione su di esso, eseguire il comando `create-channel` e inviare l'ARN della configurazione di registrazione: ``` aws ivs create-channel --name channel-live --recording-configuration-arn "arn:aws:ivs:us-west-2:123456789012:recording-configuration/mhndauNaO1te" ``` In alternativa, per abilitare la registrazione su un canale esistente, eseguire il comando `update-channel` e inviare l'ARN della configurazione di registrazione: ``` aws ivs update-channel --arn "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh" --recording-configuration-arn "arn:aws:ivs:us-west-2:123456789012:recording-configuration/mhndauNaO1te" ``` 1. Questa operazione restituisce un oggetto canale con un valore diverso da "none" per `recordingConfigurationArn`, che indica che la registrazione è abilitata. La risposta seguente proviene da `create-channel`. La risposta `update-channel` non include l'oggetto `streamKey`. ``` { "channel": { "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh", "authorized": false, "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net", "insecureIngest": false, "latencyMode": "LOW", "name": "channel-live", "playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel.abcdEFGH.m3u8", "recordingConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/mhndauNaO1te", "srt": { "endpoint": "a1b2c3d4e5f6.srt.live-video.net", "passphrase: "ZU5A3yrjGAkghUNDr0c5NXBhsPrjlmtcKMNBluh7oImwJQ3ijeyClvMKxlpPcGAMziICJ", }, "tags": {}, "type": "STANDARD" }, "streamKey": { "arn": "arn:aws:ivs:us-west-2:123456789012:stream-key/g1H2I3j4k5L6", "channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh", "tags": {}, "value": "sk_us-west-2_abcdABCDefgh_567890abcdef" } } ``` 1. **Importante**: prendere nota di `ingestEndpoint`, `streamKey value` e `playbackUrl`. Si useranno questi valori per configurare lo streaming e la riproduzione. # Fase 5: Configurazione del software di streaming Puoi eseguire lo streaming (a bassa latenza) su Amazon IVS con: + Gli [SDK di trasmissione IVS nativi](#broadcast-sdk) che supportano RTMPS. Lo abbiamo consigliato, in particolare per gli scenari di produzione. + La [console Amazon IVS](#ivs-console): è adatta per testare i flussi. + Altri codificatori software e hardware di streaming: è possibile utilizzare qualsiasi codificatore di streaming che supporti i protocolli RTMP, RTMPS o SRT. Di seguito vengono descritti diversi esempi, utilizzando Open Broadcast Software (OBS) e FFmpeg con RTMPS e SRT. RTMPS consente un'elevata sicurezza tramite l'uso di un flusso TLS crittografato. Le impostazioni del codificatore della chiave sono l'intervallo del keyframe (2 secondi) e la risoluzione/bitrate/frequenza fotogrammi (che sono correlati). Per maggiori dettagli sulle impostazioni del codificatore, consultare: + [Configurazione dello streaming](streaming-config.md) nell'*Amazon IVS User Guide* (Guida per l'utente di Amazon IVS) + Questo post del blog: [Configurazione dello streaming con Amazon Interactive Video Service](https://aws.amazon.com/blogs/media/setting-up-for-streaming-with-amazon-ivs/) **Note:** + la durata massima degli stream Amazon IVS è di 48 ore. Successivamente, il flusso viene terminato e la sessione di streaming viene disconnessa. Una riconnessione riuscita (automaticamente o manualmente) avvia un nuovo flusso. + Se il codificatore smette di inviare dati (ad esempio, a causa di un problema temporaneo di rete), Amazon IVS attende 30 secondi. Se durante questo periodo non vengono ricevuti dati dall'emittente, Amazon IVS si disconnette. ## Effettuare lo streaming con l'SDK di trasmissione di Amazon IVS Per trasmettere dalle proprie applicazioni iOS o Android, è possibile utilizzare l'SDK di trasmissione di Amazon IVS. L'SDK di trasmissione sfrutta l'architettura di Amazon IVS e sarà arricchito di miglioramenti continui e nuove funzionalità, insieme ad Amazon IVS. Essendo un SDK di trasmissione mobile nativo, è progettato per ridurre al minimo l'impatto sulle prestazioni dell'applicazione e dei dispositivi utilizzati dagli utenti per accedere all'applicazione. | Per trasmettere da… | È possibile utilizzare… | Note | | --- | --- | --- | | Le applicazioni Android o iOS | SDK di trasmissione Amazon IVS Android o iOS | Essendo un SDK di trasmissione mobile nativo, è progettato per ridurre al minimo l'impatto sulle prestazioni dell'applicazione e dei dispositivi utilizzati dagli utenti per accedere all'applicazione. | | Un ambiente Web | SDK di trasmissione Web di Amazon IVS | In quanto SDK per trasmissione Web, l'SDK di trasmissione Web di Amazon IVS consente di trasmettere da ambienti Web utilizzando WebRTC. Vanta il supporto multibrowser e multipiattaforma. | Per dettagli, consultare [SDK di trasmissione IVS \$1 Streaming a bassa latenza](broadcast.md). ## Streaming con la console Amazon IVS 1. Aprire la [console Amazon IVS](https://console.aws.amazon.com/ivs). È possibile accedere alla console Amazon IVS anche dalla [Console di gestione AWS](https://console.aws.amazon.com/). 1. Nel riquadro di navigazione, scegli **Canali**. (Se il riquadro di navigazione è compresso, espandilo selezionando l'icona dell'hamburger.) 1. Seleziona il canale su cui desideri trasmettere per accedere alla relativa pagina dei dettagli. 1. Seleziona la scheda **Trasmissione**. Le schede sono sotto la sezione **Configurazione generale**. 1. Ti verrà richiesto di concedere alla console IVS l'accesso alla videocamera e al microfono; **Consenti** tali autorizzazioni. 1. Nella parte inferiore della scheda **Trasmissione**, utilizza le caselle a discesa per selezionare i dispositivi di input per il microfono e la videocamera. 1. Per iniziare lo streaming, seleziona **Avvia trasmissione**. 1. Per visualizzare lo streaming live, vai alla scheda **Riproduzione**. **Nota**: dopo aver avviato lo streaming, è previsto un breve ritardo (di solito inferiore a 30 secondi) prima che sia visualizzabile nella scheda di riproduzione. Puoi utilizzare questa funzione per trasmettere simultaneamente su più canali. **Nota**: lo streaming dalla console consuma risorse e comporta costi di input per i video in diretta. Per ulteriori informazioni, consulta la sezione [Costi di input per i video in diretta](https://aws.amazon.com/ivs/pricing/#Low-Latency_Streaming) nella pagina dei prezzi di IVS. ## Streaming con OBS Studio utilizzando RTMPS [OBS Studio](https://obsproject.com/) è una suite software open source gratuita per la registrazione e lo streaming live. OBS fornisce in tempo reale l'acquisizione di sorgenti e dispositivi, la composizione della scena, la codifica, la registrazione e lo streaming. Seguire questi passaggi per iniziare a usare rapidamente OBS Studio v30.2 o successive: 1. Scaricare e installare il software: [https://obsproject.com/download](https://obsproject.com/download). 1. Eseguire la **Procedura guidata di configurazione automatica** di OBS Studio, visualizzata al primo caricamento di OBS Studio. Seguire i passaggi riportati e accettare le impostazioni predefinite. 1. In **Informazioni sul flusso**, scegli **Amazon IVS** dal menu a discesa **Servizio** e inserisci la **Chiave di flusso**. Se hai creato il canale con la console Amazon IVS, la **Chiave di flusso** da inserire in OBS è la **Chiave di flusso** della console: `sk_us-west-2_abcd1234efgh5678ijkl` Se hai creato il canale con AWS CLI, la **Chiave di flusso** da inserire in OBS è il **valore streamKey** della risposta della CLI `sk_us-west-2_abcd1234efgh5678ijkl` Se il tuo canale IVS è configurato per l'input video multitraccia, seleziona **Abilita video multitraccia**. Facoltativamente, configura le impostazioni **Maximum Video Tracks** e **Maximum Streaming Bandwidth**, che vengono utilizzate per limitare le impostazioni del flusso configurate automaticamente. 1. Per **Video Output Resolution** (Risoluzione di output video) e **Bitrate**, fare riferimento a [Channel Types](streaming-config.md#streaming-config-settings-channel-types) (Tipi di canali) in *Amazon IVS Streaming Configuration* (Configurazione streaming di Amazon IVS). Se uno dei valori scelti dalla procedura guidata OBS supera i valori consentiti da Amazon IVS, è necessario modificare manualmente i valori per evitare una connessione non riuscita ad Amazon IVS. Al termine della procedura guidata: 1. Per regolare la risoluzione video, utilizzare **Settings > Video > Output (Scaled) Resolution** (Impostazioni > Video > Risoluzione di output [in scala]). 1. Per regolare il bitrate video, utilizzare **Settings > Output > Streaming > Video Bitrate** (Impostazioni > Output > Streaming > Bitrate video). **Nota:** ciò non influisce sulla diretta streaming se in precedenza è stata selezionata l'opzione **Abilita video multitraccia**. 1. Consigliamo un **Keyframe Interval** (Intervallo fotogrammi) di 2 secondi per migliorare la stabilità del flusso ed evitare il buffering nella riproduzione del visualizzatore. Al termine della procedura guidata, andare a **Impostazioni > Output > Modalità di output**, selezionare **Avanzate** e nella scheda **Streaming** verificare che **Intervallo fotogrammi** sia 2. **Nota:** Intervallo dei fotogrammi viene configurato automaticamente se in precedenza hai selezionato **Abilita video multitraccia**. 1. Nella finestra principale di OBS Studio, selezionare **Avvia streaming**. Per ulteriori informazioni sullo streaming con OBS Studio, consultare [Avvio rapido di OBS Studio](https://obsproject.com/wiki/OBS-Studio-Quickstart). La modifica manuale delle impostazioni di OBS è possibile in un secondo momento: 1. Selezionare **Impostazioni > Flusso**. 1. Scegli **Amazon IVS** dal menu a discesa. 1. Incolla la **Chiave di flusso**. Eseguire nuovamente la procedura guidata in qualsiasi momento selezionando **Strumenti > Procedura guidata di configurazione automatica**. Facoltativamente, in **Impostazioni > Generali**, abilitare la registrazione locale per salvare lo streaming live per un utilizzo successivo. Come accennato in precedenza, problemi di rete tra la trasmissione e AWS o all'interno di AWS potrebbero causare una perdita di dati durante la registrazione del flusso. In questi casi, Amazon IVS assegna la priorità allo streaming live rispetto alla registrazione. La registrazione locale tramite lo strumento di streaming fornisce ridondanza. Consigliamo di controllare regolarmente la presenza di aggiornamenti di OBS Studio e aggiornare alla versione più recente. (Ad esempio, se viene restituito un errore "Impossibile connettersi al server", è possibile che si stia utilizzando una versione obsoleta di OBS Studio che non supporta RTMPS.) ## Streaming con OBS Studio utilizzando SRT Segui questi passaggi per iniziare a usare rapidamente il protocollo Secure Reliable Transport: 1. Scaricare e installare il software: [https://obsproject.com/download](https://obsproject.com/download). 1. Eseguire la **Procedura guidata di configurazione automatica** di OBS Studio, visualizzata al primo caricamento di OBS Studio. Seguire i passaggi riportati e accettare le impostazioni predefinite. 1. In **Stream Information** (Informazioni di streaming), scegliere **Custom…** (Personalizzato) dal menu a discesa **Service** (Servizio) e inserire **Server (Ingest server)** (Server [Server di acquisizione]) e **Stream Key** (Chiave di streaming). Alla creazione del canale con la AWS CLI: + Il **Server** specificato in OBS è una combinazione di cinque elementi: + Un protocollo di acquisizione: `srt://` + L'**endpoint** della struttura `srt` nella risposta della CLI: `a1b2c3d4e5f6.srt.live-video.net` + Una porta: `9000` + Un streamid, che è il **valore StreamKey** della risposta della CLI: `sk_us-west-2_abcd1234efgh5678ijkl` + Una passphrase, utilizzata per crittografare il contenuto. Utilizzala solo se l'importazione **non sicura** non è abilitata. `ZU5A3yrjGAkghUNDr0c5NXBhsPrjlmtcKMNBluh7oImwJQ3ijeyClvMKxlpPcGAMziICJ` La voce completa è: `srt://a1b2c3d4e5f6.srt.live-video.net:9000?streamid=sk_us-west-2_abcd1234efgh5678ijkl&passphrase=ZU5A3yrjGAkghUNDr0c5NXBhsPrjlmtcKMNBluh7oImwJQ3ijeyClvMKxlpPcGAMziICJ` + La **Chiave di flusso** inserita in OBS rimarrà vuota per il protocollo SRT. 1. Per **Video Output Resolution** (Risoluzione di output video) e **Bitrate**, fare riferimento a [Channel Types](streaming-config.md#streaming-config-settings-channel-types) (Tipi di canali) in *Amazon IVS Streaming Configuration* (Configurazione streaming di Amazon IVS). Se uno dei valori scelti dalla procedura guidata OBS supera i valori consentiti da Amazon IVS, è necessario modificare manualmente i valori per evitare una connessione non riuscita ad Amazon IVS. Al termine della procedura guidata: 1. Per regolare la risoluzione video, utilizzare **Settings > Video > Output (Scaled) Resolution** (Impostazioni > Video > Risoluzione di output [in scala]). 1. Per regolare il bitrate video, utilizzare **Settings > Output > Streaming > Video Bitrate** (Impostazioni > Output > Streaming > Bitrate video). 1. Consigliamo un **Keyframe Interval** (Intervallo fotogrammi) di 2 secondi per migliorare la stabilità del flusso ed evitare il buffering nella riproduzione del visualizzatore. Al termine della procedura guidata, andare a **Impostazioni > Output > Modalità di output**, selezionare **Avanzate** e nella scheda **Streaming** verificare che **Intervallo fotogrammi** sia 2. 1. Nella finestra principale di OBS Studio, selezionare **Avvia streaming**. La modifica manuale delle impostazioni di OBS è possibile in un secondo momento: 1. Selezionare **Impostazioni > Flusso**. 1. Scegliere **Personalizza** dal menu a discesa. 1. Incollare i valori in **Server** e/o **Chiave di streaming**. Eseguire nuovamente la procedura guidata in qualsiasi momento selezionando **Strumenti > Procedura guidata di configurazione automatica**. Facoltativamente, in **Impostazioni > Generali**, abilitare la registrazione locale per salvare lo streaming live per un utilizzo successivo. Come accennato in precedenza, problemi di rete tra la trasmissione e AWS o all'interno di AWS potrebbero causare una perdita di dati durante la registrazione del flusso. In questi casi, Amazon IVS assegna la priorità allo streaming live rispetto alla registrazione. La registrazione locale tramite lo strumento di streaming fornisce ridondanza. Consigliamo di controllare regolarmente la presenza di aggiornamenti di OBS Studio e aggiornare alla versione più recente. Ad esempio, se viene restituito l'errore “Impossibile connettersi al server”, è possibile che si stia utilizzando una versione obsoleta di OBS Studio che non supporta RTMPS. ## Streaming di un video registrato con FFmpeg utilizzando RTMPS Completare la procedura riportata di seguito. 1. Scaricare e installare FFmpeg: [https://www.ffmpeg.org/download.html](https://www.ffmpeg.org/download.html). 1. Impostare `$VIDEO_FILEPATH` sulla posizione di un video MP4 da trasmettere: ``` VIDEO_FILEPATH=/home/test/my_video.mp4 ``` 1. Impostare `STREAM_KEY` sul **valore** di StreamKey: ``` STREAM_KEY=sk_us-west-2_abcd1234efgh5678ijkl ``` 1. Impostare `INGEST_ENDPOINT` sul proprio **ingestEndpoint** (dalla AWS CLI): ``` INGEST_ENDPOINT=a1b2c3d4e5f6.global-contribute.live-video.net ``` 1. Iniziare lo streaming con il seguente comando terminale (tutto su una riga): ``` ffmpeg -re -stream_loop -1 -i $VIDEO_FILEPATH -r 30 -c:v libx264 -pix_fmt yuv420p -profile:v main -preset veryfast -x264opts "nal-hrd=cbr:no-scenecut" -minrate 3000 -maxrate 3000 -g 60 -c:a aac -b:a 160k -ac 2 -ar 44100 -f flv rtmps://$INGEST_ENDPOINT:443/app/$STREAM_KEY ``` *Si prega di notare che il comando precedente è solo un esempio. Per lo streaming di produzione, regolare i parametri in base alle proprie esigenze.* ## Streaming di un video registrato con FFmpeg utilizzando SRT 1. Scaricare e installare FFmpeg: [https://www.ffmpeg.org/download.html](https://www.ffmpeg.org/download.html). Se stai usando una versione vecchia/compilata di FFmpeg, crea una nuova versione con il flag `--enable-libsrt`. 1. Verifica che SRT sia disponibile per l'uso in FFmpeg: esegui il seguente comando e assicurati che nell'output sia presente `libsrt`. Se `libsrt` non è presnte, ricostruisci o procurati una versione più recente di FFmpeg che supporti SRT. ``` ffmpeg -version | grep enable-libsrt ``` 1. Impostare `$VIDEO_FILEPATH` sulla posizione di un video MP4 da trasmettere: ``` VIDEO_FILEPATH=/home/test/my_video.mp4 ``` 1. Impostare `STREAM_KEY` sul **valore** di StreamKey: ``` STREAM_KEY=sk_us-west-2_abcd1234efgh5678ijkl ``` 1. Imposta `INGEST_ENDPOINT` sul tuo **endpoint** (da AWS CLI sotto l'oggetto `srt`): ``` INGEST_ENDPOINT=a1b2c3d4e5f6.srt.live-video.net ``` 1. Imposta `PASSPHRASE` sulla tua **passprase** (da AWS CLI sotto l'oggetto `srt`). Utilizza la passphrase solo se l'importazione non sicura non è abilitata per il canale. ``` PASSPHRASE=ZU5A3yrjGAkghUNDr0c5NXBhsPrjlmtcKMNBluh7oImwJQ3ijeyClvMKxlpPcGAMziICJ ``` 1. Iniziare lo streaming con il seguente comando terminale (tutto su una riga): ``` ffmpeg -re -i $VIDEO_FILEPATH -c copy -f mpegts "srt://$INGEST_ENDPOINT:9000?streamid=$STREAM_KEY&passphrase=$PASSPHRASE” ``` # Fase 6: Visualizzazione del live streaming Puoi visualizzare la diretta streaming con: + Gli [SDK IVS Player](#view-stream-player-sdks) nativi. + La [console Amazon IVS](#view-stream-console). ## Visualizzazione con gli SDK Amazon IVS Player 1. Configura IVS Player. Inizia con la [Panoramica dell'SDK IVS Player](player.md), quindi leggi le guide relative al lettore specifico per la piattaforma. 1. Dalla [console Amazon IVS](https://console.aws.amazon.com/ivs), ottieni l'**URL di riproduzione** generato quando hai creato il tuo canale. Vedi [Creazione del canale finale](create-channel-console.md#getting-started-create-channel-console-final-creation) più avanti in questa *Guida introduttiva*. 1. Chiama `player.load()` con l'URL di riproduzione. ## Visualizzazione con la console Amazon IVS 1. Aprire la [console Amazon IVS](https://console.aws.amazon.com/ivs). È possibile accedere alla console Amazon IVS anche dalla [Console di gestione AWS](https://console.aws.amazon.com/). 1. Nel riquadro di navigazione, selezionare **Live channels** (Canali live). (Se il riquadro di navigazione è compresso, aprirlo prima scegliendo l'icona a hamburger.) 1. Scegliere il canale di cui si vuole visualizzare lo streaming per andare alla pagina dei dettagli per quel canale. Il live streaming è in riproduzione nella sezione **Streaming live** della pagina. **Nota**: la riproduzione dalla console consuma risorse e comporta costi di output per i video in diretta. Per ulteriori informazioni, consulta i [Costi di output per i video in diretta](https://aws.amazon.com/ivs/pricing/#Live_Video_Output_Costs) nella pagina dei prezzi di IVS. **Nota:** dopo avere avviato lo streaming, si verifica un breve ritardo (fino a 30 secondi, in genere meno) prima che lo streaming possa essere visualizzato nella console. # Fase 7: Verifica dei limiti delle Service Quotas (facoltativo) Tutti gli account hanno dei limiti sul numero di spettatori simultanei e trasmissioni simultanee. *Assicurarsi che i propri limiti siano adeguati e richiedere un aumento se necessario, specialmente se si pianifica un evento di streaming di grandi dimensioni*. Per i dettagli, consulta [Service Quotas di IVS](service-quotas.md). # Passaggio 8: Prevenzione dei contenuti e degli spettatori indesiderati (consigliato) Gli utenti malintenzionati potrebbero tentare di trasmettere nuovamente contenuti indesiderati (ad esempio sport professionistici) sulla tua piattaforma o tentare di incorporare i flussi della tua piattaforma su un altro sito web senza autorizzazione. Questo tipo di streaming può aumentare notevolmente la quantità di video in diretta streaming distribuiti dall'applicazione e i costi associati senza aggiungere valore alla tua attività. Oltre a fornire controlli per interrompere i flussi attivi, Amazon IVS fornisce risorse per rilevare e prevenire questo tipo di comportamento prima ancora che si verifichi; consulta la sezione [Contenuti e spettatori indesiderati in IVS](undesired-content.md). Per limitare la riproduzione a origini e/o paesi specifici, utilizza una policy di restrizione della riproduzione. Queste politiche possono essere utilizzate solo con i canali pubblici. [Contenuti e spettatori indesiderati in IVS](undesired-content.md) tratta anche l'uso di canali privati per controllare i contenuti indesiderati. Nota: le policy di restrizione della riproduzione (ad esempio, il geoblocking) non possono essere utilizzate in contemporanea con l'autorizzazione alla riproduzione. Se l'autorizzazione alla riproduzione è abilitata per un canale, tutte le policy di restrizione della riproduzione configurate verranno ignorate. Per applicare restrizioni geografiche su un canale privato, convalida la posizione dell'utente all'interno della logica di generazione dei token prima di emettere un token di riproduzione.