Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # Utilisation du SDK Amazon Chime Vous utilisez le SDK Amazon Chime pour créer des applications multimédia en temps réel capables d'envoyer et de recevoir du son et de la vidéo et d'autoriser le partage de contenu. Le SDK Amazon Chime fonctionne indépendamment des comptes d'administrateur Amazon Chime et n'a aucune incidence sur les réunions organisées sur Amazon Chime. Le SDK Amazon Chime fournit plutôt des outils de création que vous pouvez utiliser pour créer vos propres applications de réunion. **Topics** + [Conditions requises pour utiliser le SDK Amazon Chime](#mtg-prereqs) + [Concepts du SDK Amazon Chime](#mtg-glossary) + [Architecture du SDK Amazon Chime](#mtg-arch) + [Quotas pour le SDK Amazon Chime](#mtg-limits) + [Configuration système requise pour le SDK Amazon Chime](#mtg-browsers) + [Régions AWS disponibles pour le SDK Amazon Chime](sdk-available-regions.md) + [En savoir plus sur les bibliothèques clientes du SDK Amazon Chime](mtgs-sdk-client-lib.md) + [Comprendre l'intégration SIP à l'aide d'un connecteur vocal Amazon Chime SDK](mtgs-sdk-cvc.md) + [Comprendre les notifications d'événements du SDK Amazon Chime](mtgs-sdk-notifications.md) + [Migration depuis l'espace de noms Amazon Chime](migrate-from-chm-namespace.md) ## Conditions requises pour utiliser le SDK Amazon Chime L'utilisation du SDK Amazon Chime nécessite les éléments suivants : + La capacité de programmer. + Un AWS compte. + **Rôle IAM doté d'une politique autorisant l'accès aux actions de l'API Amazon Chime utilisées par le SDK Amazon Chime, telles que la politique du SDK géré. AWS AmazonChime** *Pour plus d'informations, consultez [Comment fonctionne Amazon Chime avec IAM](https://docs.aws.amazon.com/chime-sdk/latest/ag/security_iam_service-with-iam.html) et [Autoriser les utilisateurs à accéder aux actions du SDK Amazon Chime dans le guide de l'administrateur du SDK](https://docs.aws.amazon.com/chime-sdk/latest/ag/security_iam_id-based-policy-examples.html#security_iam_id-based-policy-examples-chime-sdk) Amazon Chime.* + Dans la majorité des cas d'utilisation, vous avez également besoin des éléments suivants : + Une **application serveur** : gère les ressources des réunions et des participants, et fournit ces ressources à l'application cliente. L'application serveur est créée dans le AWS compte et doit avoir accès au rôle IAM mentionné précédemment. + Une **application cliente** : reçoit des informations sur les réunions et les participants depuis l'application serveur, et utilise ces informations pour établir des connexions multimédia. ## Concepts du SDK Amazon Chime La terminologie et les concepts suivants sont essentiels pour comprendre comment utiliser le SDK Amazon Chime. **meeting** Une ressource éphémère identifiée par un unique. `MeetingId` `MeetingId`Il est placé sur un groupe de services multimédia hébergeant la réunion active. **groupe de services médias** Groupe de services médias qui héberge une réunion active. **placement dans les médias** Un ensemble de régionalisés URLs qui représente un groupe de services multimédia. Les participants se connectent au groupe de services médias avec leurs clients pour envoyer et recevoir du son et de la vidéo en temps réel et partager leurs écrans. **participant** Un participant à une réunion identifié par un identifiant unique`AttendeeId`. Les participants peuvent rejoindre et quitter librement les réunions à l'aide d'une application client créée à partir d'une bibliothèque cliente du SDK Amazon Chime. **jeton d'adhésion** Un jeton unique attribué à chaque participant. Les participants utilisent le jeton de connexion pour s'authentifier auprès du groupe de services multimédia. ## Architecture du SDK Amazon Chime La liste suivante décrit comment les différents composants de l'architecture du SDK Amazon Chime fonctionnent ensemble pour faciliter les réunions et les participants, ainsi que le partage audio, vidéo et de contenu. **Réunions et participants** Lorsque l'application serveur crée une réunion du SDK Amazon Chime, celle-ci est attribuée à un service multimédia spécifique à la région. Les hôtes du service sont responsables du transfert sécurisé des médias en temps réel entre les clients participants. Chaque participant créé se voit attribuer un jeton de participation unique, une clé secrète opaque que votre application serveur doit transférer en toute sécurité au client autorisé à rejoindre la réunion au nom d'un participant. Chaque client utilise un jeton de connexion pour s'authentifier auprès du groupe de services multimédia. Les clients utilisent une combinaison de sécurité WebSockets et de sécurité DTLS (Datagram Transport Layer Security) pour signaler de manière sécurisée le groupe de services multimédia et pour envoyer et recevoir du contenu multimédia à destination et en provenance d'autres participants via le groupe de services multimédia. **L'audio** Le service multimédia mixe le son de chaque participant et envoie le mixage à chaque destinataire, après avoir soustrait son propre son du mixage. L'Amazon Chime SDKs échantillonne le son à la fréquence la plus élevée prise en charge par l'appareil et le navigateur, jusqu'à un maximum de 48 kHz. Nous utilisons le codec Opus pour encoder le son, avec un débit par défaut de 32 kbit/s, qui peut être augmenté jusqu'à 128 kbit/s en stéréo et 64 kbit/s en mono. **Vidéo** Le service média agit comme une unité de transfert sélective (SFU) utilisant un modèle de publication et d'abonnement. Chaque participant peut publier une source vidéo, jusqu'à un total de 25 vidéos simultanées par réunion. La bibliothèque cliente du SDK Amazon Chime JavaScript prend en charge des résolutions vidéo allant jusqu'à 1280 x 720 à 30 images par seconde sans diffusion simultanée et à 15 images par seconde avec diffusion simultanée. Les bibliothèques clientes du SDK Amazon Chime pour [iOS](sdk-for-ios.md), [Android](sdk-for-android.md) et [Windows](client-lib-windows.md) prennent en charge des résolutions vidéo allant jusqu'à 1280 x 720 et 30 images par seconde, mais la fréquence d'images et la résolution réelles sont automatiquement gérées par le SDK Amazon Chime. Lorsqu'elle est active, la diffusion simultanée vidéo envoie chaque flux vidéo dans deux résolutions et débits différents. Les clients soumis à des contraintes de bande passante s'abonnent automatiquement au flux à faible débit. Le codage et le décodage vidéo utilisent l'accélération matérielle lorsqu'elle est disponible pour améliorer les performances. **Messages de données** Outre le contenu audio et vidéo, les participants à la réunion peuvent s'envoyer des messages de données en temps réel d'une valeur maximale de 2 Ko chacun. Vous pouvez utiliser les messages pour implémenter des fonctionnalités de réunion personnalisées, telles que le tableau blanc, le chat, les réactions emoji en temps réel et les signaux de commande d'étage spécifiques à l'application. **Partage de contenu** L'application client peut partager du contenu audio et vidéo, tel que des captures d'écran ou des fichiers multimédia. Le partage de contenu prend en charge le contenu vidéo préenregistré jusqu'à 1280 x 720 à 15 images par seconde et le son jusqu'à 48 kHz à 64 kbit/s. La capture d'écran pour le partage de contenu est prise en charge jusqu'à 15 images par seconde, mais peut être limitée par les capacités de l'appareil et du navigateur. ## Quotas pour le SDK Amazon Chime Les quotas pour le service Amazon Chime SDK sont documentés dans le. Références générales AWS Pour plus d'informations, consultez la section [Points de terminaison et quotas du SDK Amazon Chime](https://docs.aws.amazon.com/general/latest/gr/chime-sdk.html) dans le. *Références générales AWS* **Note** Les quotas de service sont établis par point de terminaison de l'API. Lorsque vous demandez une augmentation du quota de service, veillez à demander l'augmentation sur tous les points de terminaison d'API utilisés par votre application. ## Configuration système requise pour le SDK Amazon Chime La configuration système requise suivante s'applique aux applications créées avec le SDK Amazon Chime. **Navigateurs pris en charge, bibliothèque cliente du SDK Amazon Chime pour JavaScript** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/chime-sdk/latest/dg/meetings-sdk.html) **Bibliothèque cliente du SDK Amazon Chime pour iOS** + iOS version 13 ou ultérieure **Bibliothèque cliente du SDK Amazon Chime pour Android** + Système d'exploitation Android version 5 et versions ultérieures, ARM et ARM64 architecture # Régions AWS disponibles pour le SDK Amazon Chime Les tableaux suivants répertorient les fonctionnalités du service Amazon Chime SDK et les AWS régions qui fournissent chaque service. **Note** Les régions marquées d'un astérisque (**\$1**) doivent être activées dans votre AWS compte. AWS bloque ces régions par défaut. Pour plus d'informations sur l'activation des régions, voir [Spécifier les AWS régions que votre compte peut utiliser](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-regions.html) dans le manuel de *référence sur la gestion des AWS comptes*. **Topics** + [Régions de console](#sdk-console-regions) + [Régions d'analyse des appels](#call-analytics-regions) + [Régions de réunion](#sdk-meeting-regions) + [Pipeline médiatique \$1 Régions](#sdk-media-pipelines) + [Régions de messagerie](#sdk-messaging-regions) + [Régions vocales](#voice-regions) ## Régions de console Vous utilisez la console Amazon Chime SDK pour configurer les ressources et en savoir plus sur le service Amazon Chime SDK. | **AWS Région** | **Console** | | --- | --- | | Asie-Pacifique (Séoul) | Oui | | Asie-Pacifique (Singapour) | Oui | | Asie-Pacifique (Sydney) | Oui | | Asie-Pacifique (Tokyo) (ap-northeast-1) | Oui | | Canada (Centre) (ca-central-1) | Oui | | Europe (Francfort) (eu-central-1) | Oui | | Europe (Irlande) (eu-west-1) | Oui | | Europe (Londres) (eu-west-2) | Oui | | USA Est (Virginie du Nord) (us-east-1) | Oui | | USA Ouest (Oregon) (us-west-2) | Oui | ## Régions d'analyse des appels Le tableau suivant répertorie les AWS régions disponibles pour l'analyse, la transcription et l'enregistrement des appels. | **AWS Région** | **Analyses vocales** | **Transcription** | **Enregistrement des appels** | | --- | --- | --- | --- | | USA Est (Virginie du Nord) (us-east-1) | Oui | Oui | Oui | | USA Ouest (Oregon) (us-west-2) | Oui | Oui | Oui | | Europe (Francfort) (eu-central-1) | Non | Oui | Oui | ## Régions de réunion *Les réunions du SDK Amazon Chime *contrôlent les régions et les régions multimédia*.* Une région de contrôle fournit le point de terminaison de l'API utilisé pour créer, mettre à jour et supprimer des réunions. Les régions de contrôle reçoivent et traitent également[Comprendre les événements liés au cycle de vie du SDK Amazon Chime](using-events.md). Les régions médias accueillent les réunions proprement dites, et les clients se connectent à vos régions médias. Vous spécifiez la région du média lorsque vous appelez 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. Une région de contrôle peut créer une réunion dans n'importe quelle région multimédia de la même AWS partition. Toutefois, vous ne pouvez mettre à jour une réunion que dans la région de contrôle utilisée pour créer la réunion. Pour plus d'informations sur la sélection des régions de contrôle et multimédia, consultez[Utilisation des régions de réunion pour les réunions du SDK Amazon Chime](chime-sdk-meetings-regions.md). Le tableau suivant répertorie les régions qui fournissent le contrôle, les médias ou les deux. | **AWS Région** | **Contrôle des réunions** | **Médias de réunion** | | --- | --- | --- | | **Afrique (Le Cap) (af-south-1) \$1** | Oui\$1\$1 | Oui | | Asie-Pacifique (Mumbai) (ap-south-1) | Oui | Oui | | Asie-Pacifique (Séoul) (ap-northeast-2) | Oui | Oui | | Asie-Pacifique (Singapour) (ap-southeast-1) | Oui | Oui | | Asie-Pacifique (Sydney) (ap-southeast-2) | Oui | Oui | | Asie-Pacifique (Tokyo) (ap-northeast-1) | Oui | Oui | | Canada (Centre) (ca-central-1) | Oui | Oui | | Europe (Francfort) (eu-central-1) | Oui | Oui | | Europe (Irlande) (eu-west-1) | | Oui | | Europe (Londres) (eu-west-2) | Oui | Oui | | **Europe (Milan) (eu-south-1) \$1** | | Oui | | Europe (Paris) (eu-west-3) | | Oui | | Europe (Stockholm) (eu-north-1) | | Oui | | **Israël (Tel Aviv) (il-central-1) \$1** | **Oui\$1\$1** | Oui | | Amérique du Sud (São Paulo) (sa-east-1) | | Oui | | USA Est (Ohio) (us-east-2) | | Oui | | USA Est (Virginie du Nord) (us-east-1) | Oui | Oui | | USA Ouest (Californie du Nord) (us-west-1) | | Oui | | USA Ouest (Oregon) (us-west-2) | Oui | Oui | | AWS GovCloud (USA Est) (us-gov-east-1) | Oui | Oui | | AWS GovCloud (US-Ouest) (us-gov-west-1) | Oui | Oui | **\$1** Vous devez activer ces régions dans votre AWS compte. Pour plus d'informations, reportez-vous à la section [Activer une région](https://docs.aws.amazon.com/general/latest/gr/rande-manage.html#rande-manage-enable) dans le manuel de *référence AWS général*. **\$1\$1** Les réunions qui utilisent le contrôle des réunions dans cette région ne peuvent héberger des médias que dans cette région. **Note** Pour créer une réunion dans une région AWS GovCloud (États-Unis), vous devez utiliser une région de contrôle dans GovCloud. De plus, Control Regions in ne GovCloud peut organiser des réunions que dans les régions AWS GovCloud (États-Unis). ## Pipeline médiatique \$1 Régions *Les pipelines multimédia du SDK Amazon Chime *contrôlent les régions et les régions* multimédia.* Une région de contrôle fournit le point de terminaison de l'API Media Pipeline utilisé pour créer et supprimer des pipelines multimédia. Vous utilisez également les régions de contrôle pour recevoir et traiter [les événements du pipeline multimédia](media-pipe-events.md). Les régions multimédia gèrent vos pipelines multimédia, et le système sélectionne automatiquement la même région multimédia que la réunion. Vous pouvez utiliser une région de contrôle pour créer un pipeline multimédia dans n'importe quelle région de données. Le pipeline de médias peut participer à une réunion dans n'importe quelle région médiatique de réunion. | **AWS Région** | **Contrôle** | **Multimédia** | | --- | --- | --- | | **Afrique (Le Cap) (af-south-1) \$1** | | Oui | | Asie-Pacifique (Mumbai) (ap-south-1) | Oui | Oui | | Asie-Pacifique (Séoul) (ap-northeast-2) | Oui | Oui | | Asie-Pacifique (Singapour) (ap-southeast-1) | Oui | Oui | | Asie-Pacifique (Sydney) (ap-southeast-2) | Oui | Oui | | Asie-Pacifique (Tokyo) (ap-northeast-1) | Oui | Oui | | Canada (Centre) (ca-central-1) | Oui | Oui | | Europe (Francfort) (eu-central-1) | Oui | Oui | | Europe (Irlande) (eu-west-1) | | Oui | | Europe (Londres) (eu-west-2) | Oui | Oui | | **Europe (Milan) (eu-south-1) \$1** | | Oui | | Europe (Paris) (eu-west-3) | | Oui | | Europe (Stockholm) (eu-north-1) | | Oui | | Amérique du Sud (São Paulo) (sa-east-1) | | Oui | | USA Est (Ohio) (us-east-2) | | Oui | | USA Est (Virginie du Nord) (us-east-1) | Oui | Oui | | USA Ouest (Californie du Nord) (us-west-1) | | Oui | | USA Ouest (Oregon) (us-west-2) | Oui | Oui | **\$1** Vous devez activer ces régions dans votre AWS compte. Pour plus d'informations, reportez-vous à la section [Activer une région](https://docs.aws.amazon.com/general/latest/gr/rande-manage.html#rande-manage-enable) dans le manuel de *référence AWS général*. ## Régions de messagerie *La messagerie du SDK Amazon Chime comporte des régions de *contrôle et des régions de données*.* La région de contrôle expose le point de terminaison de l'API de messagerie et la région de données stocke les messages. Si vous utilisez Amazon Kinesis pour diffuser des données de messagerie ou des AWS Lambda fonctions pour les flux de canaux, elles doivent résider dans la région de contrôle. | **AWS Région** | **Contrôle** | **Données** | | --- | --- | --- | | Europe (Francfort) (eu-central-1) | Oui | Oui | | USA Est (Virginie du Nord) (us-east-1) | Oui | Oui | ## Régions vocales *Les fonctionnalités SIP (protocole d'initiation de session) du SDK Amazon Chime incluent des régions d'*API et des régions* *multimédia, ainsi que des régions PSTN*.* Les régions d'API fournissent les points de terminaison d'API pour créer et configurer les fonctionnalités SIP. Les régions multimédia contiennent des connecteurs vocaux Amazon Chime SDK et des applications multimédia SIP. Les régions PSTN permettent aux clients de connecter les systèmes téléphoniques locaux au réseau téléphonique public. En outre, les régions PSTN prennent en charge le provisionnement et la gestion des numéros de téléphone. | **AWS Région** | **API** | **Multimédia** | **PSTN** | | --- | --- | --- | --- | | Asie-Pacifique (Séoul) (ap-northeast-2) | Oui | Oui | | | Asie-Pacifique (Singapour) (ap-southeast-1) | Oui | Oui | | | Asie-Pacifique (Sydney) (ap-southeast-2) | Oui | Oui | | | Asie-Pacifique (Tokyo) (ap-northeast-1) | Oui | Oui | | | Canada (Centre) (ca-central-1) | Oui | Oui | | | Europe (Francfort) (eu-central-1) | Oui | Oui | | | Europe (Irlande) (eu-west-1) | Oui | Oui | | | Europe (Londres) (eu-west-2) | Oui | Oui | | | USA Est (Virginie du Nord) (us-east-1) | Oui | Oui | Oui **\$1** | | USA Ouest (Oregon) (us-west-2) | Oui | Oui | Oui **\$1** | **\$1** Consultez la page de [tarification du SDK Amazon Chime](https://aws.amazon.com/chime/chime-sdk/pricing/) pour obtenir des informations sur la disponibilité des numéros de téléphone dans des régions spécifiques. AWS # En savoir plus sur les bibliothèques clientes du SDK Amazon Chime Avant de pouvoir créer des clients de réunion en temps réel avec le SDK Amazon Chime, vous devez intégrer votre application client à une bibliothèque cliente du SDK Amazon Chime. Les bibliothèques clientes suivantes sont disponibles : + [Bibliothèque cliente du SDK Amazon Chime pour Android — Une bibliothèque](https://github.com/aws/amazon-chime-sdk-android) Kotlin qui vous aide à créer des applications du SDK Amazon Chime sur les appareils Android compatibles. + [Bibliothèque cliente de signalisation du SDK Amazon Chime pour C\$1\$1 : bibliothèque C\$1\$1](https://github.com/aws/amazon-chime-sdk-cpp/tree/main/chime-sdk-signaling-cpp) qui vous aide à configurer des connexions de signalisation aux réunions du SDK Amazon Chime sur des appareils intégrés. + Bibliothèque [cliente du SDK Amazon Chime pour iOS](https://github.com/aws/amazon-chime-sdk-ios) : bibliothèque Swift qui vous permet de créer des applications du SDK Amazon Chime sur les appareils iOS compatibles. + [Bibliothèque cliente du SDK Amazon Chime pour JavaScript ([NPM](https://www.npmjs.com/package/amazon-chime-sdk-js)) : bibliothèque](https://github.com/aws/amazon-chime-sdk-js) contenant des définitions de TypeScript type qui vous aide à créer des applications du SDK Amazon Chime dans des navigateurs compatibles WebRTC. JavaScript + [Bibliothèque cliente du SDK Amazon Chime](https://github.com/aws/amazon-chime-sdk-cpp) pour Windows. Une bibliothèque C\$1\$1 qui vous aide à créer des applications Amazon Chime SDK sur les appareils compatibles. Pour savoir comment intégrer votre application client au SDK Amazon Chime, consultez les actions dans les fichiers de la bibliothèque client. `README.md` Utilisez les démos pour apprendre à créer des composants multimédia spécifiques à votre application. # Comprendre l'intégration SIP à l'aide d'un connecteur vocal Amazon Chime SDK Intégrez votre infrastructure vocale compatible SIP à un connecteur vocal Amazon Chime SDK pour passer des appels vocaux SIP. Vous devez utiliser le `us-east-1` ou `us-east-2` les régions. Vous devez disposer d'un PBX (IP Private Branch Exchange), d'un contrôleur de frontière de session (SBC) ou d'une autre infrastructure vocale avec accès à Internet compatible avec le protocole SIP (Session Initiation Protocol). Pour plus d'informations, consultez [Before you begin](https://docs.aws.amazon.com/chime-sdk/latest/ag/voice-connectors.html#vc-prereq) dans le guide de l'administrateur du *SDK Amazon Chime*. **Pour intégrer votre infrastructure vocale** 1. Créez un connecteur vocal Amazon Chime SDK sous votre compte. AWS Pour plus d'informations, consultez la section [Création d'un connecteur vocal du SDK Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/ag/voice-connectors.html#create-voicecon) dans le guide de l'administrateur du SDK *Amazon Chime*. 1. Modifiez les paramètres du connecteur vocal du SDK Amazon Chime pour autoriser les appels depuis votre infrastructure vocale vers. AWS Pour plus d'informations, consultez la section [Modification des paramètres du connecteur vocal du SDK Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/ag/voice-connectors.html#edit-voicecon) dans le guide de l'administrateur du SDK *Amazon Chime*. 1. Pour les **paramètres de résiliation**, sélectionnez **Activé**. 1. Pour **Liste d'autorisation**, choisissez **Nouveau**. 1. Entrez les notations CIDR des adresses IP de votre infrastructure SIP interne. Cela permet à votre infrastructure d'accéder au connecteur vocal du SDK Amazon Chime. Par exemple, pour autoriser le trafic provenant d'une adresse IP`10.24.34.0`, autorisez la notation CIDR. `10.24.34.0/32` 1. Choisissez **Ajouter**. 1. Pour **Calling plan (Tarif d'appels)**, sélectionnez le ou les pays à ajouter à votre tarif d'appel. 1. Modifiez les autres paramètres selon vos besoins, puis choisissez **Enregistrer**. 1. Dans la console Amazon Chime SDK, sous **Connecteurs vocaux**, consultez le **nom d'hôte sortant** de votre connecteur vocal Amazon Chime SDK. Par exemple, *abcdef1ghij2klmno3pqr4* .voiceconnector.chime.aws. 1. Pour rejoindre une réunion à l'aide du SDK Amazon Chime, utilisez une URI SIP pour envoyer une demande SIP au **nom d'hôte sortant de votre connecteur vocal** Amazon Chime SDK. Utilisez le numéro de téléphone **\$117035550122** dans l'URI SIP. Définissez le `transport` paramètre pour utiliser le protocole TLS. Enfin, utilisez le jeton de jointure unique généré en appelant le [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)Action de l'API. Pour plus d'informations, consultez l'exemple suivant. **Example Exemple : demande SIP** L'exemple suivant montre le contenu d'un URI SIP utilisé pour envoyer une demande SIP à un connecteur vocal Amazon Chime SDK. ``` sip:+17035550122@abcdef1ghij2klmno3pqr4.voiceconnector.chime.aws;transport=tls;X-chime-join-token=join-token ``` L'exemple suivant montre un exemple de message SIP INVITE pour participer à une réunion du SDK Amazon Chime. ``` 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 ``` **Note** Le SDK Amazon Chime reconnaît les numéros de téléphone uniquement au format E.164. Assurez-vous qu'un numéro de téléphone E.164 figure dans votre `From` en-tête. # Comprendre les notifications d'événements du SDK Amazon Chime Le SDK Amazon Chime permet d'envoyer des notifications d'événements de réunion à Amazon EventBridge, Amazon Simple Queue Service (SQS) et Amazon Simple Notification Service (SNS). **Note** L'espace de noms de réunions par défaut du SDK Amazon Chime utilise les points de terminaison. `ChimeSDKMeetings` L'ancien espace de noms Chime utilise un seul point de terminaison. Pour plus d'informations sur les espaces de noms et les points de terminaison, reportez-vous à la [Migration vers l'espace de noms des réunions du SDK Amazon Chime](meeting-namespace-migration.md) section précédente de ce guide. ## Envoi de notifications à EventBridge Vous pouvez envoyer des notifications d'événements du SDK Amazon Chime à. EventBridge *Pour obtenir des informations détaillées sur l'utilisation du SDK Amazon Chime avec EventBridge, consultez [Automatiser le SDK Amazon Chime dans le guide de l'administrateur EventBridge du SDK Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/ag/automating-chime-with-cloudwatch-events.html#events-sdk).* Pour plus d'informations à ce sujet EventBridge, consultez le [guide de EventBridge l'utilisateur Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/). ## Envoi de notifications à Amazon SQS et Amazon SNS Vous pouvez utiliser 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 contenue dans la *référence d'API du SDK Amazon Chime pour envoyer des notifications* d'événements de réunion du SDK Amazon Chime à une file d'attente Amazon SQS et à un sujet Amazon SNS par réunion. Cela peut contribuer à réduire le temps de latence des notifications. Pour plus d'informations sur Amazon SQS, consultez le [Guide du développeur Amazon Simple Queue Service](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/). Pour plus d’informations sur Amazon SNS, consultez le [Manuel de développement d’Amazon Simple Notification Service](https://docs.aws.amazon.com/sns/latest/dg/). Les notifications envoyées à Amazon SQS et Amazon SNS contiennent les mêmes informations que les notifications envoyées par le SDK Amazon Chime. EventBridge Le SDK Amazon Chime permet d'envoyer des notifications d'événements de réunion aux files d'attente et aux sujets de la région API utilisée pour créer une réunion. Les notifications d'événements peuvent être envoyées par ordre d'occurrence. ## Octroi de l'accès du SDK Amazon Chime à Amazon SQS et Amazon SNS Avant que le SDK Amazon Chime puisse vous envoyer des notifications via une file d'attente Amazon SQS ou une rubrique Amazon SNS, vous devez autoriser le SDK Amazon Chime à publier des messages sur le nom de ressource Amazon (ARN) de la file d'attente ou du sujet. Pour ce faire, attachez une politique Gestion des identités et des accès AWS (IAM) à la file d'attente ou à la rubrique qui accorde les autorisations appropriées au SDK Amazon Chime. Pour plus d'informations, consultez la section [Gestion des identités et des accès dans Amazon SQS](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-authentication-and-access-control.html) dans le *guide du développeur Amazon Simple Queue Service* et des [exemples de cas de contrôle d'accès Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/sns-access-policy-use-cases.html) dans le manuel du développeur *Amazon Simple Notification* Service. **Note** Votre file d'attente Amazon SQS ou votre rubrique Amazon SNS doivent utiliser la AWS même région que le point de terminaison de l'API du SDK Amazon Chime. **Example Autoriser le SDK Amazon Chime à publier des événements dans une file d'attente Amazon SQS** L'exemple de politique IAM suivant accorde au SDK Amazon Chime l'autorisation de publier des notifications d'événements de réunion dans la file d'attente Amazon SQS spécifiée. Notez l'énoncé conditionnel pour `aws:SourceArn` et`aws:SourceAccount`. Ils abordent les problèmes potentiels liés à la [confusion des adjoints](https://docs.aws.amazon.com/IAM/latest/UserGuide/confused-deputy.html). + Vous pouvez utiliser `aws:SourceArn` ou `aws:SourceAccount` lors de la création des politiques ci-dessous. Vous n'avez pas besoin d'utiliser les deux. + Ces exemples utilisent l'espace de `ChimeSDKMeetings` noms et le point de terminaison correspondant. Si vous utilisez l'espace de `Chime` noms, vous devez utiliser le `chime.amazonaws.com` point de terminaison. **** ``` { "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" } } } ] } ``` Cet exemple montre une politique Amazon SNS qui permet au SDK Amazon Chime d'envoyer des notifications d'événements de réunion à votre rubrique 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" } } } ] } ``` Si la file d'attente Amazon SQS est activée pour le chiffrement côté serveur (SSE), vous devez effectuer une étape supplémentaire. Associez une politique IAM à la AWS KMS clé associée qui autorise le SDK Amazon Chime à effectuer les actions nécessaires pour chiffrer AWS KMS les données ajoutées à la file d'attente. **** ``` { "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 Autoriser le SDK Amazon Chime à publier des événements sur une rubrique Amazon SNS** L'exemple de politique IAM suivant accorde au SDK Amazon Chime l'autorisation de publier des notifications d'événements de réunion sur la rubrique Amazon SNS spécifiée. **** ``` { "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" } } } ] } ``` # Migration depuis l'espace de noms Amazon Chime Le SDK Amazon Chime expose un ensemble de points de APIs terminaison. Bien que vous puissiez envoyer des requêtes HTTPS directement aux terminaux, de nombreux clients utilisent le AWS SDK dans leurs applications pour appeler le service. APIs Le AWS SDK est disponible dans différentes langues et simplifie les appels d'API en encapsulant la logique de signature et de nouvelle tentative des demandes. Le AWS SDK inclut un espace de noms pour chaque point de terminaison de service. Lors de son lancement initial, le SDK Amazon Chime partageait un seul point de terminaison avec l'application Amazon Chime. Par conséquent, les solutions ont utilisé l'`Chime`espace de noms du AWS SDK pour appeler l'application Amazon Chime et le SDK Amazon Chime. APIs Le SDK Amazon Chime fournit désormais des points de terminaison dédiés pour chaque sous-service, tels que les réunions et le son PSTN. Chaque point de terminaison est adressable via un espace de noms dédié dans le AWS SDK. Les rubriques suivantes répertorient les services, les espaces de noms et les points de terminaison, et décrivent comment les utiliser dans le code et avec la CLI AWS . **Topics** + [Points de terminaison, espaces de noms et commandes CLI](#endpoint-namespace-cli) + [Aide à la migration pour chaque service](#help-per-service) + [Cartographie des API](#name-end-map) ## Points de terminaison, espaces de noms et commandes CLI Le tableau suivant répertorie les espaces de noms, les points de terminaison et les commandes CLI dédiés au SDK Amazon Chime. Les liens permettent d'accéder à de plus amples informations sur chaque service. | Point de terminaison | AWS Espace de noms du SDK | AWS CLI du SDK | | --- | --- | --- | | [carillon d'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) | Canalisations Chime 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) | | [carillon de réunions](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) | | [carillon de messagerie](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) | | [carillon vocal](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) | ## Aide à la migration pour chaque service Tous les clients devraient envisager d'utiliser les points de terminaison dédiés du SDK Amazon Chime pour accéder aux dernières fonctionnalités et régions du SDK Amazon Chime. APIs AWS Si vous utilisez le point de terminaison partagé avec l'espace de `Chime` noms, les guides de migration suivants peuvent vous aider à comprendre les différences techniques avant de procéder à la migration. + [Migration vers l'espace de noms Amazon Chime SDKIdentity ](identity-namespace-migration.md) + [Migration vers l'espace de noms Amazon SDKMedia Chime Pipelines](migrate-pipelines.md) + [Migration vers l'espace de noms Amazon Chime SDKMeetings ](meeting-namespace-migration.md) + [Migration vers l'espace de noms Amazon Chime SDKMessaging ](messaging-namespace-migration.md) + [Migration vers l'espace de noms Amazon Chime SDKVoice ](voice-namespace-migration.md) ## Cartographie des API Le tableau suivant répertorie les espaces de noms APIs présents dans l'espace de `Chime` noms, ainsi que les espaces de noms dédiés correspondants et. APIs Certaines des instances dédiées APIs diffèrent des `Chime` APIs, et le tableau indique ces instances. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/chime-sdk/latest/dg/migrate-from-chm-namespace.html) **\$1** L'API a été remplacée par une API portant un autre nom. **\$1** L'API n'est plus disponible.