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.
JoinStorageSessionAsViewer
Anmerkung
RTCWeb-Ingest mit Multi-Viewer-Unterstützung (Preview) wird in der Vorschauversion gemäß den AWS Servicebedingungen bereitgestellt und kann sich ändern. Es ist derzeit nur in us-east-1 () IAD verfügbar.
Anmerkung
Bevor Sie dies verwenden könnenAPI, müssen Sie den anrufen, GetSignalingChannelEndpoint API um den WEBRTC Endpunkt anzufordern. Anschließend geben Sie den Endpunkt und die Region in Ihrer JoinStorageSessionAsViewer API Anfrage an.
Nehmen Sie als Videoproduktionsgerät für einen Eingangskanal an der laufenden RTC Websitzung mit unidirektionalem Video und/oder Mehrwege-Audio teil. Wenn es keine bestehende Sitzung für den Kanal gibt, erstellen Sie eine neue Streaming-Sitzung und geben Sie den Amazon-Ressourcennamen (ARN) des Signalisierungskanals an.
Derzeit ist ein Videoproduktionsgerät für diesen SINGLE_MASTER Typ in der Lage, sowohl Audio- als auch Videomedien in einen Stream aufzunehmen.
Wichtig
Zuschauer können derzeit keine Videotracks senden. Zuschauer können eine optionale Audiospur oder gar keine Titel senden.
Aktuelle Anforderungen für das Senden von Zuschauern und Teilnehmern:
-
Videotrack: Nicht unterstützt
-
Audiospur (optional): Opus
Wenn der Master-Teilnehmer derzeit mit dem Videoproduktionsgerät verbunden ist, hat das resultierende aufgenommene Video im Kinesis-Videostream die folgenden Parameter: H.264-Video und Audio. AAC
Die Zuschauer-Teilnehmer können sich gegenseitig hören und auch Medien vom Master-Teilnehmer über das Internet empfangen. RTC
Anmerkung
Viewer-Teilnehmer stellen eine direkte Verbindung zur Speichersitzung her und nicht direkt mit dem Master-Teilnehmer. Die Speichersitzung kümmert sich um das Mischen, Duplizieren und Weiterleiten der Medien an das entsprechende Ziel.
Anmerkung
Wenn der Master-Teilnehmer nicht anwesend ist, können sich die Zuschauer nicht gegenseitig hören.
Sobald der Zuschauer-Teilnehmer eine Verbindung über das Internet ausgehandelt hatRTC, wird die aufgenommene Audiositzung im Kinesis-Videostream gespeichert, solange der Master-Teilnehmer auch mit der Speichersitzung verbunden ist.
Sie können auch vorhandene Kinesis Video Streams Streams-Funktionen wie HLS DASH OD-Wiedergabe, Bilderzeugung über GetImagesund mehr mit aufgenommenen RTC Webmedien verwenden.
Anmerkung
Die Bereitstellung von S3-Bildern und Benachrichtigungen werden derzeit nicht unterstützt.
Anmerkung
Gehen Sie davon aus, dass einer Sitzung für den Kanal nur ein Client für ein Videoproduktionsgerät zugeordnet werden kann. Wenn mehr als ein Client der Sitzung eines bestimmten Kanals als Videoproduktionsgerät beitritt, hat die neueste Client-Anfrage Vorrang.
Beschränkungen
Die aktuellen Grenzwerte gelten:
-
Maximale Anzahl von Zuschauern: 3
-
Maximale Zeit, für die Zuschauerteilnehmer mit der Speichersitzung verbunden bleiben, ohne dass ein Master-Teilnehmer anwesend ist: 3 Minuten
Wichtig
Wenn ein Zuschauer die Verbindung zur Speichersitzung trennt (die Peer-Verbindung schließt), bleibt sein Kontingent (Zuschauerlimit) 1 Minute lang verbraucht. Während dieses Zeitraums von einer Minute kann der Zuschauer dies API mit derselben Client-ID aufrufen, um wieder an der Sitzung teilzunehmen, ohne ein zusätzliches Zuschauerkontingent zu verbrauchen. Nach 1 Minute wird das Zuschauerkontingent freigegeben und steht anderen Zuschauern zur Teilnahme zur Verfügung.
Zusätzliche Informationen
-
Idempotent — Das API ist nicht idempotent.
-
Verhalten erneut versuchen — Dies wird als neuer Anruf gezählt. API
-
Gleichzeitige Anrufe — Gleichzeitige Anrufe sind zulässig. Pro Anruf wird einmal ein Angebot gesendet.
Anforderungssyntax
POST /joinStorageSessionAsViewer HTTP/1.1
Content-type: application/json
{
"channelArn": "string",
"clientId": "string"
}URIParameter anfordern
Die Anfrage verwendet keine URI Parameter.
Anforderungstext
Die Anfrage akzeptiert die folgenden Daten im JSON Format.
- channelArn
-
Der Amazon-Ressourcenname (ARN) des Signalkanals.
Wichtig
Beachten Sie die Großschreibung dieses Eingabeparameters.
Typ: Zeichenfolge
Pattern:
^arn:(aws[a-zA-Z-]*):kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+$Erforderlich: Ja
- clientId
-
Die eindeutige Kennung für den Absender-Client.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 256 Zeichen.
Pattern:
^[a-zA-Z0-9_.-]+$Erforderlich: Ja
Antwortsyntax
HTTP/1.1 200
Antwortelemente
Wenn die Aktion erfolgreich ist, sendet der Dienst eine HTTP 200-Antwort mit einem leeren HTTP Text zurück.
Fehler
Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter Häufige Fehler.
- AccessDeniedException
-
Sie verfügen nicht über die erforderlichen Berechtigungen, um diesen Vorgang auszuführen.
HTTPStatuscode: 403
- ClientLimitExceededException
-
Kinesis Video Streams hat die Anfrage gedrosselt, weil Sie das Limit der erlaubten Client-Aufrufe überschritten haben. Versuchen Sie später, den Anruf zu tätigen.
HTTPStatuscode: 400
- InvalidArgumentException
-
Der Wert für diesen Eingabeparameter ist ungültig.
HTTPStatuscode: 400
- ResourceNotFoundException
-
Die angegebene Ressource wurde nicht gefunden.
HTTPStatuscode: 404
Weitere Informationen finden Sie unter:
Weitere Informationen zur Verwendung API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden:
