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.
Die Themen in den folgenden Abschnitten bieten Antworten auf häufig gestellte Fragen zum Amazon Chime SDK. Erweitern Sie die Themen, um mehr zu erfahren.
Treffen FAQs
Themen
Teilnehmer
Nur Teilnehmer mit einem erforderlichen Teilnahme-Token. Wenn Sie das CreateAttendee, oder verwenden BatchCreateAttendee, erstellen Sie CreateMeetingWithAttendees APIsTeilnahmetoken, die Sie an Kunden weitergeben und es ihnen ermöglichen, an Besprechungen teilzunehmen. Die von diesen generierten Token APIs werden vom Dienst authentifiziert, wodurch die Erlaubnis erteilt wird, an dem Meeting teilzunehmen.
Anmerkung
Das Amazon Chime SDK erstellt keine Besprechungen und nimmt auch nicht an IDs URLs Besprechungsteilnehmern teil.
Die Teilnehmerkontingente gelten pro Meeting. Das Amazon Chime SDK unterstützt 250 Teilnehmer in einer Standardsitzung und 100 Teilnehmer in einer High-Definition-Sitzung. Wenn Sie mehr Teilnehmer benötigen, sollten Sie die Medienreplikation in Betracht ziehen. Dies ermöglicht bis zu 10.000 Teilnehmer, nachdem sie über die AWS Support Center-Konsole
Nein. Das Amazon Chime SDK berechnet Ihnen nur Gebühren, wenn Teilnehmer an einem Meeting teilnehmen. Außerdem enden Besprechungen automatisch 5 Minuten, nachdem der letzte aktive Teilnehmer die Besprechung abgebrochen oder verlassen hat.
AttendeeLeft
wird ausgelöst, wenn ein Teilnehmer beschließt, eine Besprechung zu verlassen. AttendeeDropped
wird ausgelöst, wenn ein Teilnehmer von einer Besprechung getrennt wird, in der Regel aufgrund von Netzwerkproblemen. AttendeeDeleted
wird ausgelöst, wenn DeleteAttendeeAPI wird aufgerufen.
AttendeeLeft
wird auch ausgelöst, wenn:
-
Wenn die
DeleteAttendee
API vom serverseitigen Meeting-Handler aufgerufen wird, zusammen mitAttendeeDeleted
. -
Ihr Kunde ruft die
meetingSession.audioVideo.Stop
API aus der Client-Bibliothek für JavaScript, die entsprechende APIs in iOS und Android oder wenn ein Meeting endet SDKs, auf.
Weitere Informationen zu Besprechungsereignissen finden Sie weiter Grundlegendes zu den Ereignissen im Lebenszyklus von Besprechungen im Amazon Chime SDK oben in diesem Handbuch.
Besprechungen enden automatisch, wenn:
-
Die Besprechungszeit beträgt mehr als 24 Stunden.
-
Die Besprechung ist eine Replikatbesprechung und die Hauptbesprechung endet.
-
Bei einer Besprechung, bei der es sich nicht um eine Replikatbesprechung handelt, stellen fünf Minuten lang keine Teilnehmer eine Verbindung her.
Standardmäßig JavaScript versucht die Amazon Chime SDK-Clientbibliothek fürMeetingSessionConfiguration
Besprechungsereignis angegeben. Außerdem sendet das Amazon Chime SDK ein AttendeeDropped
Ereignis, wenn der Teilnehmer von der Besprechung ausgeschlossen wird, und stellt nie wieder eine Verbindung zur Sitzung her.
Weitere Informationen zu Besprechungsereignissen finden Sie weiter unten in Überwachen diesen häufig gestellten Fragen.
Sicherheit und Verschlüsselung
Ja. Alle Medien werden während der Übertragung verschlüsselt und werden über den Service übertragen. Die Medien werden zwischen den Clients und der spezifischen Medieninstanz, die das Meeting hostet, verschlüsselt. Die Medieninstanz entschlüsselt das Audio für das Mischen und verschlüsselt dann das gemischte Audio für die Übertragung an den Client. Wenn Medien über Media Capture aufgenommen werden, werden die Medien zwischen der Media Instance und der Capture-Instance verschlüsselt.
Audio/Video
Themen
Allgemeines
Nein. Videostreams können jedoch angehalten werden, wenn die Bandbreite eingeschränkt ist.
Sie können die Videostreams, die jeder Client abonniert, programmgesteuert steuern. Auf diese Weise können Sie Logik wie „Moderator immer sichtbar“ oder „Meeting-Gastgeber immer sichtbar“ in einer paginierten Anzeige implementieren. Wenn die Ressourcen eines Clients begrenzt sind, können Sie die Streams mit der niedrigsten Priorität ausschalten. Weitere Informationen finden Sie im Benutzerhandbuch für prioritätsbasierte Downlink-Richtlinien
Codecs und Simulcast
- Video-Codecs
-
H.264, VP8, VP9 und. AV1
- Audio-Codecs
-
Opus, 16 kHz, 48 kHz und 48 kHz Stereo.
Wir unterstützen Video-Simulcast mit VP8 und H.264 und skalierbare Videokodierung mit. VP9 In der Amazon Chime SDK-Clientbibliothek für JavaScript
Echoreduzierung
Nein. Die Echoreduzierung ist auf Besprechungsebene für alle Teilnehmer aktiviert, wenn Sie die CreateMeeting oder CreateMeetingWithAttendees APIs. Weitere Informationen zur Verwendung der Echoreduzierung finden Sie unter Echoreduzierung zu Ihrer Anwendung hinzufügen
Geräuschunterdrückung
Wir verwenden Amazon Voice Focus, eine Geräuschunterdrückungstechnologie von AWS. Weitere Informationen zu Amazon Voice Focus finden Sie Verständnis VoiceFocus für den Amazon Chime SDK PTSN-Audiodienst unter und Konfiguration für Amazon Voice Focus weiter oben in diesem Handbuch.
Je nachdem, wie Sie Ihre Lösung programmieren, schalten die Besprechungsteilnehmer die Geräuschunterdrückung in der Regel ein oder aus. Die Amazon Chime SDK-Clientbibliotheken bieten programmatische Steuerungen für die Geräuschunterdrückung, und Sie entscheiden, wie Sie sie implementieren möchten. Sie können beispielsweise eine Umschalttaste oder eine Einstellung auf App-Ebene zur Steuerung der Geräuschunterdrückung bereitstellen. Weitere Informationen finden Sie unter Amazon Voice Focus
Unschärfe im Hintergrund
Wir haben die Algorithmen v1 und v2. Der v1-Algorithmus bietet vier Optionen, die auf der CPU-Auslastung (10 bis 40%) basieren. Der v2-Algorithmus geht davon aus, dass ein gewisses Maß an Unschärfe effektiv als hoch, mittel oder niedrig eingestuft wird. Die JavaScript browserbasierte Demo
Screen-Sharing
Für einen JavaScript Client stellt der Browser die Bildschirmrahmen für die Client-Bibliothek bereit. Die Auflösung entspricht der systemeigenen Auflösung des gemeinsam genutzten Bildschirms, begrenzt auf die maximale Auflösung, die von der Besprechung unterstützt wird. Sie können Bildraten festlegen, aber denken Sie daran, dass höhere Bildraten die CPU-Auslastung erhöhen.
Sie können auch einen Codec für die gemeinsame Nutzung auswählen. Bei einem Meeting mit Standardauflösung beträgt die Auflösung 1080p und die Kodierung beträgt 1,5 Mbit/s. Bei High-Definition-Meetings ist die Auflösung 4K-kodiert mit 2,5 Mbit/s.
Browser für mobile Geräte unterstützen keine Bildschirmaufnahme oder Bildschirmübertragung. Sie müssen iOS
Live-Transkription
Sie verwenden Amazon Transcribe, um personenbezogene Daten zu redigieren. Wenn Sie das verwenden StartMeetingTranscriptionBei der API zur Transkription eines Meetings können Sie den Redaktionstyp des Inhalts und die verschiedenen PII-Entitäten angeben, die geschwärzt werden sollen.
Anmerkung
Aufgrund des prädiktiven Charakters des maschinellen Lernens identifiziert und entfernt Amazon Transcribe möglicherweise nicht alle Fälle sensibler Daten und entspricht möglicherweise nicht den Gesetzen zum medizinischen Datenschutz, wie dem U.S. Health Insurance Portability and Accountability Act von 1996 (HIPAA). Weitere Informationen finden Sie unter Redigieren oder Identifizieren personenbezogener Daten im Amazon Transcribe Developer Guide.
Ja. Wenn Sie ein Abonnement abschließentranscribeEvent
, erhält jeder Kunde dieses Ereignis, und Sie können es den Endbenutzern in Ihrem Client anzeigen. Weitere Informationen finden Sie weiter Grundlegendes zu Live-Transkriptionsereignissen im Amazon Chime SDK oben in diesem Handbuch.
Das folgende Beispiel zeigt eine Möglichkeit, ein Abonnement abzuschließentranscribeEvent
.
useEffect(() => {
if (audioVideo) {
audioVideo.transcriptionController?.subscribeToTranscriptEvent((transcriptEvent) => {
setTranscripts(transcriptEvent);
});
}
}, [audioVideo]);
Weitere Informationen zur Verwendung transcribeEvent
finden Sie weiter Grundlegendes zu Live-Transkriptionsereignissen im Amazon Chime SDK oben in diesem Handbuch.
Sie verwenden Amazon Transcribe, um benutzerdefinierte Vokabeln und Wortschatzfilter zu erstellen, und wenn Sie die StartMeetingTranscriptionAPI, die Sie bereitstellen, VocabularyFilterName
und VocabularyFilterMethod
Werte, um unerwünschte Wörter zu maskieren. Weitere Informationen finden Sie unter Benutzerdefinierte Vokabulare und Erstellen eines Vokabelfilters im Amazon Transcribe Developer Guide.
Für die Live-Transkription in Echtzeit unterstützt Amazon Transcribe:
-
Chinesisch (vereinfacht) (zh-CN)
-
Englisch (Australisch) (en-AU)
-
Britisch (en-GB)
-
USA (en-US)
-
Französisch (Frankreich (fr-FR) und kanadisch (fr-CA))
-
Deutsch (de-DE)
-
Hindi (hi-IN)
-
Italienisch (it-IT)
-
Japanisch (JP-JP)
-
Koreanisch (ko-KR)
-
Portugiesisch (Brasilianisch) (pt-BR)
-
Spanisch (US (es-US))
-
Thailändisch (Th-TH)
Weitere Informationen zu den Sprachen, die für die Transkription in Echtzeit oder Batch verfügbar sind, finden Sie unter Unterstützte Sprachen und sprachspezifische Funktionen im Amazon Transcribe Developer Guide.
Servicekontingente
Ja. Dienstkontingente werden pro API-Endpunkt angewendet. Wenn Sie zu einem anderen API-Endpunkt wechseln, gelten die Standardgrenzwerte.
Namespace-Migration
In diesem Handbuch finden Sie Informationen zu den folgenden Themen:
Ja. Um die Ereignisse verwenden zu können, müssen Sie vom Namespace zum Namespace migrieren. chime
chimesdk
Weitere Informationen finden Sie in den folgenden Themen in diesem Handbuch:
Überwachen
Wir versenden Besprechungs- und Teilnehmerveranstaltungen über Amazon EventBridge, Amazon SNS oder Amazon SQS. Die Ereignisse enthalten Informationen wie Start- und Endzeiten von Besprechungen sowie Aktionen zum Beitreten, Abbrechen und Verlassen von Besprechungen. Weitere Informationen zu Besprechungsereignissen und deren Verwendung finden Sie in den folgenden Themen:
-
Grundlegendes zu Amazon Chime SDK-Ereignisbenachrichtigungen, weiter oben in diesem Handbuch.
-
Der Blogbeitrag zur serverseitigen Protokollierung und Überwachung von Amazon Chime SDK-Ereignissen
. -
Der Blogbeitrag „Überwachung und Problembehandlung mit Amazon Chime SDK“ zu Besprechungsveranstaltungen
. -
Besprechungsereignisse
am. GitHub
Zu den Metriken gehören AttendeeAuthorizationSuccess
AttendeeAuthorizationErrors
, undAttendeeAudioDrops
. Weitere Informationen zu den Metriken finden Sie weiter Grundlegendes zu CloudWatch Amazon-Metriken für Amazon Chime SDK-Besprechungen oben in diesem Handbuch.
Das Amazon Chime SDK generiert Besprechungsereignisse auf der Grundlage verschiedener Zustände der Komponenten in Ihrer Client-Anwendung, z. B. Audio, Video, Bildschirmübertragung oder Teilnehmeraktivitäten. Sie können diese Ereignisse in CloudWatch Protokolle schreiben und dann ein Dashboard mit diesen Protokollen erstellen. Sie können verschiedene Ereignisse, Fehlermeldungen und Statuscodes hinzufügen, um Erkenntnisse aus den Daten zu gewinnen.
Das Amazon Chime SDK lässt sich auch in Amazon EventBridge, Amazon SQS und Amazon SNS integrieren, um serverseitige Ereignisse wie Anfragen zum Erstellen oder Löschen von Besprechungen, Teilnehmern oder Medien-Pipelines zu verfolgen. Sie können Regeln konfigurieren, um nach Ereignissen zu filtern, an denen Sie interessiert sind, und die Ereignisse in Protokolle schreiben. CloudWatch
Weitere Informationen zu Besprechungsereignissen und deren Verwendung zur Erstellung von Dashboards finden Sie unter:
-
Besprechungsereignisse
am. GitHub -
Grundlegendes zu den Ereignissen im Lebenszyklus von Besprechungen im Amazon Chime SDK, weiter oben in diesem Handbuch.
-
Grundlegendes zu CloudWatch Amazon-Metriken für Amazon Chime SDK-Besprechungen, weiter oben in diesem Handbuch.
-
Grundlegendes zu Amazon Chime SDK-Ereignisbenachrichtigungen, weiter oben in diesem Handbuch.
Um es auszuprobieren, folgen Sie den Anweisungen in diesen Blogbeiträgen:
Beide Arten, ein Meeting zu beenden, lösen das MeetingFailed
Ereignis aus. Wenn Sie keinen Cloud Trail oder EventBridge Eintrag für den haben DeleteMeetingAPI, Sie können davon ausgehen, dass das Meeting automatisch beendet wurde.
Protokollierung
Führen Sie den folgenden Befehl und die folgenden Flags aus:. chrome —enable-logging
—vmodule=*/webrtc/*=1
Dadurch wird IFO
WebRTC aktiviert und VERBOSE
protokolliert. Das resultierende Protokoll wird benannt chrome_debug.log
und im Chrome-Benutzerdatenverzeichnis gespeichert.
Dazu gehen Sie wie folgt vor:
-
Wählen Sie in Safari Einstellungen aus.
-
Wähle „Erweiterte Optionen“ und dann „Funktionen für Webentwickler anzeigen“.
Das Menü Entwickeln wird im Browser angezeigt.
-
Wählen Sie im Menü Entwickeln die Option JavaScriptKonsole anzeigen.
-
Wählen Sie in der JavaScript Konsole Einstellungen und aktivieren Sie dann die WebRTC-Protokollierung. Sie können je nach Bedarf zwischen einfacher und ausführlicher Protokollierung wählen.
Fehlermeldungen
Gehen Sie wie folgt vor:
-
Stellen Sie sicher, dass der Ausgang für den UDP-Port 3478 im IP-Bereich 99.77.128.0/18 aktiviert ist. Weitere Informationen finden Sie weiter oben in diesem Handbuch. Konfiguration Ihres Netzwerks für Amazon Chime SDK-Meetings
-
Stellen Sie sicher, dass eine Antiviren-Browsererweiterung das Laden von Ressourcen nicht verhindert. UDP 3478 ist für TURN vorgesehen und muss auf der Endbenutzerseite entsperrt werden, entweder auf lokalen Computer-Firewalls oder auf der Unternehmensnetzwerk-Firewall.
-
Beim erneuten Verbindungsversuch wird auf TLS über Port 443 zurückgegriffen. Stellen Sie daher sicher, dass die Domäne oder das Subnetz nicht blockiert sind.
Dieser Fehler tritt normalerweise auf, wenn der Dienst einen Medien-Pipeline-ARN nicht auflösen kann. Stellen Sie sicher, dass der ARN zu einer Medienpipeline gehört und nicht zu einem Meeting. MediaPipelineArn
ist Teil der CreateMediaCapturePipelineAPI-Antwort.
Dieser Fehler tritt auf, wenn derselbe Teilnehmer von zwei Geräten aus teilnimmt. Der Fehler wird im meetingErrorMessage
Attribut eines meetingFailed
Ereignisses zurückgegeben. Um dies zu vermeiden, stellen Sie sicher, dass jeder Teilnehmer eine eindeutige Antwort hatExternalUserId
, und stellen Sie sicher, dass Sie nicht dieselbe Teilnehmerantwort aus dem CreateAttendee, BatchCreateAttendee, oder CreateMeetingWithAttendees APIs in zwei oder mehr Besprechungen gleichzeitig.
Sie rufen eine veraltete Amazon Chime Chime-API auf. Um das Problem zu lösen, migrieren Sie zum Amazon Chime SDK-Namespace. Weitere Informationen finden Sie weiter oben in diesem Handbuch unter den folgenden Themen:
Sie rufen eine veraltete Amazon Chime Chime-API auf. Um das Problem zu lösen, migrieren Sie zum Amazon Chime SDK-Namespace. Weitere Informationen finden Sie weiter oben in diesem Handbuch unter den folgenden Themen:
Das Client-Anforderungstoken ist ein eindeutiger Bezeichner, der API-Anfragen idempotent macht. Dieser Fehler tritt auf, wenn das Token einer inaktiven Medienpipeline zugeordnet ist. Um das Problem zu beheben, generieren Sie ein neues eindeutiges Token und senden Sie es zusammen mit der API-Anfrage.
Medien-Pipeline FAQs
Media Capture verwendet das MP4 Format. Dies umfasst 5-Sekunden-Segmente sowie kombinierte Aufnahme- und zusammengesetzte Dateien.
Um Media Capture-Teilnehmer zu löschen, können Sie die Pipeline beenden oder die DeleteMediaCapturePipelineAPI.
Medienerfassungspipelines zeichnen direkt in Ihrem Amazon S3 S3-Bucket auf. Die Medienerfassung stellt keine Anforderungen an Bandbreite oder Konnektivität an die Clients.
Um eine Region für die Erstellung von Medienaufzeichnungen auszuwählen, wählen Sie zunächst einen API-Endpunkt aus den verfügbaren Regionen der Meeting-Kontrollebene aus. Als Nächstes erstellen Sie die Pipeline für Besprechungen und Medienaufzeichnungen in dieser Region. Media Capture kann in einen Amazon S3 S3-Bucket in Ihrem Konto in jeder Amazon Chime SDK-Medienregion schreiben. Weitere Informationen zu den verfügbaren Regionen und Endpunkten, der Medien-Pipeline-Kontrollebene und Medienregionen finden Sie weiter Verfügbare AWS-Regionen für das Amazon Chime SDK oben in diesem Handbuch und Amazon Chime SDK-Endpunkte und Kontingente im AWS Referenzhandbuch.
Nein. Eine Pipeline erfasst nur die ersten 25 Videostreams.
Sie können einen Mechanismus zum Aufrufen des erstellen DeleteMediaCapturePipelineAPI nach einer bestimmten Anzahl von Minuten. Sie können beispielsweise eine Schrittfunktion erstellen, die zu Beginn der Medienaufnahme startet und eine vorgegebene Wartezeit hat.
Sie können die anrufen DeleteMediaCapturePipelineAPI zum Beenden der Aufzeichnungen, oder Sie können die aufrufen DeleteMeetingAPI, wenn das Meeting enden soll. Wenn während einer Besprechung nur noch der Teilnehmer mit der Medienaufnahme übrig ist, endet die Besprechung automatisch nach 5 Minuten.
PSTN-Audio FAQs
Nein. Sie können eine Nummer außerhalb der USA nicht mithilfe von PSTN-Audio an einen Voice Connector weiterleiten.
Ja. Rufen Sie zuerst die Hangup Aktion für das Bein auf, das mit der Besprechung verbunden ist. Dadurch wird der Teilnehmer von der Besprechung getrennt, ohne dass der eingehende Anruf beendet wird. Rufen Sie dann die JoinChimeMeeting Aktion auf, um die Teilnehmer an der neuen Besprechung teilzunehmen.