Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Riproduzione video con HLS
HTTP Live Streaming (HLS)
È possibile usare HLS per la riproduzione in tempo reale. La latenza è in genere compresa tra 3 e 5 secondi, ma può essere compresa tra 1 e 10 secondi, a seconda del caso d'uso, del lettore e delle condizioni di rete. Puoi usare un lettore di terze parti (ad esempio Video.js
Per visualizzare uno streaming video Kinesis utilizzando HLS, crea innanzitutto una sessione di streaming utilizzando l'URL GetHLS. StreamingSession Questa operazione restituisce un URL (contenente un token di sessione) per l'accesso alla sessione HLS. Puoi quindi usare l'URL in un lettore multimediale o in un'applicazione autonoma per visualizzare il flusso.
Importante
Non tutti i file multimediali inviati a Kinesis Video Streams possono essere riprodotti tramite HLS. Vedi GetHLSStreamingSessionURL per i requisiti di caricamento specifici.
Argomenti
Usa AWS CLI per recuperare l'URL di una sessione di streaming HLS
Segui la procedura riportata di seguito per utilizzare AWS CLI per generare un URL di sessione di streaming HLS per un flusso video Kinesis.
Per le istruzioni di installazione, consulta la Guida per l'AWS Command Line Interface utente. Dopo l'installazione, configura AWS CLI con credenziali e regione.
In alternativa, apri il AWS CloudShell terminale, su cui è AWS CLI installato e configurato. Per ulteriori informazioni, consulta la Guida per l'AWS CloudShell utente.
Recupera l'endpoint URL HLS per il tuo streaming video Kinesis.
Digita quanto segue nel terminale:
aws kinesisvideo get-data-endpoint \ --api-name GET_HLS_STREAMING_SESSION_URL \ --stream-nameYourStreamNameRiceverai una risposta simile alla seguente:
{ "DataEndpoint": "https://b-1234abcd.kinesisvideo.aws-region.amazonaws.com" }Effettua la richiesta dell'URL della sessione di streaming HLS all'endpoint restituito.
Riceverai una risposta simile alla seguente:
{ "HLSStreamingSessionURL": "https://b-1234abcd.kinesisvideo.aws-region.amazonaws.com/hls/v1/getHLSMasterPlaylist.m3u8?SessionToken=CiAz...DkRE6M~" }Importante
Non condividere o archiviare questo token in modo che un'entità non autorizzata possa accedervi. Il token fornisce l'accesso al contenuto dello stream. Proteggi il token con le stesse misure che utilizzeresti con AWS le tue credenziali.
Puoi utilizzare questo URL e qualsiasi lettore HLS per visualizzare lo stream HLS.
Ad esempio, usa VLC media player.
Puoi anche riprodurre HLS Stream inserendo l'URL della sessione di streaming HLS nella barra degli indirizzi dei browser Apple Safari o Microsoft Edge.
Esempio: usa HLS in HTML e JavaScript
L'esempio seguente mostra come utilizzare l' AWS SDK per la versione JavaScript 2 per recuperare una sessione di streaming HLS per un flusso video Kinesis e riprodurla in una pagina Web. L'esempio mostra come riprodurre video con i lettori seguenti:
Visualizza il codice di esempio completo
Argomenti illustrati nel codice:
Importa l' AWS SDK JavaScript per i browser
Nella pagina Web, includi il seguente tag di script per importare l' AWS SDK per JavaScript v2 nel progetto.
<script src="https://cdnjs.cloudflare.com/ajax/libs/aws-sdk/2.490.0/aws-sdk.min.js"></script>
Per ulteriori informazioni, consulta l'AWS SDK per la documentazione. JavaScript
Configurazione del client Kinesis Video Streams
Per accedere ai video in streaming con HLS, devi prima creare e configurare il client Kinesis Video Streams. Vedi Impostazione delle credenziali in un browser Web per altri metodi di autenticazione.
const clientConfig = { accessKeyId: 'YourAccessKey', secretAccessKey: 'YourSecretKey', region: 'us-west-2' }; const kinesisVideoClient = new AWS.KinesisVideo(clientConfig);
L'applicazione recupera i valori necessari dalle caselle di input nella pagina HTML.
Recupera l'endpoint per la riproduzione HLS
Usa il client Kinesis Video Streams per GetDataEndpoint richiamare l'API per recuperare l'endpoint.
const getDataEndpointOptions = { StreamName: 'YourStreamName', APIName: 'GET_HLS_STREAMING_SESSION_URL' }; const getDataEndpointResponse = await kinesisVideoClient .getDataEndpoint(getDataEndpointOptions) .promise(); const hlsDataEndpoint = getDataEndpointResponse.DataEndpoint;
Questo codice memorizza l'endpoint nella variabile. hlsDataEndpoint
Configurare il client multimediale archiviato Kinesis Video Streams
Nella configurazione del client per il client multimediale archiviato Kinesis Video Streams, specifica l'endpoint ottenuto nel passaggio precedente.
const archivedMediaClientConfig = { accessKeyId: 'YourAccessKey', secretAccessKey: 'YourSecretKey', region: 'us-west-2', endpoint: hlsDataEndpoint } const kinesisVideoArchivedMediaClient = new AWS.KinesisVideoArchivedMedia(archivedMediaClientConfig);
Recupera l'URL della sessione di streaming HLS
Utilizza il client multimediale archiviato Kinesis Video Streams per GetHLSStreamingSessionURL richiamare l'API per recuperare l'URL di riproduzione HLS.
const getHLSStreamingSessionURLOptions = { StreamName: 'YourStreamName', PlaybackMode: 'LIVE' }; const getHLSStreamingSessionURLResponse = await kinesisVideoArchivedMediaClient.getHLSStreamingSessionURL(getHLSStreamingSessionURLOptions); const hlsUrl = getHLSStreamingSessionURLResponse.HLSStreamingSessionURL;
Visualizza lo stream HLS sulla pagina web
Una volta ottenuto l'URL della sessione di streaming HLS, forniscilo al lettore video. Il metodo per fornire l'URL al lettore video dipende dal lettore usato.
Risoluzione dei problemi relativi a HLS
Questa sezione descrive i problemi che potresti riscontrare durante l'utilizzo di HTTP Live Streaming (HLS) con Kinesis Video Streams.
Problemi
Il recupero dell'URL della sessione di streaming HLS riesce, ma si verifica un problema di riproduzione nel lettore video
Questa situazione si verifica quando è possibile recuperare correttamente l'URL di una sessione di streaming HLS usando GetHLSStreamingSessionURL, ma non è possibile riprodurre il video fornendo l'URL a un lettore video.
Per risolvere questo problema, prova le soluzioni seguenti:
-
Determina se il flusso video viene riprodotto nella console Kinesis Video Streams. Esamina gli errori visualizzati nella console.
-
Se la durata del frammento è meno di un secondo, aumentala a un secondo. Se la durata del frammento è troppo breve, il servizio potrebbe rallentare il lettore perché effettua richieste di frammenti video troppo frequentemente.
-
Verificare che ogni URL di una sessione di streaming HLS venga usato da un solo lettore. Se più di un lettore usa un singolo URL di una sessione di streaming HLS, il servizio potrebbe ricevere troppe richieste e limitarle.
-
Verifica che il lettore supporti tutte le opzioni specificate per la sessione di streaming HLS. Prova combinazioni diverse di valori per i parametri seguenti:
-
ContainerFormat -
PlaybackMode -
FragmentSelectorType -
DiscontinuityMode -
MaxMediaPlaylistFragmentResults
Alcuni lettori multimediali (ad esempio HTML5 e lettori mobile) in genere supportano solo HLS con il formato container fMP4. Altri lettori multimediali (come Flash e lettori personalizzati) potrebbero supportare HLS solo con il formato contenitore MPEG TS. Ti consigliamo di provare il
ContainerFormatparametro per iniziare la risoluzione dei problemi. -
-
Verificare che ogni frammento abbia un numero consistente di tracce. Verifica che i frammenti dello stream non contengano solo una traccia video e audio e non contengano solo una traccia video. Verifica inoltre che le impostazioni del codificatore (risoluzione e frequenza fotogrammi) non cambino tra i frammenti di ogni traccia.
Latenza troppo elevata tra il producer e il lettore
Questa situazione si verifica quando vi è una latenza troppo elevata dal momento dell'acquisizione del video alla sua riproduzione nel lettore.
Il video viene riprodotto tramite HLS frammento per frammento. Pertanto, la latenza non può essere inferiore alla durata dei frammenti. La latenza include anche il tempo necessario per il buffering e il trasferimento dei dati. Se la soluzione richiede una latenza inferiore a un secondo, usa l'API GetMedia.
È possibile modificare i parametri seguenti per ridurre la latenza complessiva, ma la modifica di questi parametri potrebbe comportare anche la riduzione della qualità video o l'aumento della frequenza di ripetizione del buffering.
-
Durata del frammento: la durata del frammento è la quantità di video tra le divisioni del flusso, controllata dalla frequenza dei fotogrammi chiave generati dal codificatore video. Il valore consigliato è di un secondo. Una durata inferiore dei frammenti significa meno tempo di attesa per il completamento del frammento prima della trasmissione dei dati video al servizio. I frammenti più brevi vengono anche elaborati più velocemente dal servizio. Tuttavia, se la durata di frammento è troppo breve, aumentano le probabilità che il lettore esaurisca i contenuti e debba arrestarsi ed eseguire il buffering di altri contenuti. Se la durata del frammento è meno di 500 millisecondi, il producer potrebbe creare troppe richieste, che potrebbero pertanto essere limitate dal servizio.
-
Bitrate: uno streaming video con un bitrate inferiore richiede meno tempo per la lettura, la scrittura e la trasmissione. Tuttavia, un flusso video con una velocità in bit inferiore ha in genere una qualità video inferiore.
-
Numero di frammenti nelle playlist multimediali: un lettore sensibile alla latenza dovrebbe caricare solo i frammenti più recenti di una playlist multimediale. La maggior parte dei giocatori inizia invece dal primo frammento. Riducendo il numero di frammenti nella playlist, riduci la distanza temporale tra il frammento precedente e quello nuovo. Con una playlist di dimensioni inferiori, è possibile che un frammento venga saltato durante la riproduzione se c'è un ritardo nell'aggiunta di nuovi frammenti alla playlist o se c'è un ritardo nell'ottenere una playlist aggiornata. Ti consigliamo di usare 3-5 frammenti e di utilizzare un player configurato per caricare solo i frammenti più recenti da una playlist.
-
Dimensione del buffer del lettore: la maggior parte dei lettori video ha una durata minima del buffer configurabile, di solito con un valore predefinito di 10 secondi. Per ottenere la latenza più bassa, è possibile impostare questo valore su 0 secondi. Tuttavia, così facendo, il lettore esegue il rebuffer se c'è un ritardo nella produzione di frammenti, perché non disporrà di un buffer per assorbire il ritardo.
-
Player «catch up»: i lettori video in genere non riprendono automaticamente la riproduzione fino alla parte anteriore del buffer video se il buffer si riempie, come quando un frammento ritardato causa la riproduzione di un backlog di frammenti. Un lettore personalizzato consente di evitare questa situazione, eliminando i fotogrammi o aumentando la velocità di riproduzione (ad esempio a 1,1x) per raggiungere la parte iniziale del buffer. Ciò causa una riproduzione irregolare o un aumento della velocità mentre il lettore recupera e la ripetizione del buffering potrebbe avvenire con maggiore frequenza se le dimensioni del buffer sono contenute.
