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
HTTPLive Streaming (HLS)
È possibile utilizzarlo HLS per la riproduzione dal vivo. 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 utilizzare un lettore di terze parti (come Video.js
Per visualizzare uno streaming video Kinesis utilizzandoHLS, crea prima una sessione di streaming utilizzando G etHLSStreaming Session. URL Questa azione restituisce un URL (contenente un token di sessione) per accedere alla HLS sessione. È quindi possibile utilizzarlo URL in un lettore multimediale o in un'applicazione autonoma per visualizzare lo streaming.
Importante
Non tutti i file multimediali inviati a Kinesis Video Streams possono essere riprodotti. HLS Vedi GetHLSStreamingSessionURL per i requisiti di caricamento specifici.
Argomenti
Usa il AWS CLI per recuperare una HLS sessione di streaming URL
Segui la procedura riportata di seguito per utilizzare AWS CLI per generare una sessione di HLS streaming URL per uno streaming 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'HLSURLendpoint per lo 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 URL richiesta di sessione di HLS streaming 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 dove un'entità non autorizzata potrebbe 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 usare questo URL e qualsiasi altro HLS lettore per visualizzare lo HLS streaming.
Ad esempio, usa il lettore VLC multimediale.
Puoi anche riprodurre lo HLS Stream accedendo alla sessione di HLS streaming URL nella barra degli indirizzi dei browser Apple Safari o Microsoft Edge.
Esempio: da utilizzare HLS in HTML e JavaScript
L'esempio seguente mostra come utilizzare AWS SDK for JavaScript v2 per recuperare una sessione di streaming per uno HLS streaming 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 il AWS SDK modulo JavaScript per i browser
Nella pagina web, includi il seguente tag di script per importare AWS SDK for 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 AWS SDKla JavaScript documentazione.
Configurazione del client Kinesis Video Streams
Per accedere ai video in streaming conHLS, prima crea e configura 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 della HTML pagina.
Recupera l'endpoint per la riproduzione HLS
Usa il client Kinesis Video Streams per GetDataEndpoint API richiamare il dispositivo 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 la sessione di streaming HLS URL
Usa il client multimediale archiviato Kinesis Video Streams per GetHLSStreamingSessionURL API richiamare il file per recuperare la riproduzione. HLS URL
const getHLSStreamingSessionURLOptions = { StreamName: 'YourStreamName', PlaybackMode: 'LIVE' }; const getHLSStreamingSessionURLResponse = await kinesisVideoArchivedMediaClient .getHLSStreamingSessionURL(getHLSStreamingSessionURLOptions) .promise(); const hlsUrl = getHLSStreamingSessionURLResponse.HLSStreamingSessionURL;
Visualizza lo stream sulla pagina web HLS
Quando hai la sessione di HLS streamingURL, forniscila al lettore video. Il metodo per fornire il URL file al lettore video è specifico del lettore utilizzato.
Risoluzione dei HLS problemi
Questa sezione descrive i problemi che potresti riscontrare durante l'utilizzo di HTTP Live Streaming (HLS) con Kinesis Video Streams.
Problemi
Il recupero della sessione di HLS streaming riesce, ma la riproduzione non URL riesce nel lettore video
Questa situazione si verifica quando è possibile recuperare correttamente una sessione di HLS streaming URL utilizzandoGetHLSStreamingSessionURL, ma il video non viene riprodotto quando URL viene fornito 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.
-
Verifica che ogni sessione di HLS streaming URL sia utilizzata da un solo giocatore. Se più di un giocatore utilizza una singola sessione di HLS streamingURL, il servizio potrebbe ricevere troppe richieste e limitarle.
-
Verifica che il lettore supporti tutte le opzioni specificate per la HLS sessione di streaming. Prova combinazioni diverse di valori per i parametri seguenti:
-
ContainerFormat -
PlaybackMode -
FragmentSelectorType -
DiscontinuityMode -
MaxMediaPlaylistFragmentResults
Alcuni lettori multimediali (come HTML5 i lettori mobili) in genere supportano solo HLS il formato MP4 contenitore f. Altri lettori multimediali (come Flash e lettori personalizzati) potrebbero supportare HLS solo 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 per HLS 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 tua soluzione richiede una latenza inferiore a un secondo, valuta la possibilità di utilizzare invece la. GetMedia API
È 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.
