Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich. # Verwenden des Amazon Chime SDK Sie verwenden das Amazon Chime SDK, um Medienanwendungen in Echtzeit zu erstellen, die Audio und Video senden und empfangen und Inhalte teilen können. Das Amazon Chime SDK funktioniert unabhängig von allen Amazon Chime-Administratorkonten und hat keine Auswirkungen auf Amazon Chime gehostete Besprechungen. Stattdessen bietet das Amazon Chime SDK Builder-Tools, mit denen Sie Ihre eigenen Meeting-Anwendungen erstellen können. **Topics** + [Voraussetzungen für die Verwendung des Amazon Chime SDK](#mtg-prereqs) + [Konzepte für das Amazon Chime SDK](#mtg-glossary) + [Architektur für das Amazon Chime SDK](#mtg-arch) + [Kontingente für das Amazon Chime SDK](#mtg-limits) + [Amazon Chime SDK-Systemanforderungen](#mtg-browsers) + [Verfügbare AWS-Regionen für das Amazon Chime SDK](sdk-available-regions.md) + [Erfahren Sie mehr über die Amazon Chime SDK-Clientbibliotheken](mtgs-sdk-client-lib.md) + [Grundlegendes zur SIP-Integration mit einem Amazon Chime SDK Voice Connector](mtgs-sdk-cvc.md) + [Grundlegendes zu Amazon Chime SDK-Ereignisbenachrichtigungen](mtgs-sdk-notifications.md) + [Migration aus dem Amazon Chime Chime-Namespace](migrate-from-chm-namespace.md) ## Voraussetzungen für die Verwendung des Amazon Chime SDK Für die Verwendung des Amazon Chime SDK ist Folgendes erforderlich: + Die Fähigkeit zu programmieren. + Ein AWS Konto. + **Eine IAM-Rolle mit einer Richtlinie, die Zugriff auf Amazon Chime-API-Aktionen gewährt, die vom Amazon Chime SDK verwendet werden, wie z. B. die AWS verwaltete AmazonChime SDK-Richtlinie.** Weitere Informationen finden Sie unter [So funktioniert Amazon Chime mit IAM](https://docs.aws.amazon.com/chime-sdk/latest/ag/security_iam_service-with-iam.html) und [Benutzern den Zugriff auf Amazon Chime SDK-Aktionen ermöglichen im Amazon Chime *SDK-Administratorhandbuch*](https://docs.aws.amazon.com/chime-sdk/latest/ag/security_iam_id-based-policy-examples.html#security_iam_id-based-policy-examples-chime-sdk). + Für die meisten Anwendungsfälle benötigen Sie außerdem Folgendes: + Eine **Serveranwendung** — Verwaltet Besprechungs- und Teilnehmerressourcen und stellt diese Ressourcen der Client-Anwendung zur Verfügung. Die Serveranwendung wird im AWS Konto erstellt und muss Zugriff auf die zuvor erwähnte IAM-Rolle haben. + Eine **Client-Anwendung** — Empfängt Besprechungs- und Teilnehmerinformationen von der Serveranwendung und verwendet diese Informationen, um Medienverbindungen herzustellen. ## Konzepte für das Amazon Chime SDK Die folgenden Begriffe und Konzepte sind für das Verständnis der Verwendung des Amazon Chime SDK von zentraler Bedeutung. **meeting** Eine kurzlebige Ressource, die durch ein Unikat identifiziert wird. `MeetingId` Die `MeetingId` wird einer Gruppe von Mediendiensten zugeordnet, die das aktive Meeting veranstalten. **Mediendienstgruppe** Die Gruppe von Mediendiensten, die ein aktives Meeting veranstaltet. **Platzierung in den Medien** Eine Reihe von regionalisierten URLs , die eine Mediendienstgruppe darstellen. Die Teilnehmer stellen mit ihren Kunden eine Verbindung zur Media Service Group her, um Audio- und Videodaten in Echtzeit zu senden und zu empfangen und ihre Bildschirme gemeinsam zu nutzen. **Teilnehmer** Ein Besprechungsteilnehmer, der durch einen eindeutigen `AttendeeId` Namen identifiziert wird. Teilnehmer können mithilfe einer Client-Anwendung, die mit einer Amazon Chime SDK-Clientbibliothek erstellt wurde, frei an Besprechungen teilnehmen und sie verlassen. **Token beitreten** Ein eindeutiges Token, das jedem Teilnehmer zugewiesen wird. Die Teilnehmer verwenden das Join-Token, um sich bei der Media Service Group zu authentifizieren. ## Architektur für das Amazon Chime SDK In der folgenden Liste wird beschrieben, wie die verschiedenen Komponenten der Amazon Chime SDK-Architektur zusammenarbeiten, um Besprechungen und Teilnehmer, Audio-, Video- und Inhaltsfreigabe zu unterstützen. **Besprechungen und Teilnehmer** Wenn die Serveranwendung ein Amazon Chime SDK-Meeting erstellt, wird das Meeting einem regionsspezifischen Medienservice zugewiesen. Die Hosts im Service sind für die sichere Übertragung von Medien in Echtzeit zwischen den Kunden der Teilnehmer verantwortlich. Jedem erstellten Teilnehmer wird ein eindeutiges Teilnahme-Token zugewiesen, ein undurchsichtiger geheimer Schlüssel, den Ihre Serveranwendung sicher an den Client übertragen muss, der berechtigt ist, im Namen eines Teilnehmers an der Besprechung teilzunehmen. Jeder Client verwendet ein Beitrittstoken, um sich bei der Mediendienstgruppe zu authentifizieren. Clients verwenden eine Kombination aus Secure WebSockets und Datagram Transport Layer Security (DTLS), um die Media Service Group sicher zu signalisieren und Medien über die Media Service Group an und von anderen Teilnehmern zu senden und von ihnen zu empfangen. **Audio** Der Mediendienst mischt Audio von jedem Teilnehmer zusammen und sendet den Mix an jeden Empfänger, nachdem er sein eigenes Audio vom Mix abgezogen hat. Amazon Chime nimmt SDKs Audio mit der höchsten vom Gerät und vom Browser unterstützten Rate ab, bis zu einem Maximum von 48 kHz. Wir verwenden den Opus-Codec zur Audiokodierung mit einer Standardbitrate von 32 kbit/s, die auf bis zu 128 kbit/s Stereo und 64 kbit/s mono erhöht werden kann. **Video** Der Mediendienst fungiert als Selective Forwarding Unit (SFU) und verwendet ein Veröffentlichungs- und Abonnementmodell. Jeder Teilnehmer kann eine Videoquelle veröffentlichen, also insgesamt bis zu 25 Videos gleichzeitig pro Sitzung. Die Amazon Chime SDK-Clientbibliothek für JavaScript unterstützt Videoauflösungen von bis zu 1280 x 720 bei 30 Bildern pro Sekunde ohne Simulcast und 15 Bildern pro Sekunde mit Simulcast. Die Amazon Chime SDK-Clientbibliotheken für [iOS](sdk-for-ios.md), [Android](sdk-for-android.md) und [Windows](client-lib-windows.md) unterstützen Videoauflösungen von bis zu 1280 x 720 und 30 Bildern pro Sekunde. Die tatsächliche Bildrate und Auflösung werden jedoch automatisch vom Amazon Chime SDK verwaltet. Wenn diese Option aktiviert ist, sendet Video-Simulcast jeden Videostream in zwei verschiedenen Auflösungen und Bitraten. Clients mit Bandbreitenbeschränkungen abonnieren automatisch den Stream mit niedrigerer Bitrate. Bei der Videokodierung und -dekodierung wird, soweit verfügbar, Hardwarebeschleunigung verwendet, um die Leistung zu verbessern. **Datennachrichten** Zusätzlich zu Audio- und Videoinhalten können sich Besprechungsteilnehmer gegenseitig Echtzeit-Datennachrichten mit einer Größe von jeweils bis zu 2 KB senden. Sie können Nachrichten verwenden, um benutzerdefinierte Meeting-Funktionen wie Whiteboarding, Chat, Emoji-Reaktionen in Echtzeit und anwendungsspezifische Bodenkontrollsignale zu implementieren. **Teilen von Inhalten** Die Client-Anwendung kann Audio- und Videoinhalte wie Bildschirmaufnahmen oder Mediendateien gemeinsam nutzen. Die gemeinsame Nutzung von Inhalten unterstützt aufgezeichnete Videos mit bis zu 1280 x 720 bei 15 Bildern pro Sekunde und Audio mit bis zu 48 kHz bei 64 Kbit/s. Die Bildschirmaufnahme für die gemeinsame Nutzung von Inhalten wird mit bis zu 15 Bildern pro Sekunde unterstützt, kann jedoch durch die Funktionen des Geräts und des Browsers eingeschränkt sein. ## Kontingente für das Amazon Chime SDK Die Kontingente für den Amazon Chime SDK-Service sind in der Allgemeine AWS-Referenz dokumentiert. Weitere Informationen finden Sie unter [Amazon Chime SDK-Endpunkte und Kontingente](https://docs.aws.amazon.com/general/latest/gr/chime-sdk.html) in der. *Allgemeine AWS-Referenz* **Anmerkung** Service-Kontingente gelten pro API-Endpunkt. Wenn Sie eine Erhöhung der Servicequote beantragen, stellen Sie sicher, dass Sie die Erhöhung für alle API-Endpunkte beantragen, die Ihre Anwendung verwendet. ## Amazon Chime SDK-Systemanforderungen Die folgenden Systemanforderungen gelten für Anwendungen, die mit dem Amazon Chime SDK erstellt wurden. **Unterstützte Browser, Amazon Chime SDK-Clientbibliothek für JavaScript** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/chime-sdk/latest/dg/meetings-sdk.html) **Amazon Chime SDK-Clientbibliothek für iOS** + iOS Version 13 und höher **Amazon Chime SDK-Clientbibliothek für Android** + Android OS Version 5 und höher, ARM und Architektur ARM64 # Verfügbare AWS-Regionen für das Amazon Chime SDK In den folgenden Tabellen sind die Funktionen des Amazon Chime SDK-Service und die AWS Regionen aufgeführt, in denen die einzelnen Services bereitgestellt werden. **Anmerkung** Mit einem Sternchen (**\$1**) markierte Regionen müssen in Ihrem AWS Konto aktiviert sein. AWS blockiert diese Regionen standardmäßig. Weitere Informationen zur Aktivierung von Regionen finden [Sie unter „Geben Sie an, welche AWS Regionen Ihr Konto verwenden kann](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-regions.html)“ in der *Referenz zur AWS Kontoverwaltung*. **Topics** + [Regionen in der Konsole](#sdk-console-regions) + [Rufen Sie Analytics Regions auf](#call-analytics-regions) + [Regionen treffen](#sdk-meeting-regions) + [Regionen in der Medien-Pipeline](#sdk-media-pipelines) + [Messaging-Regionen](#sdk-messaging-regions) + [Sprachregionen](#voice-regions) ## Regionen in der Konsole Sie verwenden die Amazon Chime SDK-Konsole, um Ressourcen zu konfigurieren und mehr über den Amazon Chime SDK-Service zu erfahren. | **AWS Region** | **Konsole** | | --- | --- | | Asien-Pazifik (Seoul) | Ja | | Asien-Pazifik (Singapore) | Ja | | Asien-Pazifik (Sydney) | Ja | | Asien-Pazifik (Tokyo) (ap-northeast-1) | Ja | | Kanada (Zentral): (ca-central-1) | Ja | | Europa (Frankfurt) (eu-central-1) | Ja | | Europa (Irland) (eu-west-1) | Ja | | Europa (London) (eu-west-2) | Ja | | USA Ost (Nord-Virginia): (us-east-1) | Ja | | USA West (Oregon): (us-west-2) | Ja | ## Rufen Sie Analytics Regions auf In der folgenden Tabelle sind die AWS Regionen aufgeführt, die für Analysen, Transkription und Anrufaufzeichnung verfügbar sind. | **AWS Region** | **Sprachanalyse** | **Transkription** | **Aufzeichnung von Anrufen** | | --- | --- | --- | --- | | USA Ost (Nord-Virginia): (us-east-1) | Ja | Ja | Ja | | USA West (Oregon): (us-west-2) | Ja | Ja | Ja | | Europa (Frankfurt) (eu-central-1) | Nein | Ja | Ja | ## Regionen treffen Amazon Chime SDK-Meetings haben *Kontrollregionen* und *Medienregionen*. Eine Kontrollregion stellt den API-Endpunkt bereit, der zum Erstellen, Aktualisieren und Löschen von Besprechungen verwendet wird. Kontrollregionen empfangen und verarbeiten ebenfalls[Grundlegendes zu den Ereignissen im Lebenszyklus von Besprechungen im Amazon Chime SDK](using-events.md). In den Medienregionen finden die eigentlichen Besprechungen statt, und Kunden stellen eine Verbindung zu Ihren Medienregionen her. Sie geben die Medienregion an, wenn Sie die [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 aufrufen. Eine Kontrollregion kann ein Meeting in jeder Medienregion in derselben AWS Partition erstellen. Sie können ein Meeting jedoch nur in der Kontrollregion aktualisieren, in der das Meeting erstellt wurde. Weitere Informationen zur Auswahl von Kontroll- und Medienregionen finden Sie unter[Verwenden von Meeting-Regionen für Amazon Chime SDK-Besprechungen](chime-sdk-meetings-regions.md). In der folgenden Tabelle sind die Regionen aufgeführt, die Steuerung, Medien oder beides bieten. | **AWS Region** | **Steuerung von Besprechungen** | **Medien treffen** | | --- | --- | --- | | **Afrika (Kapstadt) (af-south-1) \$1** | Ja \$1\$1 | Ja | | Asien-Pazifik (Mumbai): (ap-south-1) | Ja | Ja | | Asien-Pazifik (Seoul): (ap-northeast-2) | Ja | Ja | | Asien-Pazifik (Singapur): (ap-southeast-1) | Ja | Ja | | Asien-Pazifik (Sydney): (ap-southeast-2) | Ja | Ja | | Asien-Pazifik (Tokyo) (ap-northeast-1) | Ja | Ja | | Kanada (Zentral): (ca-central-1) | Ja | Ja | | Europa (Frankfurt) (eu-central-1) | Ja | Ja | | Europa (Irland) (eu-west-1) | | Ja | | Europa (London) (eu-west-2) | Ja | Ja | | **Europa (Mailand) (eu-south-1) \$1** | | Ja | | Europa (Paris) (eu-west-3) | | Ja | | Europa (Stockholm) (eu-north-1) | | Ja | | **Israel (Tel Aviv) il-central-1) \$1** | **Ja** \$1\$1 | Ja | | Südamerika (São Paulo) (sa-east-1) | | Ja | | USA Ost (Ohio): (us-east-2) | | Ja | | USA Ost (Nord-Virginia): (us-east-1) | Ja | Ja | | USA West (Nordkalifornien) (us-west-1) | | Ja | | USA West (Oregon): (us-west-2) | Ja | Ja | | AWS GovCloud (US-Ost) (us-gov-east-1) | Ja | Ja | | AWS GovCloud (US-West) (us-gov-west-1) | Ja | Ja | **\$1** Sie müssen diese Regionen in Ihrem AWS Konto aktivieren. Weitere Informationen finden Sie unter [Region aktivieren](https://docs.aws.amazon.com/general/latest/gr/rande-manage.html#rande-manage-enable) in der *AWS allgemeinen Referenz*. **\$1\$1** Bei Meetings, bei denen die Meetingsteuerung in dieser Region verwendet wird, können nur Medien in dieser Region gehostet werden. **Anmerkung** Um ein Meeting in einer Region AWS GovCloud (USA) zu erstellen, müssen Sie eine Kontrollregion in verwenden GovCloud. Außerdem GovCloud können mit der Option „Regionen in“ nur Besprechungen in Regionen AWS GovCloud (USA) abgehalten werden. ## Regionen in der Medien-Pipeline Amazon Chime SDK-Medien-Pipelines haben *Kontrollregionen* und *Medienregionen*. Eine Kontrollregion stellt den API-Endpunkt für die Medienpipeline bereit, der zum Erstellen und Löschen von Medien-Pipelines verwendet wird. Sie verwenden Kontrollregionen auch, um [Medien-Pipeline-Ereignisse](media-pipe-events.md) zu empfangen und zu verarbeiten. Medienregionen verwalten Ihre Medien-Pipelines, und das System wählt automatisch dieselbe Medienregion wie das Meeting aus. Sie können eine Steuerregion verwenden, um eine Medienpipeline in einer beliebigen Datenregion zu erstellen. Die Medienpipeline kann an einer Besprechung in einer beliebigen Medienregion teilnehmen. | **AWS Region** | **Kontrolle** | **Medien** | | --- | --- | --- | | **Afrika (Kapstadt) (af-south-1) \$1** | | Ja | | Asien-Pazifik (Mumbai): (ap-south-1) | Ja | Ja | | Asien-Pazifik (Seoul): (ap-northeast-2) | Ja | Ja | | Asien-Pazifik (Singapur): (ap-southeast-1) | Ja | Ja | | Asien-Pazifik (Sydney): (ap-southeast-2) | Ja | Ja | | Asien-Pazifik (Tokyo) (ap-northeast-1) | Ja | Ja | | Kanada (Zentral): (ca-central-1) | Ja | Ja | | Europa (Frankfurt) (eu-central-1) | Ja | Ja | | Europa (Irland) (eu-west-1) | | Ja | | Europa (London) (eu-west-2) | Ja | Ja | | **Europa (Mailand) (eu-south-1) \$1** | | Ja | | Europa (Paris) (eu-west-3) | | Ja | | Europa (Stockholm) (eu-north-1) | | Ja | | Südamerika (São Paulo) (sa-east-1) | | Ja | | USA Ost (Ohio): (us-east-2) | | Ja | | USA Ost (Nord-Virginia): (us-east-1) | Ja | Ja | | USA West (Nordkalifornien) (us-west-1) | | Ja | | USA West (Oregon): (us-west-2) | Ja | Ja | **\$1** Sie müssen diese Regionen in Ihrem AWS Konto aktivieren. Weitere Informationen finden Sie unter [Region aktivieren](https://docs.aws.amazon.com/general/latest/gr/rande-manage.html#rande-manage-enable) in der *AWS allgemeinen Referenz*. ## Messaging-Regionen Amazon Chime SDK-Messaging hat *Kontrollregionen* und *Datenregionen*. Die Kontrollregion macht den Messaging-API-Endpunkt verfügbar, und die Datenregion speichert die Nachrichten. Wenn Sie Amazon Kinesis zum Streamen von Messaging-Daten oder AWS Lambda Funktionen für Kanalflüsse verwenden, sollten sich diese in der Kontrollregion befinden. | **AWS Region** | **Kontrolle** | **Daten** | | --- | --- | --- | | Europa (Frankfurt) (eu-central-1) | Ja | Ja | | USA Ost (Nord-Virginia): (us-east-1) | Ja | Ja | ## Sprachregionen Die SIP-Funktionen (Session Initiation Protocol) des Amazon Chime SDK verfügen über *API-Regionen* und *Medienregionen* sowie *PSTN-Regionen*. Die API-Regionen stellen die API-Endpunkte für die Erstellung und Konfiguration von SIP-Funktionen bereit. Die Medienregionen enthalten Amazon Chime SDK Voice Connectors und SIP-Medienanwendungen. Die PSTN-Regionen ermöglichen es Kunden, lokale Telefonsysteme mit dem öffentlichen Telefonnetz zu verbinden. Darüber hinaus unterstützen PSTN-Regionen die Bereitstellung und Verwaltung von Telefonnummern. | **AWS Region** | **API** | **Medien** | **PSTN** | | --- | --- | --- | --- | | Asien-Pazifik (Seoul): (ap-northeast-2) | Ja | Ja | | | Asien-Pazifik (Singapur): (ap-southeast-1) | Ja | Ja | | | Asien-Pazifik (Sydney): (ap-southeast-2) | Ja | Ja | | | Asien-Pazifik (Tokyo) (ap-northeast-1) | Ja | Ja | | | Kanada (Zentral): (ca-central-1) | Ja | Ja | | | Europa (Frankfurt) (eu-central-1) | Ja | Ja | | | Europa (Irland) (eu-west-1) | Ja | Ja | | | Europa (London) (eu-west-2) | Ja | Ja | | | USA Ost (Nord-Virginia): (us-east-1) | Ja | Ja | **Ja \$1** | | USA West (Oregon): (us-west-2) | Ja | Ja | Ja **\$1** | **\$1** Informationen zur Verfügbarkeit von Telefonnummern in bestimmten AWS Regionen finden Sie auf der Seite mit den [Amazon Chime SDK-Preisen](https://aws.amazon.com/chime/chime-sdk/pricing/). # Erfahren Sie mehr über die Amazon Chime SDK-Clientbibliotheken Bevor Sie Echtzeit-Meeting-Clients mit dem Amazon Chime SDK erstellen können, müssen Sie Ihre Client-Anwendung in eine Amazon Chime SDK-Clientbibliothek integrieren. Die folgenden Client-Bibliotheken sind verfügbar: + [Amazon Chime SDK-Clientbibliothek für Android](https://github.com/aws/amazon-chime-sdk-android) — Eine Kotlin-Bibliothek, mit der Sie Amazon Chime SDK-Anwendungen auf unterstützten Android-Geräten erstellen können. + [Amazon Chime SDK Signaling Client Library für C\$1\$1](https://github.com/aws/amazon-chime-sdk-cpp/tree/main/chime-sdk-signaling-cpp) — Eine C\$1\$1-Bibliothek, mit der Sie Signalverbindungen zu Amazon Chime SDK-Meetings auf eingebetteten Geräten einrichten können. + [Amazon Chime SDK-Clientbibliothek für iOS](https://github.com/aws/amazon-chime-sdk-ios) — Eine Swift-Bibliothek, mit der Sie Amazon Chime SDK-Anwendungen auf unterstützten iOS-Geräten erstellen können. + [Amazon Chime SDK-Clientbibliothek für JavaScript](https://github.com/aws/amazon-chime-sdk-js) ([NPM](https://www.npmjs.com/package/amazon-chime-sdk-js)) — Eine JavaScript Bibliothek mit TypeScript Typdefinitionen, mit der Sie Amazon Chime SDK-Anwendungen in WebRTC-fähigen Browsern erstellen können. + [Amazon Chime SDK-Clientbibliothek für Windows](https://github.com/aws/amazon-chime-sdk-cpp). Eine C\$1\$1-Bibliothek, mit der Sie Amazon Chime SDK-Anwendungen auf unterstützten Geräten erstellen können. Informationen zur Integration Ihrer Client-Anwendung in das Amazon Chime SDK finden Sie in den Aktionen in den `README.md` Client-Bibliotheksdateien. In den Demos erfahren Sie, wie Sie spezifische Medienkomponenten für Ihre Anwendung erstellen. # Grundlegendes zur SIP-Integration mit einem Amazon Chime SDK Voice Connector Integrieren Sie Ihre SIP-kompatible Sprachinfrastruktur mit einem Amazon Chime SDK Voice Connector, um SIP-Sprachanrufe zu tätigen. Sie müssen die Regionen oder verwenden. `us-east-1` `us-east-2` Sie benötigen eine IP-PBX (Private Branch Exchange), einen Session Border Controller (SBC) oder eine andere Sprachinfrastruktur mit Internetzugang, die das Session Initiation Protocol (SIP) unterstützt. Weitere Informationen finden Sie unter [Bevor Sie beginnen](https://docs.aws.amazon.com/chime-sdk/latest/ag/voice-connectors.html#vc-prereq) im *Amazon Chime SDK-Administratorhandbuch*. **Um Ihre Sprachinfrastruktur zu integrieren** 1. Erstellen Sie einen Amazon Chime SDK Voice Connector unter Ihrem AWS Konto. Weitere Informationen finden Sie unter [Erstellen eines Amazon Chime SDK Voice Connectors](https://docs.aws.amazon.com/chime-sdk/latest/ag/voice-connectors.html#create-voicecon) im *Amazon Chime SDK-Administratorhandbuch*. 1. Bearbeiten Sie Ihre Amazon Chime SDK Voice Connector-Einstellungen, um Anrufe von Ihrer Sprachinfrastruktur aus zu AWS ermöglichen. Weitere Informationen finden Sie unter [Bearbeiten der Amazon Chime SDK Voice Connector-Einstellungen](https://docs.aws.amazon.com/chime-sdk/latest/ag/voice-connectors.html#edit-voicecon) im *Amazon Chime SDK-Administratorhandbuch*. 1. **Wählen Sie für die **Einstellungen zur Kündigung die** Option Aktiviert aus.** 1. Wählen Sie **für Zulassungsliste** die Option **Neu** aus. 1. Geben Sie die CIDR-Notationen der IP-Adressen für Ihre interne SIP-Infrastruktur ein. Dadurch kann Ihre Infrastruktur auf den Amazon Chime SDK Voice Connector zugreifen. Um beispielsweise Datenverkehr von einer IP-Adresse zuzulassen, sollten Sie die `10.24.34.0` CIDR-Notation auf die Allowlist setzen. `10.24.34.0/32` 1. Wählen Sie **Hinzufügen** aus. 1. Wählen Sie für **Calling plan (Anrufplan)** die Länder aus, die dem Plan hinzugefügt werden sollen. 1. **Bearbeiten Sie alle anderen Einstellungen nach Bedarf und wählen Sie Speichern.** 1. Sehen Sie sich in der Amazon Chime SDK-Konsole unter **Voice Connectors** den **Namen des ausgehenden Hosts** für Ihren Amazon Chime SDK Voice Connector an. Zum Beispiel .voiceconnector.chime.aws. *abcdef1ghij2klmno3pqr4* 1. Um mit dem Amazon Chime SDK an einem Meeting teilzunehmen, verwenden Sie eine SIP-URI, um eine SIP-Anfrage an den **ausgehenden Hostnamen** Ihres Amazon Chime SDK Voice Connectors zu stellen. Verwenden Sie die Telefonnummer **\$117035550122** in der SIP-URI. Stellen Sie den `transport` Parameter ein, um das TLS-Protokoll zu verwenden. Verwenden Sie abschließend das eindeutige Join-Token, das durch den Aufruf von generiert wurde [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)API-Aktion. Weitere Informationen finden Sie im folgenden Beispiel. **Example Beispiel: SIP-Anfrage** Das folgende Beispiel zeigt den Inhalt einer SIP-URI, die verwendet wird, um eine SIP-Anfrage an einen Amazon Chime SDK Voice Connector zu stellen. ``` sip:+17035550122@abcdef1ghij2klmno3pqr4.voiceconnector.chime.aws;transport=tls;X-chime-join-token=join-token ``` Das folgende Beispiel zeigt ein Beispiel für eine SIP INVITE-Nachricht zur Teilnahme an einem Amazon Chime SDK-Meeting. ``` 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 ``` **Anmerkung** Das Amazon Chime SDK erkennt Telefonnummern nur im E.164-Format. Stellen Sie sicher, dass sich eine E.164-Telefonnummer in Ihrem Header befindet. `From` # Grundlegendes zu Amazon Chime SDK-Ereignisbenachrichtigungen Das Amazon Chime SDK unterstützt das Senden von Benachrichtigungen über Besprechungsereignisse an Amazon EventBridge, Amazon Simple Queue Service (SQS) und Amazon Simple Notification Service (SNS). **Anmerkung** Der standardmäßige Amazon Chime SDK-Namespace für Besprechungen verwendet die `ChimeSDKMeetings` Endpunkte. Der ältere Chime-Namespace verwendet einen einzigen Endpunkt. Weitere Informationen zu den Namespaces und Endpunkten finden Sie weiter oben in diesem Handbuch. [Migration zum Amazon Chime SDK-Namespace für Besprechungen](meeting-namespace-migration.md) ## Senden von Benachrichtigungen an EventBridge Sie können Amazon Chime SDK-Ereignisbenachrichtigungen an EventBridge senden. Ausführliche Informationen zur Verwendung des Amazon Chime SDK mit EventBridge finden Sie unter [Automatisieren des Amazon Chime SDK mit EventBridge im Amazon Chime *SDK-Administratorhandbuch*](https://docs.aws.amazon.com/chime-sdk/latest/ag/automating-chime-with-cloudwatch-events.html#events-sdk). Informationen dazu EventBridge finden Sie im [ EventBridge Amazon-Benutzerhandbuch](https://docs.aws.amazon.com/eventbridge/latest/userguide/). ## Senden von Benachrichtigungen an Amazon SQS und Amazon SNS Sie können die [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 in der *Amazon Chime SDK API-Referenz verwenden, um Amazon Chime SDK-Besprechungsereignisbenachrichtigungen* an eine Amazon SQS SQS-Warteschlange und ein Amazon SNS SNS-Thema pro Meeting zu senden. Dies kann dazu beitragen, die Latenz bei Benachrichtigungen zu reduzieren. Weitere Informationen zu Amazon SQS, finden Sie unter [Entwicklerhandbuch für Amazon Simple Queue Service](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/). Weitere Informationen zu Amazon SNS finden Sie im [Amazon-Simple-Notification-Service-Entwicklerhandbuch](https://docs.aws.amazon.com/sns/latest/dg/). Die an Amazon SQS und Amazon SNS gesendeten Benachrichtigungen enthalten dieselben Informationen wie die Benachrichtigungen, an die das Amazon Chime SDK sendet. EventBridge Das Amazon Chime SDK unterstützt das Senden von Benachrichtigungen über Besprechungsereignisse an Warteschlangen und Themen in der API-Region, die zur Erstellung eines Meetings verwendet wurde. Event-Benachrichtigungen werden möglicherweise in der Reihenfolge ihres Auftretens zugestellt. ## Gewähren des Amazon Chime SDK-Zugriffs auf Amazon SQS und Amazon SNS Bevor das Amazon Chime SDK Ihnen Benachrichtigungen über eine Amazon SQS SQS-Warteschlange oder ein Amazon SNS SNS-Thema senden kann, müssen Sie dem Amazon Chime SDK die Erlaubnis erteilen, Nachrichten im Amazon Resource Name (ARN) der Warteschlange oder des Themas zu veröffentlichen. Fügen Sie dazu der Warteschlange oder dem Thema eine AWS Identity and Access Management (IAM-) Richtlinie hinzu, die dem Amazon Chime SDK die entsprechenden Berechtigungen gewährt. Weitere Informationen finden Sie unter [Identitäts- und Zugriffsverwaltung in Amazon SQS](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-authentication-and-access-control.html) im *Amazon Simple Queue Service Developer Guide* und [Beispielfälle für Amazon SNS SNS-Zugriffskontrolle](https://docs.aws.amazon.com/sns/latest/dg/sns-access-policy-use-cases.html) im *Amazon Simple Notification Service Developer* Guide. **Anmerkung** Ihre Amazon SQS SQS-Warteschlange oder Ihr Amazon SNS SNS-Thema müssen dieselbe AWS Region verwenden wie Ihr Amazon Chime SDK-API-Endpunkt. **Example Erlauben Sie dem Amazon Chime SDK, Ereignisse in einer Amazon SQS SQS-Warteschlange zu veröffentlichen** Die folgende Beispiel-IAM-Richtlinie erteilt dem Amazon Chime SDK die Erlaubnis, Benachrichtigungen über Besprechungsereignisse in der angegebenen Amazon SQS SQS-Warteschlange zu veröffentlichen. Beachten Sie die bedingte Anweisung für und. `aws:SourceArn` `aws:SourceAccount` Sie befassen sich mit potenziellen Problemen [mit Confused Deputy](https://docs.aws.amazon.com/IAM/latest/UserGuide/confused-deputy.html). + Sie können `aws:SourceArn` oder verwenden`aws:SourceAccount`, wenn Sie die folgenden Richtlinien erstellen. Sie müssen nicht beide verwenden. + In diesen Beispielen werden der `ChimeSDKMeetings` Namespace und der entsprechende Endpunkt verwendet. Wenn Sie den `Chime` Namespace verwenden, müssen Sie den `chime.amazonaws.com` Endpunkt verwenden. **** ``` { "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" } } } ] } ``` Dieses Beispiel zeigt eine Amazon SNS SNS-Richtlinie, die es dem Amazon Chime SDK ermöglicht, Benachrichtigungen über Besprechungsereignisse an Ihr SNS-Thema zu senden. **** ``` { "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" } } } ] } ``` Wenn die Amazon SQS SQS-Warteschlange für serverseitige Verschlüsselung (SSE) aktiviert ist, müssen Sie einen zusätzlichen Schritt ausführen. Fügen Sie dem zugehörigen AWS KMS Schlüssel eine IAM-Richtlinie hinzu, die dem Amazon Chime SDK die Berechtigung für die AWS KMS Aktionen erteilt, die zur Verschlüsselung der zur Warteschlange hinzugefügten Daten erforderlich sind. **** ``` { "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 Erlauben Sie dem Amazon Chime SDK, Ereignisse zu einem Amazon SNS SNS-Thema zu veröffentlichen** Die folgende Beispiel-IAM-Richtlinie erteilt dem Amazon Chime SDK die Erlaubnis, Benachrichtigungen über Besprechungsereignisse zum angegebenen Amazon SNS SNS-Thema zu veröffentlichen. **** ``` { "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 aus dem Amazon Chime Chime-Namespace Das Amazon Chime SDK ist APIs auf einer Reihe von Endpunkten verfügbar. Sie können zwar HTTPS-Anfragen direkt an die Endpunkte stellen, aber viele Kunden verwenden das AWS SDK in ihren Anwendungen, um den Service aufzurufen. APIs Das AWS SDK ist in verschiedenen Sprachen verfügbar und vereinfacht API-Aufrufe, indem es die Logik für das Signieren von Anfragen und die Wiederholungslogik kapselt. Das AWS SDK enthält einen Namespace für jeden Dienstendpunkt. Beim ersten Start teilte sich das Amazon Chime SDK einen einzigen Endpunkt mit der Amazon Chime Chime-Anwendung. Daher verwendeten Lösungen den `Chime` Namespace im AWS SDK, um die Amazon Chime-Anwendung und das Amazon Chime SDK aufzurufen. APIs Das Amazon Chime SDK bietet jetzt spezielle Endpunkte für jeden Unterdienst, z. B. Besprechungen und PSTN-Audio. Jeder Endpunkt ist über einen eigenen Namespace im SDK adressierbar. AWS In den folgenden Themen werden die Dienste, Namespaces und Endpoints aufgeführt und beschrieben, wie sie im Code und mit der CLI verwendet werden. AWS **Topics** + [Endpunkte, Namespaces und CLI-Befehle](#endpoint-namespace-cli) + [Migrationshilfe für jeden Dienst](#help-per-service) + [API-Zuordnung](#name-end-map) ## Endpunkte, Namespaces und CLI-Befehle In der folgenden Tabelle sind die speziellen Amazon Chime SDK-Namespaces, Endpunkte und CLI-Befehle aufgeführt. Über die Links gelangen Sie zu weiteren Informationen zu den einzelnen Diensten. | Endpunkt | AWS SDK-Namespace | AWS SDK-CLI | | --- | --- | --- | | [Identity-Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Identity.html) | Glockenspiel 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) | SDKMediaGlockenspiel-Pipelines | [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) | | [Treffen — Glockenspiel](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html) | Glockenspiel 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) | | [Signalton](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Messaging.html) | Glockenspiel 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) | | [Sprachsignal](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Voice.html) | Glockenspiel 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) | ## Migrationshilfe für jeden Dienst Alle Kunden sollten erwägen, die speziellen Amazon Chime SDK-Endpunkte für den Zugriff auf die neuesten Amazon Chime SDK-Funktionen und Regionen zu verwenden. APIs AWS Wenn Sie den gemeinsamen Endpunkt mit dem `Chime` Namespace verwenden, können Ihnen die folgenden Migrationsleitfäden helfen, die technischen Unterschiede vor der Migration zu verstehen. + [Migration zum Amazon Chime SDKIdentity Chime-Namespace](identity-namespace-migration.md) + [Migration zum Amazon Chime SDKMedia Pipelines Namespace](migrate-pipelines.md) + [Migration zum Amazon Chime SDKMeetings Chime-Namespace](meeting-namespace-migration.md) + [Migration zum Amazon Chime SDKMessaging Chime-Namespace](messaging-namespace-migration.md) + [Migration zum Amazon Chime SDKVoice Chime-Namespace](voice-namespace-migration.md) ## API-Zuordnung In der folgenden Tabelle sind die Namespaces APIs im `Chime` Namespace und die entsprechenden dedizierten Namespaces und aufgeführt. APIs Einige der dedizierten Varianten APIs unterscheiden sich von den `Chime` APIs, und in der Tabelle sind diese Instanzen aufgeführt. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/chime-sdk/latest/dg/migrate-from-chm-namespace.html) **\$1** API wurde durch eine API mit einem anderen Namen ersetzt. **\$1** API ist nicht mehr verfügbar.