SDK Amazon IVS Player

Per poter utilizzare Amazon Interactive Video Service (IVS), devi utilizzare il lettore Amazon IVS. Il lettore è una suite multipiattaforma di SDK per la riproduzione di flussi Amazon IVS. È progettato per sfruttare l'architettura di Amazon IVS ed è ottimizzato per la riproduzione di Amazon IVS.

L'unico lettore di cui possiamo garantire le prestazioni è il lettore Amazon IVS. Per avere una bassa latenza, è necessario il lettore Amazon IVS.

Le caratteristiche principali del lettore Amazon IVS sono:

• U ltra-low-latency streaming: la bassa latenza è un componente fondamentale per creare buone esperienze utente interattive che arricchiscano l'esperienza del pubblico. La latenza si insinua in modo incrementale lungo tutto il percorso di trasmissione tra emittente e spettatore, influenzando la velocità di risposta.

  La nd-to-end latenza E è il ritardo tra il momento in cui un live streaming viene ripreso dalla videocamera a quando viene visualizzato sullo schermo di uno spettatore. Amazon IVS è progettato per offrire una end-to-end latenza estremamente bassa (inferiore a cinque secondi, a seconda della posizione di trasmissione e delle impostazioni dell'emittente). Per ottenere questa bassa latenza, è necessario utilizzare il lettore Amazon IVS.

• Coerenza multipiattaforma: gli spettatori guardano le trasmissioni su una varietà di piattaforme. Dai dispositivi mobili ai browser Web, il lettore Amazon IVS offre a tutti gli spettatori un'esperienza simile. Questa coerenza è possibile perché ogni piattaforma utilizza la stessa libreria di funzioni del lettore. La libreria del lettore è un componente integrante dell'architettura di Amazon IVS. L'utilizzo di uno stack video garantisce che tutti i comportamenti di riproduzione video, tra cui la modalità a bassa latenza, i metadati temporizzati, l'analisi, il monitoraggio degli errori, la segnalazione e la registrazione, siano disponibili in modo coerente su tutte le piattaforme supportate.

• Streaming in bitrate adattivo (ABR). il lettore Amazon IVS utilizza algoritmi ABR ottimizzati per ambienti a bassa latenza. Il lettore misura la qualità del servizio e la disponibilità della larghezza di banda in tempo reale e adatta la qualità video e i livelli di buffer in modo da fornire una riproduzione senza interruzioni. Quando la qualità della connessione è scarsa, ABR passa a un bitrate inferiore; quando invece migliora, passa a un bitrate più elevato.

• Metadati temporizzati: il lettore Amazon IVS supporta metadata temporizzati che possono essere utilizzati per creare elementi interattivi come sondaggi e quiz. I metadati sono un insieme di dati che descrive e fornisce informazioni su altri dati. Con i metadati "temporizzati", un codice temporale accompagna la parte dei dati relativi allo stream. Durante la riproduzione, il codice temporale funge da punto di partenza per attivare l'azione in base ai dati, ad esempio:

  • Invio delle statistiche dei giocatori per un flusso sportivo

  • Invio dei dettagli del prodotto per uno streaming di shopping live

  • Invio di domande per uno streaming di quiz dal vivo

• Solida gestione degli errori: la gestione degli errori temporanei consente di evitare interruzioni nell'esperienza di visualizzazione. La solida gestione degli errori del lettore Amazon IVS consente di rilevare numerosi potenziali errori di streaming, passando automaticamente a un rendering alternativo. Gli spettatori continuano a guardare la trasmissione senza interruzioni e senza dover intraprendere alcuna azione correttiva.

• Semplicità di integrazione: l'API del lettore Amazon IVS colma il divario tra le applicazioni dei clienti Amazon IVS e la libreria del lettore. L'API dispone di collegamenti per tutte le piattaforme supportate, semplificando l'integrazione del lettore nelle applicazioni tramite ambienti e tecniche di codifica familiari. Con il pieno controllo sugli elementi dell'interfaccia utente, i clienti possono personalizzare gli aspetti di branding e di presentazione delle loro applicazioni.

Il lettore Amazon IVS non supporta il casting con Airplay. Il casting con Chromecast può essere implementato all'esterno del lettore utilizzando le app ricevitore Chromecast di default. Tuttavia, la latenza in queste app è superiore a quella dell'SDK Amazon IVS Player, quindi lo switch non sarà senza soluzione di continuità. Consulta anche la nostra documentazione sull'SDK di trasmissione Amazon IVS perStreaming a bassa latenza e Streaming in tempo reale.

Requisiti di piattaforma e browser

Per informazioni dettagliate sulle ultime versioni rilasciate di vari browser, consulta:

• Stato della piattaforma Chrome

• Versioni di Firefox

• Pianificazione dei rilasci di Microsoft Edge

• Note di rilascio di Safari

Sebbene Amazon IVS possa funzionare con alcuni browser meno recenti, non risolviamo i bug relativi ai browser più vecchi.

L'SDK Web del lettore IVS (incluse le integrazioni Video.js e Player JW) non è supportato in ambienti di tipo browser. Ciò include dispositivi nativi WebViews e «dispositivi da 10 piedi» (TV, console, set-top box) che supportano le applicazioni Web. Contatta il Supporto IVS se non sei sicuro del supporto specifico del browser al di fuori delle tabelle elencate di seguito.

Browser desktop

Browser desktop	Piattaforme supportate	Versioni supportate
Chrome	Windows, macOS	Due versioni principali (versione corrente e precedente più recente)
Firefox	Windows, macOS	Due versioni principali (versione corrente e precedente più recente)
Edge	Windows 8.1 e versioni successive	44.0 e versioni successive (In modalità qualità automatica su Microsoft Edge Legacy, è supportata solo la riproduzione a latenza normale, non la riproduzione a latenza ultrabassa. La modalità di qualità automatica dipende dall'abilitazione di ABR. Ad esempio, nel lettore Web, consulta setAutoQualityMode.
Safari	macOS	Due versioni principali (versione corrente e precedente più recente) (In modalità qualità automatica su Safari per macOS 14 e versioni successive, il lettore IVS 1.3.0 e versioni successive supporta la riproduzione a latenza ultrabassa. Per le versioni precedenti di Safari e del lettore IVS, è supportata solo la riproduzione a latenza normale. Vedi sopra per "modalità qualità automatica").

Browser per dispositivi mobili

Browser per dispositivi mobili	Versioni supportate
Chrome per iOS, Safari per iOS	Due versioni principali (versione corrente e precedente più recente) (La riproduzione a latenza ultrabassa non è supportata. È supportata la riproduzione a latenza normale. Questo vincolo si applica a tutti i browser per iOS.) (I metadati temporizzati sono supportati solo nel lettore 1.3.0 e versioni successive.)
Chrome per iPadOS, Safari per iPadOS	Due versioni principali (versione corrente e precedente più recente) (Quando è selezionato "Richiedi sito web mobile": la riproduzione a latenza ultrabassa non è supportata. I metadati temporizzati sono supportati solo nel lettore 1.3.0 e versioni successive.)
Chrome per Android	Due versioni principali (versione corrente e precedente più recente)

Piattaforme native

Piattaforma	Versioni supportate	Dispositivi supportati
Android	5.0 (Lollipop) e versioni successive	Telefoni e tablet
iOS	12.0 e versioni successive	Tutti

IVS supporta un minimo di 4 versioni principali di iOS e 6 versioni principali di Android. Il nostro supporto per le versioni correnti potrebbe estendersi oltre questi minimi. I clienti verranno avvisati tramite note di rilascio dell'SDK con almeno 3 mesi di anticipo se una versione principale non è più supportata.

Riduzione della latenza nei giocatori di terze parti

Per i tipi di canale Basic e Standard: per ottenere la latenza più bassa possibile, è necessario utilizzare Amazon IVS Player. Nei giocatori di terze parti (incluso iOS Safari), puoi ridurre la latenza a circa 10 secondi utilizzando la seguente configurazione:

• Imposta l'intervallo dei fotogrammi chiave del tuo codificatore (ad esempio OBS) su 2 secondi o meno.

• Aggiungi ?keyframeInterval=2 all'URL (RTMPS). Ad esempio: rtmps://a1b2c3d4e5f6.global-contribute.live-video.net:443/app/sk_us-west-2_abcd1234efgh5678ijkl?keyframeInterval=2

Nota: l'intervallo di fotogrammi chiave specificato come parte dell'URL RTMP deve essere maggiore o uguale al valore configurato nel codificatore; in caso contrario, potrebbero verificarsi problemi di riproduzione. È possibile impostare il valore su qualsiasi numero intero compreso tra 2 e 6 inclusi, ma 2 fornisce la latenza più bassa.

Per i tipi di canali avanzati: le indicazioni sopra riportate non si applicano. I tipi di canale avanzati generano automaticamente intervalli di fotogrammi chiave per l'efficienza della codifica, con un intervallo di massimo 2 secondi tra i fotogrammi chiave, indipendentemente dall'impostazione dell'intervallo dei fotogrammi chiave della codifica di origine.

iOS Safari

In iOS Safari, puoi ridurre la latenza a circa 6-8 secondi utilizzando il lettore IVS e configurandolo per utilizzare un worker di servizi. Consulta Configurazione di un worker di servizi in SDK del lettore: Guida per il Web per i dettagli sull'implementazione e un esempio di riferimento.

Nota: per ottenere la latenza più bassa è necessario un flusso IVS con l'intervallo dei fotogrammi chiave impostato su 2 secondi.

Riproduzione solo audio

Tutti i tipi di canali IVS supportano le rappresentazioni solo audio. Ciò può essere particolarmente utile per le applicazioni mobili. Ad esempio, nell'app per dispositivi mobili, è possibile impostare il lettore in modalità solo audio quando l'utente esegue lo sfondo dell'applicazione per risparmiare larghezza di banda.

Per i canali ADVANCED-SD e ADVANCED-HD, la riproduzione di solo audio viene inclusa automaticamente nella playlist multivariante. Per i canali BASIC e STANDARD, è necessario aggiungere il parametro di ?allow_audio_only=true query all'URL di riproduzione per consentire l'inclusione della rappresentazione di solo audio.

Nota: l'SDK del lettore web IVS supporta la riproduzione di solo audio solo nelle versioni 1.24.0 e successive.

Supporto

Se si verifica un errore di riproduzione o un altro problema di riproduzione con il flusso, determinare l'identificatore univoco della sessione di riproduzione tramite l'API del lettore.

Per questo lettore Amazon IVS:	Usa questo:
Android	Funzione sessionId
iOS	Proprietà sessionId di IVSPlayer
App	Funzione getSessionId

Condividi questo identificatore di sessione di riproduzione con AWS Support. Grazie a questo identificatore, si possono ottenere informazioni utili per risolvere il problema.

Nota: il lettore viene continuamente migliorato. Consulta le Note di rilascio di Amazon IVSper le versioni disponibili e i problemi risolti. Se necessario, prima di contattare il supporto, aggiorna la versione del lettore e verifica se il problema è stato risolto.

Controllo delle versioni

Gli SDK Amazon IVS Player utilizzano il controllo semantico delle versioni.

Per questa discussione, supponiamo che:

• La versione più recente sia la 4.1.3.

• L'ultima versione della versione principale precedente sia 3.2.4.

• La versione più recente della versione 1.x sia la 1.5.6.

Le nuove funzionalità compatibili con le versioni precedenti vengono aggiunte come versioni secondarie dell'ultima versione. In questo caso, il set successivo di nuove funzionalità verrà aggiunto come versione 4.2.0.

Le correzioni di bug minori compatibili con le versioni precedenti vengono aggiunte come versioni di patch dell'ultima versione. Nel nostro caso, il set di correzioni minori di bug successivo sarà aggiunto come versione 4.1.4.

Le correzioni di bug principali compatibili con le versioni precedenti sono gestite in modo diverso, ovvero vengono aggiunte alle diverse versioni:

• Rilascio della patch dell'ultima versione. Nel nostro caso, questa è la versione 4.1.4.

• Rilascio della patch della versione secondaria precedente. Nel nostro caso, questa è la versione 3.2.5.

• Rilascio di patch dell'ultima versione 1.x. Nel nostro caso, questa è la versione 1.5.7.

Le correzioni di bug principali sono definite dal team di prodotti Amazon IVS. Esempi tipici sono gli aggiornamenti critici della sicurezza e alcune altre correzioni necessarie per i clienti.

Nota: negli esempi precedenti, le versioni rilasciate vengono incrementate senza saltare alcun numero (ad esempio, da 4.1.3 a 4.1.4). In realtà, uno o più numeri di patch possono rimanere interni e non essere rilasciati, quindi la versione rilasciata potrebbe aumentare da 4.1.3 a, ad esempio, 4.1.6.