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.
Themen
- Voraussetzungen für das Amazon Chime SDK
- Amazon Chime SDK-Konzepte
- Amazon Chime SDK-Architektur
- Amazon Chime SDK-Servicekontingente
- Amazon Chime SDK-Systemanforderungen
- Verfügbare Regionen
- Integration mit einer Client-Bibliothek
- SIP-Integration mit einem Amazon Chime SDK Voice Connector
- Amazon Chime SDK-Ereignisbenachrichtigungen
- Migration aus dem Amazon Chime Chime-Namespace
Voraussetzungen für das 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 den 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 und Benutzern den Zugriff auf Amazon Chime SDK-Aktionen ermöglichen im Amazon Chime SDK-Administratorhandbuch.
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.
Amazon Chime SDK-Konzepte
Die folgenden Begriffe und Konzepte sind für das Verständnis der Verwendung des Amazon Chime SDK von zentraler Bedeutung.
- Treffen
-
Eine kurzlebige Ressource, die durch ein Unikat identifiziert wird.
MeetingIdDieMeetingIdwird 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 für eine Mediendienstgruppe stehen. 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
AttendeeIdNamen 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. - Teilnahme-Token
-
Ein eindeutiges Token, das jedem Teilnehmer zugewiesen wird. Die Teilnehmer verwenden das Join-Token, um sich bei der Media Service Group zu authentifizieren.
Amazon Chime SDK-Architektur
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. Die Amazon Chime SDKs nehmen Audio mit der höchsten vom Gerät und 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, Android und Windows 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.
Amazon Chime SDK-Servicekontingente
Anmerkung
Die 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.
In dieser Tabelle sind die Ressourcen und Kontingente aufgeführt, die für Amazon Chime SDK-Meetings verfügbar sind.
| Ressource | Kontingent | Einstellbar |
|---|---|---|
Aktive Besprechungen |
250 |
Ja |
|
Teilnehmer pro Sitzung |
250 |
Nein |
|
Audiostreams pro Sitzung |
250 |
Nein |
|
Pro Sitzung veröffentlichte Videostreams |
25 |
Ja, bis zu 250 |
|
Pro Teilnehmer abonnierte Videostreams |
25 |
Nein |
|
Geteilte Inhalte pro Meeting |
2 |
Nein |
| Wiederholte Besprechungen pro Hauptbesprechung | 4 | Ja, bis zu 40 |
Pipelines zur aktiven Medienerfassung pro Meeting |
1 |
Nein |
Pipelines zur aktiven Medienerfassung pro Konto |
100 für US-East-1-Endpunkte und 10 für andere Endpunkte |
Ja |
|
API-Rate |
10 Anfragen pro Sekunde (RPS) mit einem Burst von 20 RPS. |
Ja, aber indirekt AnmerkungDie API-Ratenlimits werden erhöht, wenn Sie das Kontingent für Active Meetings erhöhen. |
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
| Betriebssystem | Browser | Unterstützte Versionen | Hinweise |
|---|---|---|---|
Windows |
Mozilla Firefox |
75 und später |
|
|
Google Chrome |
78 und später | ||
|
Edge auf Chrombasis |
79 und später | ||
| Elektron auf Chrombasis | 7 und später | Mit Chrome-Version 78 und höher. | |
| Oper | 66 und später | ||
|
macOS |
Mozilla Firefox |
75 und später |
|
|
Google Chrome |
78 und später | ||
|
Edge auf Chrombasis |
79 und später | ||
|
Elektron auf Chrombasis |
|||
| Safari | 13 und später | ||
| Oper | 66 und später | ||
| iOS | Mozilla Firefox | 10 und später | Nur Audio und Video, kein Teilen von Inhalten. |
| Google Chrome | 78 und später | Nur Audio und Video, kein Teilen von Inhalten. | |
| Safari | 13 und später | Nur Audio und Video, kein Teilen von Inhalten. | |
| WK WebView | 14.3 und später | Nur Audio und Video, kein Teilen von Inhalten. | |
| Android | Google Chrome | 10 und später | Nur Audio und Video, kein Teilen von Inhalten. |
| Samsung | 12 und höher | Nur Audio und Video, kein Teilen von Inhalten. | |
| Chrom WebView | 5 und später | Nur Audio und Video, kein Teilen von Inhalten. | |
| Ubuntu LTS 16.04 und höher | Google Chrome | 78 und später |
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 ARM64-Architektur
