SDK di messaggistica per client di chat IVS
L'SDK di Amazon Interactive Video Services (IVS) Chat Client Messaging è rivolto agli sviluppatori che compilano applicazioni con Amazon IVS. Questo SDK è progettato per sfruttare l'architettura di Amazon IVS e consultarne gli aggiornamenti, così come Amazon IVS Chat. Essendo un SDK nativo, è progettato per ridurre al minimo l'impatto sulle prestazioni dell'applicazione e dei dispositivi utilizzati dagli utenti per accedere all'applicazione.
Requisiti della piattaforma
Browser desktop
| Browser | Versioni supportate |
|---|---|
| Chrome | Due versioni principali (versione corrente e precedente più recente) |
| Edge | Due versioni principali (versione corrente e precedente più recente) |
| Firefox | Due versioni principali (versione corrente e precedente più recente) |
| Opera | Due versioni principali (versione corrente e precedente più recente) |
| Safari | Due versioni principali (versione corrente e precedente più recente) |
Browser per dispositivi mobili
| Browser | Versioni supportate |
|---|---|
| Chrome per Android | Due versioni principali (versione corrente e precedente più recente) |
| Firefox per Android | Due versioni principali (versione corrente e precedente più recente) |
| Opera per Android | Due versioni principali (versione corrente e precedente più recente) |
| WebView Android | Due versioni principali (versione corrente e precedente più recente) |
| Samsung Internet | Due versioni principali (versione corrente e precedente più recente) |
| Safari per iOS | Due versioni principali (versione corrente e precedente più recente) |
Piattaforme native
| Piattaforma | Versioni supportate |
|---|---|
| Android | 5.0 e versioni successive |
| iOS |
13.0 e versioni successive |
Supporto
Se si verifica un errore o un altro problema con la chat room, determinare l'identificatore univoco della stanza tramite l'API IVS Chat (consultare ListRooms).
Condividi questo identificatore della chat room con il Supporto AWS. Grazie a questo identificatore, si possono ottenere informazioni utili per risolvere il problema.
Nota: consulta le Note di rilascio di Chat Amazon IVS per conoscere le versioni disponibili e i problemi risolti. Se necessario, prima di contattare il supporto, aggiornare la versione dell'SDK e verificare se il problema è stato risolto.
Controllo delle versioni
Gli SDK di messaggistica client di Amazon IVS Chat 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.
Inoltre, la versione 1.x sarà supportata fino alla fine del 2023 o fino al rilascio della versione 3.x, a seconda di quale evento si verificherà per primo.
Amazon IVS Chat API (API di Amazon IVS Chat)
Sul lato server (non gestito dagli SDK), esistono due API, ognuna con le proprie competenze:
-
Piano dati: l'API IVS Chat Messaging è un'API WebSocket progettata per essere utilizzata da applicazioni front-end (iOS, Android, macOS, ecc.) guidate da uno schema di autenticazione basato su token. Utilizzando un token di chat generato in precedenza, è possibile connettersi a chat room già esistenti utilizzando tale API.
Gli SDK di Amazon IVS Chat Client Messaging riguardano solo il piano dati. Gli SDK presuppongono che si stia già generando token di chat tramite il proprio back-end. Si presume che il recupero di questi token sia gestito dall'applicazione front-end, non dagli SDK.
-
Piano di controllo (control-plane): l'API del piano di controllo (control-plane) della IVS Chat fornisce un'interfaccia delle proprie applicazioni di back-end per gestire e creare chat room e gli utenti che vi partecipano. Considerarlo il pannello di amministrazione dell'esperienza di chat dell'app, gestito dal back-end. Esistono endpoint del piano di controllo (control-plane) responsabili della creazione del token di chat che il piano dati necessita per autenticarsi in una chat room.
Importante: gli SDK di IVS Chat Client Messaging non chiamano nessun endpoint del piano di controllo (control-plane). È necessario configurare il back-end per creare i propri token di chat. L'applicazione front-end deve comunicare con il back-end per recuperare tale token di chat.
