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 opzioni regionalizzate URLs 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. Amazon Chime SDKs campiona 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** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/chime-sdk/latest/dg/meetings-sdk.html) **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, ARM e architettura ARM64 # Regioni AWS disponibili per l'SDK Amazon Chime Le tabelle seguenti elencano le funzionalità del servizio Amazon Chime SDK e le AWS regioni che forniscono ciascun servizio. **Nota** Le regioni contrassegnate con un asterisco (**\$1**) devono essere abilitate nel tuo account. AWS AWS blocca quelle regioni per impostazione predefinita. Per ulteriori informazioni sull'attivazione delle regioni, consulta [Specificare AWS le regioni che il tuo account può utilizzare](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-regions.html), nella Guida di *riferimento alla gestione degli AWS account*. **Topics** + [Regioni della console](#sdk-console-regions) + [Chiama le regioni di analisi](#call-analytics-regions) + [Regioni di riunione](#sdk-meeting-regions) + [Regioni della pipeline multimediale](#sdk-media-pipelines) + [Regioni di messaggistica](#sdk-messaging-regions) + [Regioni vocali](#voice-regions) ## Regioni della console Utilizza la console Amazon Chime SDK per configurare le risorse e ottenere ulteriori informazioni sul servizio Amazon Chime SDK. | **AWS Region** | **Console** | | --- | --- | | Asia Pacifico (Seoul) | Sì | | Asia Pacifico (Singapore) | Sì | | Asia Pacifico (Sydney) | Sì | | Asia Pacifico (Tokyo) (ap-northeast-1) | Sì | | Canada (Centrale) (ca-central-1) | Sì | | Europa (Francoforte) (eu-central-1) | Sì | | Europa (Irlanda) (eu-west-1) | Sì | | Europa (Londra) (eu-west-2) | Sì | | Stati Uniti orientali (Virginia settentrionale) (us-east-1) | Sì | | Stati Uniti occidentali (Oregon) (us-west-2) | Sì | ## Chiama le regioni di analisi La tabella seguente elenca le AWS regioni disponibili per l'analisi, la trascrizione e la registrazione delle chiamate. | **AWS Region** | **Analisi vocale** | **Trascrizione** | **Registrazione delle chiamate** | | --- | --- | --- | --- | | Stati Uniti orientali (Virginia settentrionale) (us-east-1) | Sì | Sì | Sì | | Stati Uniti occidentali (Oregon) (us-west-2) | Sì | Sì | Sì | | Europa (Francoforte) (eu-central-1) | No | Sì | Sì | ## Regioni di riunione *Le riunioni di Amazon Chime SDK hanno regioni di *controllo e regioni multimediali*.* Una regione di controllo fornisce l'endpoint API utilizzato per creare, aggiornare ed eliminare le riunioni. Le Regioni di controllo inoltre ricevono ed elaborano. [Informazioni sugli eventi del ciclo di vita delle riunioni di Amazon Chime SDK](using-events.md) Le aree multimediali ospitano le riunioni effettive e i clienti si connettono alle vostre aree multimediali. Specificate la regione multimediale quando chiamate l'[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateMeeting.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateMeeting.html)API. Una regione di controllo può creare una riunione in qualsiasi regione multimediale nella stessa AWS partizione. Tuttavia, è possibile aggiornare solo una riunione nella regione di controllo utilizzata per creare la riunione. Per ulteriori informazioni sulla selezione delle regioni di controllo e multimediali, consulta[Utilizzo delle regioni di riunione per le riunioni dell'SDK Amazon Chime](chime-sdk-meetings-regions.md). La tabella seguente elenca le regioni che forniscono il controllo, i contenuti multimediali o entrambi. | **AWS Region** | **Controllo delle riunioni** | **Media per riunioni** | | --- | --- | --- | | **Africa (Città del Capo) (af-south-1) \$1** | Sì \$1\$1 | Sì | | Asia Pacifico (Mumbai) (ap-south-1) | Sì | Sì | | Asia Pacifico (Seoul) (ap-northeast-2) | Sì | Sì | | Asia Pacifico (Singapore) (ap-southeast-1) | Sì | Sì | | Asia Pacifico (Sydney) (ap-southeast-2) | Sì | Sì | | Asia Pacifico (Tokyo) (ap-northeast-1) | Sì | Sì | | Canada (Centrale) (ca-central-1) | Sì | Sì | | Europa (Francoforte) (eu-central-1) | Sì | Sì | | Europa (Irlanda) (eu-west-1) | | Sì | | Europa (Londra) (eu-west-2) | Sì | Sì | | **Europa (Milano) (eu-south-1) \$1** | | Sì | | Europe (Parigi) (eu-west-3) | | Sì | | Europa (Stoccolma) (eu-north-1) | | Sì | | **Israele (Tel Aviv) (il-central-1) \$1** | **Sì \$1\$1** | Sì | | Sud America (San Paolo) (sa-east-1) | | Sì | | Stati Uniti orientali (Ohio) (us-east-2) | | Sì | | Stati Uniti orientali (Virginia settentrionale) (us-east-1) | Sì | Sì | | Stati Uniti occidentali (California settentrionale) (us-west-1) | | Sì | | Stati Uniti occidentali (Oregon) (us-west-2) | Sì | Sì | | AWS GovCloud (Stati Uniti orientali) (us-gov-east-1) | Sì | Sì | | AWS GovCloud (Stati Uniti occidentali) (us-gov-west-1) | Sì | Sì | **\$1** Devi abilitare queste regioni nel tuo AWS account. Per ulteriori informazioni, consulta [Abilitare una regione](https://docs.aws.amazon.com/general/latest/gr/rande-manage.html#rande-manage-enable) nella *AWS Guida generale*. **\$1\$1** Le riunioni che utilizzano il controllo delle riunioni in questa regione possono ospitare solo contenuti multimediali in questa regione. **Nota** Per creare una riunione in una regione AWS GovCloud (Stati Uniti), è necessario utilizzare una regione di controllo in GovCloud. Inoltre, le regioni di controllo in cui GovCloud è possibile organizzare riunioni solo nelle regioni AWS GovCloud (Stati Uniti). ## Regioni della pipeline multimediale *Le pipeline multimediali di Amazon Chime SDK hanno regioni di *controllo e regioni* multimediali.* Una regione di controllo fornisce l'endpoint dell'API Media Pipeline utilizzato per creare ed eliminare le pipeline multimediali. Utilizzate anche le regioni di controllo per ricevere ed elaborare gli eventi della pipeline [multimediale](media-pipe-events.md). Le aree multimediali gestiscono le pipeline multimediali e il sistema seleziona automaticamente la stessa regione multimediale della riunione. È possibile utilizzare una regione di controllo per creare una pipeline multimediale in qualsiasi regione dati. La pipeline multimediale può partecipare a una riunione in qualsiasi regione multimediale della riunione. | **AWS Region** | **Controllo** | **Media** | | --- | --- | --- | | **Africa (Città del Capo) (af-south-1) \$1** | | Sì | | Asia Pacifico (Mumbai) (ap-south-1) | Sì | Sì | | Asia Pacifico (Seoul) (ap-northeast-2) | Sì | Sì | | Asia Pacifico (Singapore) (ap-southeast-1) | Sì | Sì | | Asia Pacifico (Sydney) (ap-southeast-2) | Sì | Sì | | Asia Pacifico (Tokyo) (ap-northeast-1) | Sì | Sì | | Canada (Centrale) (ca-central-1) | Sì | Sì | | Europa (Francoforte) (eu-central-1) | Sì | Sì | | Europa (Irlanda) (eu-west-1) | | Sì | | Europa (Londra) (eu-west-2) | Sì | Sì | | **Europa (Milano) (eu-south-1) \$1** | | Sì | | Europe (Parigi) (eu-west-3) | | Sì | | Europa (Stoccolma) (eu-north-1) | | Sì | | Sud America (San Paolo) (sa-east-1) | | Sì | | Stati Uniti orientali (Ohio) (us-east-2) | | Sì | | Stati Uniti orientali (Virginia settentrionale) (us-east-1) | Sì | Sì | | Stati Uniti occidentali (California settentrionale) (us-west-1) | | Sì | | Stati Uniti occidentali (Oregon) (us-west-2) | Sì | Sì | **\$1** Devi abilitare queste regioni nel tuo AWS account. Per ulteriori informazioni, consulta [Abilitare una regione](https://docs.aws.amazon.com/general/latest/gr/rande-manage.html#rande-manage-enable) nella *AWS Guida generale*. ## Regioni di messaggistica *La messaggistica di Amazon Chime SDK ha *regioni di controllo e aree dati*.* La regione di controllo espone l'endpoint dell'API di messaggistica e la regione dati archivia i messaggi. Se utilizzi Amazon Kinesis per lo streaming di dati di messaggistica o AWS Lambda funzioni per i flussi di canale, questi devono risiedere nella regione di controllo. | **AWS Region** | **Controllo** | **Dati** | | --- | --- | --- | | Europa (Francoforte) (eu-central-1) | Sì | Sì | | Stati Uniti orientali (Virginia settentrionale) (us-east-1) | Sì | Sì | ## Regioni vocali *Le funzionalità SIP (Session Initiation Protocol) di Amazon Chime SDK hanno *regioni API e aree *multimediali* e regioni* PSTN.* Le regioni API forniscono gli endpoint API per la creazione e la configurazione delle funzionalità SIP. Le regioni multimediali contengono connettori vocali Amazon Chime SDK e applicazioni multimediali SIP. Le regioni PSTN consentono ai clienti di connettere i sistemi telefonici locali alla rete telefonica pubblica. Inoltre, le regioni PSTN supportano la fornitura e la gestione dei numeri di telefono. | **AWS Region** | **API** | **Media** | **PSTN** | | --- | --- | --- | --- | | Asia Pacifico (Seoul) (ap-northeast-2) | Sì | Sì | | | Asia Pacifico (Singapore) (ap-southeast-1) | Sì | Sì | | | Asia Pacifico (Sydney) (ap-southeast-2) | Sì | Sì | | | Asia Pacifico (Tokyo) (ap-northeast-1) | Sì | Sì | | | Canada (Centrale) (ca-central-1) | Sì | Sì | | | Europa (Francoforte) (eu-central-1) | Sì | Sì | | | Europa (Irlanda) (eu-west-1) | Sì | Sì | | | Europa (Londra) (eu-west-2) | Sì | Sì | | | Stati Uniti orientali (Virginia settentrionale) (us-east-1) | Sì | Sì | **Sì \$1** | | Stati Uniti occidentali (Oregon) (us-west-2) | Sì | Sì | Sì **\$1** | **\$1** Consulta la pagina [dei prezzi di Amazon Chime SDK](https://aws.amazon.com/chime/chime-sdk/pricing/) per informazioni sulla disponibilità dei numeri di telefono in regioni specifiche. AWS # Scopri le librerie client Amazon Chime SDK Prima di poter creare client per riunioni in tempo reale con l'SDK Amazon Chime, devi integrare l'applicazione client con una libreria client Amazon Chime SDK. Sono disponibili le seguenti librerie client: + [Libreria client Amazon Chime SDK per Android: una libreria](https://github.com/aws/amazon-chime-sdk-android) Kotlin che ti aiuta a creare applicazioni Amazon Chime SDK su dispositivi Android supportati. + [Libreria client di segnalazione Amazon Chime SDK per C\$1\$1: una libreria C\$1\$1](https://github.com/aws/amazon-chime-sdk-cpp/tree/main/chime-sdk-signaling-cpp) che ti aiuta a configurare connessioni di segnalazione alle riunioni di Amazon Chime SDK su dispositivi integrati. + Libreria [client Amazon Chime SDK per iOS](https://github.com/aws/amazon-chime-sdk-ios): una libreria Swift che ti aiuta a creare applicazioni Amazon Chime SDK su dispositivi iOS supportati. + [Libreria client Amazon Chime SDK per JavaScript ([NPM](https://www.npmjs.com/package/amazon-chime-sdk-js)): una JavaScript libreria](https://github.com/aws/amazon-chime-sdk-js) con definizioni dei TypeScript tipi che ti aiuta a creare applicazioni Amazon Chime SDK in browser compatibili con WebRTC. + [Libreria client Amazon Chime SDK](https://github.com/aws/amazon-chime-sdk-cpp) per Windows. Una libreria C\$1\$1 che ti aiuta a creare applicazioni Amazon Chime SDK sui dispositivi supportati. Per informazioni su come integrare la tua applicazione client con l'SDK Amazon Chime, consulta le azioni nei file della libreria client. `README.md` Usa le demo per scoprire come creare componenti multimediali specifici per la tua applicazione. # Comprendere l'integrazione SIP utilizzando un Amazon Chime SDK Voice Connector Integra la tua infrastruttura vocale compatibile con SIP con un connettore vocale SDK Amazon Chime per effettuare chiamate vocali SIP. È necessario utilizzare le regioni o. `us-east-1` `us-east-2` È necessario disporre di un IP Private Branch Exchange (PBX), Session Border Controller (SBC) o un'altra infrastruttura vocale con accesso a Internet che supporti il Session Initiation Protocol (SIP). Per ulteriori informazioni, consulta [Prima di iniziare nella Guida](https://docs.aws.amazon.com/chime-sdk/latest/ag/voice-connectors.html#vc-prereq) per l'*amministratore di Amazon Chime SDK*. **Per integrare la tua infrastruttura vocale** 1. Crea un connettore vocale Amazon Chime SDK nel tuo account. AWS Per ulteriori informazioni, consulta [Creazione di un connettore vocale Amazon Chime SDK](https://docs.aws.amazon.com/chime-sdk/latest/ag/voice-connectors.html#create-voicecon) nella Guida per l'amministratore di *Amazon Chime* SDK. 1. Modifica le impostazioni del tuo Amazon Chime SDK Voice Connector per consentire le chiamate dalla tua infrastruttura vocale verso. AWS Per ulteriori informazioni, consulta [Modifica delle impostazioni di Amazon Chime SDK Voice Connector](https://docs.aws.amazon.com/chime-sdk/latest/ag/voice-connectors.html#edit-voicecon) nella *Amazon Chime* SDK Administrator Guide. 1. **Per le impostazioni di **terminazione**, seleziona Abilitato.** 1. **Per **Allowlist**, scegli Nuovo.** 1. Immettete le notazioni CIDR degli indirizzi IP per l'infrastruttura SIP interna. Ciò consente all'infrastruttura di accedere a Amazon Chime SDK Voice Connector. Ad esempio, per consentire il traffico proveniente da un indirizzo IP`10.24.34.0`, allowlist la notazione CIDR. `10.24.34.0/32` 1. Scegli **Aggiungi**. 1. Per **Calling plan (Piano chiamate)**, selezionare il paese o i paesi da aggiungere al piano chiamate. 1. **Modifica tutte le altre impostazioni in base alle esigenze e scegli Salva.** 1. Nella console Amazon Chime SDK, in **Connettori vocali**, visualizza il **nome host in uscita** per il tuo Amazon Chime SDK Voice Connector. Ad esempio, .voiceconnector.chime.aws. *abcdef1ghij2klmno3pqr4* 1. Per partecipare a una riunione utilizzando l'SDK Amazon Chime, utilizza un URI SIP per effettuare una richiesta SIP al nome host in **uscita del tuo** Amazon Chime SDK Voice Connector. Usa il numero di telefono nell'URI SIP. **\$117035550122** Imposta il `transport` parametro per utilizzare il protocollo TLS. Infine, usa il token di join univoco generato chiamando il [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateAttendee.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateAttendee.html)Azione API. Per maggiori informazioni, consulta il seguente esempio: **Example Esempio: richiesta SIP** L'esempio seguente mostra il contenuto di un URI SIP utilizzato per effettuare una richiesta SIP a un Amazon Chime SDK Voice Connector. ``` sip:+17035550122@abcdef1ghij2klmno3pqr4.voiceconnector.chime.aws;transport=tls;X-chime-join-token=join-token ``` L'esempio seguente mostra un esempio di messaggio SIP INVITE per partecipare a una riunione Amazon Chime SDK. ``` INVITE sip:+17035550122@abcdef1ghij2klmno3pqr4.voiceconnector.chime.aws;transport=tls;X-chime-join-token=join-token SIP/2.0 Via: SIP/2.0/TLS IPaddress:12345;rport;branch=branch;alias Max-Forwards: 70 From: sip:+12065550100@IPaddress;tag=tag To: sip:+17035550122@abcdef1ghij2klmno3pqr4.voiceconnector.chime.aws;X-chime-join-token=join-token Contact: Call-ID: a1234567-89b0-1c2d-e34f-5gh678j9k2lm CSeq: 6214 INVITE Allow: PRACK, INVITE, ACK, BYE, CANCEL, UPDATE, INFO, SUBSCRIBE, NOTIFY, REFER, MESSAGE, OPTIONS Supported: replaces, 100rel, timer, norefersub Session-Expires: 1800 Min-SE: 90 Content-Type: application/sdp Content-Length: 991 v=0 o=- 3775321410 3775321410 IN IP4 IPaddress s=pjmedia b=AS:117 t=0 0 a=X-nat:0 m=audio 4000 RTP/SAVP 0 3 8 9 125 101 c=IN IP4 IPaddress b=TIAS:96000 a=rtcp:4001 IN IP4 IPaddress a=sendrecv a=rtpmap:0 PCMU/8000 a=rtpmap:3 GSM/8000 a=rtpmap:8 PCMA/8000 a=rtpmap:9 G722/8000 a=rtpmap:125 opus/48000/2 a=fmtp:125 useinbandfec=1 a=rtpmap:101 telephone-event/8000 a=fmtp:101 0-16 a=crypto:1 AEAD_AES_256_GCM inline:EXAMPLE a=crypto:2 AEAD_AES_256_GCM_8 inline:EXAMPLE a=crypto:3 AES_256_CM_HMAC_SHA1_80 inline:EXAMPLE a=crypto:4 AES_256_CM_HMAC_SHA1_32 inline:EXAMPLE a=crypto:5 AES_CM_128_HMAC_SHA1_80 inline:EXAMPLE a=crypto:6 AES_CM_128_HMAC_SHA1_32 inline:EXAMPLE ``` **Nota** L'SDK Amazon Chime riconosce i numeri di telefono solo nel formato E.164. Assicurati che nell'intestazione sia presente un numero di telefono E.164. `From` # Informazioni sulle notifiche degli eventi di Amazon Chime SDK L'SDK Amazon Chime supporta l'invio di notifiche relative agli eventi delle riunioni ad Amazon EventBridge, Amazon Simple Queue Service (SQS) e Amazon Simple Notification Service (SNS). **Nota** Lo spazio dei nomi predefinito per le riunioni di Amazon Chime SDK utilizza gli endpoint. `ChimeSDKMeetings` Lo spazio dei nomi Chime legacy utilizza un singolo endpoint. Per ulteriori informazioni sui namespace e sugli endpoint, consulta la sezione precedente di questa guida. [Migrazione allo spazio dei nomi per le riunioni di Amazon Chime SDK](meeting-namespace-migration.md) ## Invio di notifiche a EventBridge Puoi inviare notifiche di eventi Amazon Chime SDK a. EventBridge *Per informazioni dettagliate sull'utilizzo dell'SDK Amazon Chime con EventBridge, consulta [Automating the Amazon Chime SDK with nella Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/ag/automating-chime-with-cloudwatch-events.html#events-sdk) SDK Administrator EventBridge Guide.* Per informazioni su EventBridge, consulta la [Amazon EventBridge User Guide](https://docs.aws.amazon.com/eventbridge/latest/userguide/). ## Invio di notifiche ad Amazon SQS e Amazon SNS Puoi utilizzare l'[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateMeeting.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateMeeting.html)API nell'*Amazon Chime SDK API Reference* per inviare notifiche sugli eventi delle riunioni di Amazon Chime SDK a una coda Amazon SQS e a un argomento Amazon SNS per riunione. Questo può aiutare a ridurre la latenza delle notifiche. Per ulteriori informazioni su Amazon SQS, consulta la [Guida per gli sviluppatori di Amazon Simple Queue Service)](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/). Per ulteriori informazioni su Amazon SNS, consultare la [Guida per gli sviluppatori di Amazon Simple Notification Service](https://docs.aws.amazon.com/sns/latest/dg/). Le notifiche inviate ad Amazon SQS e Amazon SNS contengono le stesse informazioni delle notifiche a cui invia l'SDK Amazon Chime. EventBridge L'SDK Amazon Chime supporta l'invio di notifiche sugli eventi delle riunioni a code e argomenti nella regione API utilizzata per creare una riunione. Le notifiche degli eventi potrebbero essere inviate in ordine diverso dall'occorrenza. ## Concessione dell'accesso all'SDK Amazon Chime ad Amazon SQS e Amazon SNS Prima che Amazon Chime SDK possa inviarti notifiche tramite una coda Amazon SQS o un argomento Amazon SNS, devi concedere all'SDK Amazon Chime l'autorizzazione a pubblicare messaggi sull'Amazon Resource Name (ARN) della coda o dell'argomento. A tale scopo, collega una policy AWS Identity and Access Management (IAM) alla coda o all'argomento che conceda le autorizzazioni appropriate all'SDK Amazon Chime. Per ulteriori informazioni, consulta [Gestione delle identità e degli accessi in Amazon SQS](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-authentication-and-access-control.html) nella Guida per gli *sviluppatori di Amazon Simple Queue Service e Casi di esempio per il controllo degli accessi di Amazon SNS nella Guida* [per gli sviluppatori di Amazon Simple](https://docs.aws.amazon.com/sns/latest/dg/sns-access-policy-use-cases.html) *Notification* Service. **Nota** La coda Amazon SQS o l'argomento Amazon SNS devono utilizzare la stessa regione dell'endpoint API AWS SDK Amazon Chime. **Example Consenti all'SDK Amazon Chime di pubblicare eventi in una coda Amazon SQS** L'esempio seguente di policy IAM concede all'SDK Amazon Chime l'autorizzazione a pubblicare notifiche di eventi di riunione nella coda Amazon SQS specificata. Nota l'istruzione condizionale per and. `aws:SourceArn` `aws:SourceAccount` Risolvono potenziali problemi con [Confused Deputy](https://docs.aws.amazon.com/IAM/latest/UserGuide/confused-deputy.html). + È possibile utilizzare `aws:SourceArn` o `aws:SourceAccount` durante la creazione delle politiche seguenti. Non è necessario utilizzare entrambi. + Questi esempi utilizzano lo spazio dei `ChimeSDKMeetings` nomi e l'endpoint corrispondente. Se si utilizza lo spazio dei `Chime` nomi, è necessario utilizzare l'endpoint. `chime.amazonaws.com` **** ``` { "Version":"2012-10-17", "Id": "example-ID", "Statement": [ { "Sid": "example-statement-ID", "Effect": "Allow", "Principal": { "Service": "meetings.chime.amazonaws.com" }, "Action": [ "sqs:SendMessage", "sqs:GetQueueUrl" ], "Resource": "arn:aws:sqs:us-east-1:111122223333:queueName", "Condition": { "ArnLike": { "aws:SourceArn": "arn:aws:chime:us-east-1:111122223333:*" }, "StringEquals": { "aws:SourceAccount": "111122223333" } } } ] } ``` Questo esempio mostra una policy di Amazon SNS che consente all'SDK Amazon Chime di inviare notifiche sugli eventi delle riunioni al tuo argomento SNS. **** ``` { "Version":"2012-10-17", "Id": "example-ID", "Statement": [ { "Sid": "allow-chime-sdk-access-statement-id", "Effect": "Allow", "Principal": { "Service": "meetings.chime.amazonaws.com" }, "Action": [ "SNS:Publish" ], "Resource": "arn:aws:sns:us-east-1:111122223333:topicName", "Condition": { "ArnLike": { "aws:SourceArn": "arn:aws:chime:us-east-1:111122223333:*" }, "StringEquals": { "aws:SourceAccount": "111122223333" } } } ] } ``` Se la coda Amazon SQS è abilitata per la crittografia lato server (SSE), è necessario eseguire un passaggio aggiuntivo. Allega una policy IAM alla AWS KMS chiave associata che concede l'autorizzazione all'SDK Amazon Chime per AWS KMS le azioni necessarie per crittografare i dati aggiunti alla coda. **** ``` { "Version":"2012-10-17", "Id": "example-ID", "Statement": [ { "Sid": "example-statement-ID", "Effect": "Allow", "Principal": { "Service": "meetings.chime.amazonaws.com" }, "Action": [ "kms:GenerateDataKey", "kms:Decrypt" ], "Resource": "*" } ] } ``` **Example Consenti all'SDK Amazon Chime di pubblicare eventi su un argomento Amazon SNS** L'esempio seguente di policy IAM concede all'SDK Amazon Chime l'autorizzazione a pubblicare notifiche di eventi di riunione sull'argomento Amazon SNS specificato. **** ``` { "Version":"2012-10-17", "Id": "example-ID", "Statement": [ { "Sid": "allow-chime-sdk-access-statement-id", "Effect": "Allow", "Principal": { "Service": "meetings.chime.amazonaws.com" }, "Action": [ "SNS:Publish" ], "Resource": "arn:aws:sns:us-east-1:111122223333:topicName", "Condition": { "ArnLike": { "aws:SourceArn": "arn:aws:chime:us-east-1:111122223333:*" }, "StringEquals": { "aws:SourceAccount": "111122223333" } } } ] } ``` # Migrazione dallo spazio dei nomi Amazon Chime L'SDK Amazon Chime si espone APIs su una serie di endpoint. Sebbene sia possibile effettuare richieste HTTPS direttamente agli endpoint, molti clienti utilizzano l' AWS SDK nelle loro applicazioni per chiamare il servizio. APIs L' AWS SDK è disponibile in diverse lingue e semplifica le chiamate API incapsulando la logica di firma delle richieste e dei tentativi. L' AWS SDK include uno spazio dei nomi per ogni endpoint del servizio. Al primo lancio, l'SDK Amazon Chime condivideva un singolo endpoint con l'applicazione Amazon Chime. Di conseguenza, le soluzioni hanno utilizzato lo spazio dei `Chime` nomi nell' AWS SDK per chiamare l'applicazione Amazon Chime e l'SDK Amazon Chime. APIs L'SDK Amazon Chime ora fornisce endpoint dedicati per ogni servizio secondario, come riunioni e audio PSTN. Ogni endpoint è indirizzabile tramite uno spazio dei nomi dedicato nell'SDK. AWS I seguenti argomenti elencano i servizi, i namespace e gli endpoint e descrivono come utilizzarli nel codice e con la CLI. AWS **Topics** + [Endpoint, namespace e comandi CLI](#endpoint-namespace-cli) + [Guida alla migrazione per ogni servizio](#help-per-service) + [Mappatura delle API](#name-end-map) ## Endpoint, namespace e comandi CLI La tabella seguente elenca i namespace, gli endpoint e i comandi CLI dedicati di Amazon Chime SDK. I collegamenti consentono di accedere a ulteriori informazioni su ciascun servizio. | Endpoint | AWS Namespace SDK | AWS CLI SDK | | --- | --- | --- | | [segnale acustico di identità](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Identity.html) | carillon SDKIdentity | [https://docs.aws.amazon.com/cli/latest/reference/chime-sdk-identity/index.html](https://docs.aws.amazon.com/cli/latest/reference/chime-sdk-identity/index.html) | | [media-pipelines-chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Media_Pipelines.html) | Chime Pipeline SDKMedia | [https://docs.aws.amazon.com/cli/latest/reference/chime-sdk-media-pipelines/index.html](https://docs.aws.amazon.com/cli/latest/reference/chime-sdk-media-pipelines/index.html) | | [riunioni-chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html) | carillon SDKMeetings | [https://docs.aws.amazon.com/cli/latest/reference/chime-sdk-meetings/index.html](https://docs.aws.amazon.com/cli/latest/reference/chime-sdk-meetings/index.html) | | [campanello di messaggistica](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Messaging.html) | carillon SDKMessaging | [https://docs.aws.amazon.com/cli/latest/reference/chime-sdk-messaging/index.html](https://docs.aws.amazon.com/cli/latest/reference/chime-sdk-messaging/index.html) | | [campanello vocale](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Voice.html) | carillon SDKVoice | [https://docs.aws.amazon.com/cli/latest/reference/chime-sdk-voice/index.html](https://docs.aws.amazon.com/cli/latest/reference/chime-sdk-voice/index.html) | ## Guida alla migrazione per ogni servizio Tutti i clienti dovrebbero prendere in considerazione l'utilizzo degli endpoint SDK Amazon Chime dedicati per accedere alle funzionalità e alle regioni più recenti di Amazon Chime SDK. APIs AWS Se utilizzi l'endpoint condiviso con lo spazio dei `Chime` nomi, le seguenti guide alla migrazione possono aiutarti a comprendere le differenze tecniche prima della migrazione. + [Migrazione allo spazio dei nomi Amazon Chime SDKIdentity ](identity-namespace-migration.md) + [Migrazione allo spazio dei nomi Amazon SDKMedia Chime Pipelines](migrate-pipelines.md) + [Migrazione allo spazio dei nomi Amazon Chime SDKMeetings ](meeting-namespace-migration.md) + [Migrazione allo spazio dei nomi Amazon Chime SDKMessaging ](messaging-namespace-migration.md) + [Migrazione allo spazio dei nomi Amazon Chime SDKVoice ](voice-namespace-migration.md) ## Mappatura delle API La tabella seguente elenca i APIs namespace e i `Chime` relativi namespace dedicati e. APIs Alcuni di APIs quelli dedicati differiscono da `Chime` APIs, e la tabella indica tali istanze. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/chime-sdk/latest/dg/migrate-from-chm-namespace.html) **\$1** L'API è stata sostituita da un'API con un altro nome. **\$1** L'API non è più disponibile.