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.
**Topics**
+ [Prerequisiti per utilizzare l'SDK Amazon Chime](#mtg-prereqs)
+ [Concetti per l'SDK Amazon Chime](#mtg-glossary)
+ [Architettura per l'SDK Amazon Chime](#mtg-arch)
+ [Quote per l'SDK Amazon Chime](#mtg-limits)
+ [Requisiti di sistema SDK Amazon Chime](#mtg-browsers)
+ [Regioni AWS disponibili per l'SDK Amazon Chime](sdk-available-regions.md)
+ [Scopri le librerie client Amazon Chime SDK](mtgs-sdk-client-lib.md)
+ [Comprendere l'integrazione SIP utilizzando un Amazon Chime SDK Voice Connector](mtgs-sdk-cvc.md)
+ [Informazioni sulle notifiche degli eventi di Amazon Chime SDK](mtgs-sdk-notifications.md)
+ [Migrazione dallo spazio dei nomi Amazon Chime](migrate-from-chm-namespace.md)
## Prerequisiti per utilizzare l'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](https://docs.aws.amazon.com/chime-sdk/latest/ag/security_iam_service-with-iam.html) e [Consenti agli utenti di accedere alle azioni dell'SDK Amazon Chime nella Amazon Chime SDK Administrator](https://docs.aws.amazon.com/chime-sdk/latest/ag/security_iam_id-based-policy-examples.html#security_iam_id-based-policy-examples-chime-sdk) *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 per l'SDK Amazon Chime
La terminologia e i concetti seguenti sono fondamentali per comprendere come utilizzare l'SDK Amazon Chime.
**meeting**
Una risorsa effimera identificata da un unico. `MeetingId` `MeetingId`Viene 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 per l'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](sdk-for-ios.md), [Android](sdk-for-android.md) e [Windows](client-lib-windows.md) 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 per l'SDK Amazon Chime
Le quote per il servizio Amazon Chime SDK sono documentate nel. Riferimenti generali di AWS Per ulteriori informazioni, consulta gli [endpoint e le quote dell'SDK Amazon Chime](https://docs.aws.amazon.com/general/latest/gr/chime-sdk.html) nel. *Riferimenti generali di AWS*
**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.
## 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**
- **Windows**
- **Browser:** Mozilla Firefox / **Versioni supportate:** 75 e versioni successive / **Note:**
- **Browser:** Google Chrome / **Versioni supportate:** 78 e versioni successive / **Note:**
- **Browser:** Chromium-based Bordo / **Versioni supportate:** 79 e versioni successive / **Note:**
- **Browser:** Chromium-based Elettrone / **Versioni supportate:** 7 e versioni successive / **Note:** Con Chrome versione 78 e successive.
- **Browser:** Opera / **Versioni supportate:** 66 e versioni successive / **Note:**
- ** macOS **
- **Browser:** Mozilla Firefox / **Versioni supportate:** 75 e versioni successive / **Note:**
- **Browser:** Google Chrome / **Versioni supportate:** 78 e versioni successive / **Note:**
- **Browser:** Chromium-based Bordo / **Versioni supportate:** 79 e versioni successive / **Note:**
- **Browser:** Chromium-based Elettrone / **Versioni supportate:** / **Note:**
- **Browser:** Safari / **Versioni supportate:** 13 e versioni successive / **Note:**
- **Browser:** Opera / **Versioni supportate:** 66 e versioni successive / **Note:**
- **iOS**
- **Browser:** Mozilla Firefox / **Versioni supportate:** 10 e versioni successive / **Note:** Solo audio e video, nessuna condivisione di contenuti.
- **Browser:** Google Chrome / **Versioni supportate:** 78 e versioni successive / **Note:** Solo audio e video, nessuna condivisione di contenuti.
- **Browser:** Safari / **Versioni supportate:** 13 e versioni successive / **Note:** Solo audio e video, nessuna condivisione di contenuti.
- **Browser:** WKWebView / **Versioni supportate:** 14.3 e versioni successive / **Note:** Solo audio e video, nessuna condivisione di contenuti.
- **Android**
- **Browser:** Google Chrome / **Versioni supportate:** 10 e versioni successive / **Note:** Solo audio e video, nessuna condivisione di contenuti.
- **Browser:** Samsung / **Versioni supportate:** 12 e versioni successive / **Note:** Solo audio e video, nessuna condivisione di contenuti.
- **Browser:** Cromo WebView / **Versioni supportate:** 5 e versioni successive / **Note:** Solo audio e video, nessuna condivisione di contenuti.
- **Ubuntu LTS 16.04 e versioni successive**
- **Browser:** Google Chrome
- **Versioni supportate:** 78 e versioni successive
- **Note:**
**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