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.
JoinStorageSession
Anmerkung
Bevor Sie dies verwendenAPI, müssen Sie den anrufen, GetSignalingChannelEndpoint
API um den WEBRTC Endpunkt anzufordern. Anschließend geben Sie den Endpunkt und die Region in Ihrer JoinStorageSession
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 kann ein Videoproduktionsgerät für diesen SINGLE_MASTER
Typ sowohl Audio- als auch Videomedien in einen Stream aufnehmen. Nur Videoproduktionsgeräte können an der Sitzung teilnehmen und Medien aufnehmen.
Wichtig
Für die RTC Webaufnahme sind derzeit sowohl Audio- als auch Videospuren erforderlich.
Aktuelle Anforderungen:
-
Videospur: H.264
-
Audiospur: Opus
Das resultierende aufgenommene Video im Kinesis-Videostream hat die folgenden Parameter: H.264-Video und Audio. AAC
Sobald ein Master-Teilnehmer eine Verbindung über das Internet ausgehandelt hatRTC, wird die aufgenommene Mediensitzung im Kinesis-Videostream gespeichert. Über unser Playback können dann mehrere Zuschauer Medien in Echtzeit wiedergeben. APIs
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.
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 /joinStorageSession HTTP/1.1
Content-type: application/json
{
"channelArn": "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
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: