Utilizzo dell'SDK Amazon Chime - SDK Amazon Chime

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

Utilizzo dell'SDK Amazon Chime

Utilizzi l'SDK Amazon Chime per creare applicazioni multimediali in tempo reale in grado di inviare e ricevere audio e video e consentire la condivisione di contenuti. L'SDK Amazon Chime funziona indipendentemente dagli account di amministratore di Amazon Chime e non influisce sulle riunioni ospitate su Amazon Chime. Invece, l'SDK Amazon Chime fornisce strumenti di creazione che puoi utilizzare per creare le tue applicazioni per riunioni.

Prerequisiti dell'SDK Amazon Chime

L'utilizzo dell'SDK Amazon Chime richiede quanto segue:

  • La capacità di programmare.

  • Un AWS account.

  • Un ruolo IAM con una policy che concede l'autorizzazione ad accedere alle azioni dell'API Amazon Chime utilizzate dall'SDK Amazon Chime, come la policy SDK gestita. AWS AmazonChime Per ulteriori informazioni, consulta Come Amazon Chime funziona con IAM e Consenti agli utenti di accedere alle azioni dell'SDK Amazon Chime nella Amazon Chime SDK Administrator Guide.

  • Per la maggior parte dei casi d'uso, è inoltre necessario quanto segue:

    • Un'applicazione server: gestisce le risorse per riunioni e partecipanti e fornisce tali risorse all'applicazione client. L'applicazione server viene creata nell' AWS account e deve avere accesso al ruolo IAM menzionato in precedenza.

    • Un'applicazione client: riceve informazioni sulla riunione e sui partecipanti dall'applicazione server e utilizza tali informazioni per stabilire connessioni multimediali.

Concetti dell'SDK Amazon Chime

La terminologia e i concetti seguenti sono fondamentali per comprendere come utilizzare l'SDK Amazon Chime.

riunione

Una risorsa effimera identificata da un unico. MeetingId MeetingIdViene inserito in un gruppo di servizi multimediali che ospitano la riunione attiva.

gruppo di servizi multimediali

Il gruppo di servizi multimediali che ospita una riunione attiva.

posizionamento dei media

Un insieme di URL regionalizzati che rappresenta un gruppo di servizi multimediali. I partecipanti si connettono al gruppo di servizi multimediali con i propri clienti per inviare e ricevere audio e video in tempo reale e condividere i propri schermi.

partecipante

Un partecipante alla riunione identificato da un nome univoco. AttendeeId I partecipanti possono partecipare e uscire liberamente dalle riunioni utilizzando un'applicazione client creata con una libreria client Amazon Chime SDK.

token di iscrizione

Un token univoco assegnato a ciascun partecipante. I partecipanti utilizzano il token di iscrizione per autenticarsi con il gruppo di servizi multimediali.

Architettura SDK Amazon Chime

L'elenco seguente descrive come i diversi componenti dell'architettura Amazon Chime SDK interagiscono per supportare riunioni e partecipanti, audio, video e condivisione di contenuti.

Riunioni e partecipanti

Quando l'applicazione server crea una riunione Amazon Chime SDK, la riunione viene assegnata a un servizio multimediale specifico della regione. Gli organizzatori del servizio sono responsabili del trasferimento sicuro di contenuti multimediali in tempo reale tra i clienti partecipanti. A ogni partecipante creato viene assegnato un token di iscrizione univoco, una chiave segreta opaca che l'applicazione server deve trasferire in modo sicuro al client autorizzato a partecipare alla riunione per conto di un partecipante. Ogni client utilizza un token di iscrizione per autenticarsi con il gruppo di servizi multimediali. I client utilizzano una combinazione di protezione WebSockets e Datagram Transport Layer Security (DTLS) per segnalare in modo sicuro il gruppo di servizi multimediali e per inviare e ricevere contenuti multimediali da e verso altri partecipanti tramite il gruppo di servizi multimediali.

Audio

Il servizio multimediale mescola l'audio di ogni partecipante e lo invia a ciascun destinatario, dopo aver sottratto il proprio audio dal mix. Gli SDK Amazon Chime campionano l'audio alla massima frequenza supportata dal dispositivo e dal browser, fino a un massimo di 48 kHz. Utilizziamo il codec Opus per codificare l'audio, con un bitrate predefinito di 32 kbps, che può essere aumentato fino a 128 kbps stereo e 64 kbps mono.

Video

Il servizio multimediale funge da unità di inoltro selettivo (SFU) utilizzando un modello di pubblicazione e sottoscrizione. Ogni partecipante può pubblicare una sorgente video, fino a un totale di 25 video simultanei per riunione. La libreria client Amazon Chime SDK JavaScript supporta risoluzioni video fino a 1280x720 a 30 fotogrammi al secondo senza simulcast e 15 fotogrammi al secondo con simulcast. Le librerie client Amazon Chime SDK per iOS, Android e Windows supportano risoluzioni video fino a 1280x720 e 30 fotogrammi al secondo, tuttavia il framerate e la risoluzione effettivi vengono gestiti automaticamente dall'SDK Amazon Chime.

Quando è attivo, il video simulcast invia ogni flusso video con due risoluzioni e bitrate diversi. I client con vincoli di larghezza di banda si iscrivono automaticamente allo stream con bitrate inferiore. La codifica e la decodifica video utilizzano l'accelerazione hardware, ove disponibile, per migliorare le prestazioni.

Messaggi di dati

Oltre ai contenuti audio e video, i partecipanti alla riunione possono scambiarsi messaggi di dati in tempo reale fino a 2 KB ciascuno. Puoi utilizzare i messaggi per implementare funzionalità di riunione personalizzate come lavagna, chat, reazioni emoji in tempo reale e segnalazioni di controllo del pavimento specifiche dell'applicazione.

Condivisione dei contenuti

L'applicazione client può condividere contenuti audio e video, come schermate o file multimediali. La condivisione dei contenuti supporta contenuti video preregistrati fino a 1280x720 a 15 fotogrammi al secondo e audio fino a 48 kHz a 64 kbps. L'acquisizione di schermate per la condivisione di contenuti è supportata fino a 15 fotogrammi al secondo, ma può essere limitata dalle funzionalità del dispositivo e del browser.

Quote dei servizi SDK Amazon Chime

Nota

Le quote di servizio si intendono per endpoint API. Quando richiedi un aumento della quota di servizio, assicurati di richiedere l'aumento su tutti gli endpoint API utilizzati dall'applicazione.

Questa tabella che elenca le risorse e le quote disponibili per le riunioni dell'SDK Amazon Chime.

Risorsa Quota Regolabile

Riunioni attive

250

Partecipanti per riunione

250

No

Flussi audio per riunione

250

No

Stream video pubblicati per riunione

25

Sì, fino a 250

Stream video abbonati per partecipante

25

No

Condivisioni di contenuti per riunione

2

No

Riproduci le riunioni per riunione principale 4 Sì, fino a 40

Pipeline di acquisizione multimediale attive per riunione

1

No

Pipeline di acquisizione multimediale attive per account

100 per gli endpoint us-east-1 e 10 per gli altri endpoint

Tasso API

10 richieste al secondo (RPS) con una raffica di 20 RPS.

Sì, ma indirettamente

Nota

I limiti di velocità delle API aumentano quando si aumenta la quota di Active Meetings.

Requisiti di sistema SDK Amazon Chime

I seguenti requisiti di sistema si applicano alle applicazioni create con l'SDK Amazon Chime.

Browser supportati, libreria client Amazon Chime SDK per JavaScript

Sistema operativo Browser Versioni supportate Note

Windows

Mozilla Firefox

75 e versioni successive

Google Chrome

78 e versioni successive

Edge basato su Chromium

79 e versioni successive
Electron a base di cromo 7 e versioni successive Con Chrome versione 78 e successive.
Opera 66 e versioni successive

macOS

Mozilla Firefox

75 e versioni successive

Google Chrome

78 e versioni successive

Edge basato su Chromium

79 e versioni successive

Electron a base di cromo

Safari 13 e versioni successive
Opera 66 e versioni successive
iOS Mozilla Firefox 10 e versioni successive Solo audio e video, nessuna condivisione di contenuti.
Google Chrome 78 e versioni successive Solo audio e video, nessuna condivisione di contenuti.
Safari 13 e versioni successive Solo audio e video, nessuna condivisione di contenuti.
WK WebView 14.3 e versioni successive Solo audio e video, nessuna condivisione di contenuti.
Android Google Chrome 10 e versioni successive Solo audio e video, nessuna condivisione di contenuti.
Samsung 12 e versioni successive Solo audio e video, nessuna condivisione di contenuti.
Cromo WebView 5 e versioni successive Solo audio e video, nessuna condivisione di contenuti.
Ubuntu LTS 16.04 e versioni successive Google Chrome 78 e versioni successive
Libreria client Amazon Chime SDK per iOS
  • iOS versione 13 e successive

Libreria client Amazon Chime SDK per Android
  • Sistema operativo Android versione 5 e successive, architettura ARM e ARM64