SDK di trasmissione IVS (streaming a bassa latenza) - Amazon Interactive Video Service

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à.

SDK di trasmissione IVS (streaming a bassa latenza)

L'SDK di trasmissione a bassa latenza di IVS) è rivolto agli sviluppatori che creano applicazioni con Amazon IVS. Questo SDK è progettato per trarre vantaggio dall'architettura di Amazon IVS e, così come Amazon IVS, vedrà l'introduzione di miglioramenti continui e nuove funzionalità. Essendo un SDK di trasmissione nativo, è progettato per ridurre al minimo l'impatto sulle prestazioni dell'applicazione e dei dispositivi utilizzati dagli utenti per accedere all'applicazione.

L'applicazione può avvalersi delle funzionalità principali dell'SDK di trasmissione Amazon IVS:

  • Streaming di alta qualità - L'SDK di trasmissione supporta lo streaming di alta qualità. Catturare video dalla fotocamera e utilizzare la codifica fino a 1080p per un'esperienza visiva di alta qualità.

  • Regolazioni automatiche del bitrate - Gli utenti di smartphone sono mobili, quindi le loro condizioni di rete possono cambiare nel corso della trasmissione. L'SDK di trasmissione di Amazon IVS regola automaticamente il bitrate video per adattarsi alle mutevoli condizioni di rete.

  • Supporto per l'orientamento verticale e orizzontale - Indipendentemente dal modo in cui gli utenti tengono in mano i dispositivi, l'immagine viene visualizzata e ridimensionata correttamente. L'SDK di trasmissione supporta ogni dimensione del riquadro, sia in verticale che in orizzontale. Gestisce automaticamente le sue proporzioni quando gli utenti ruotano il dispositivo e cambiano l'orientamento configurato.

  • Streaming sicuro - Le trasmissioni dell'utente sono crittografate tramite TLS, in modo che possano mantenere protetti i propri flussi.

  • Dispositivi audio esterni - L'SDK di trasmissione Amazon IVS supporta collegamenti audio con cavo, USB e microfoni esterni Bluetooth SCO.

Requisiti della piattaforma

Piattaforme native

Piattaforma Versioni supportate
Android

5.0 (Lollipop) e versioni successive

iOS

12 e versioni successive

Se per la propria applicazione la trasmissione è essenziale, specificare Metal come requisito per scaricare l'app dall'App Store di Apple utilizzando UIRequiredDeviceCapabilities.

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.

Browser desktop

Browser 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

Due versioni principali (versione corrente e precedente più recente)

Esclude Edge Legacy

Safari macOS

Due versioni principali (versione corrente e precedente più recente)

Browser per dispositivi mobili

Browser Versioni supportate
Chrome per iOS, Safari per iOS

Due versioni principali (versione corrente e precedente più recente)

Chrome per iPadOS, Safari per iPadOS

Due versioni principali (versione corrente e precedente più recente)

Chrome per Android

Due versioni principali (versione corrente e precedente più recente)

Viste Web

L'SDK di trasmissione Web non fornisce supporto per visualizzazioni Web o ambienti simili al Web (TV, console e così via). Per le implementazioni mobili, consulta la Guida all'SDK di trasmissione in streaming a bassa latenza per Android e iOS.

Richiesta di accesso al dispositivo

L'SDK di trasmissione richiede l'accesso alle fotocamere e ai microfoni del dispositivo, sia quelli integrati nel dispositivo che quelli collegati tramite Bluetooth, USB o ingresso audio.

Supporto

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

Per questo SDK di trasmissione di Amazon IVS: Usare questo:
Android

Funzione getSessionId su BroadcastSession

iOS

Proprietà sessionId di IVSBroadcastSession

App

Funzione getSessionId

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

Nota: l'SDK di trasmissione viene continuamente migliorato. Consultare le Note di rilascio di Amazon IVSper le versioni disponibili e i problemi risolti. Se necessario, prima di contattare il supporto, aggiornare la versione dell'SDK di trasmissione e verificare se il problema è stato risolto.

Controllo delle versioni

Gli SDK di trasmissione di Amazon IVS 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.