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 diese API verwenden, müssen Sie die `GetSignalingChannelEndpoint` API aufrufen, um den WEBRTC-Endpunkt anzufordern. Anschließend geben Sie den Endpunkt und die Region in Ihrer `JoinStorageSession` API-Anfrage an.
Nehmen Sie an der laufenden WebRTC-Sitzung mit Einwegvideo und and/or Mehrwege-Audio als Videoproduktionsgerät für einen Eingangskanal 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 WebRTC-Aufnahme sind derzeit sowohl Audio- als auch Videospuren erforderlich.
Aktuelle Anforderungen:
Videospur: H.264
Audiospur: Opus
Video:
Die maximale Auflösung ist SQFHD (1920x1920)
KVS WebRTC Ingestion unterstützt derzeit einen bestimmten Satz von H264-Profilen:
eingeschränkte Basislinie
Baseline
Haupt
high
eingeschränkt-hoch
progressiv-hoch
Das resultierende aufgenommene Video im Kinesis-Videostream hat die folgenden Parameter: H.264-Video und AAC-Audio.
Sobald ein Master-Teilnehmer eine Verbindung über WebRTC ausgehandelt hat, 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 [GetImages](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/gs-getImages.html)und mehr mit aufgenommenen WebRTC-Medien 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 — Diese API ist nicht idempotent**.
+ **Wiederholungsverhalten** — Dies wird als neuer API-Aufruf gezählt.
+ **Gleichzeitige Aufrufe** — Gleichzeitige Aufrufe sind zulässig. Pro Anruf wird einmal ein Angebot gesendet.
## Anforderungssyntax
```
POST /joinStorageSession HTTP/1.1
Content-type: application/json
{
"channelArn": "{{string}}"
}
```
## URI-Anfrageparameter
Die Anforderung verwendet keine URI-Parameter.
## Anforderungstext
Die Anforderung akzeptiert die folgenden Daten im JSON-Format.
** [channelArn](#API_webrtc_JoinStorageSession_RequestSyntax) **
Der Amazon-Ressourcenname (ARN) des Signalisierungskanals.
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, gibt der Dienst eine HTTP 200-Antwort mit leerem HTTP-Textinhalt zurück.
## Fehler
Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehlertypen](CommonErrors.md).
** AccessDeniedException **
Sie verfügen nicht über die erforderlichen Berechtigungen, um diesen Vorgang auszuführen.
HTTP-Statuscode: 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.
HTTP-Statuscode: 400
** InvalidArgumentException **
Der Wert für diesen Eingabeparameter ist ungültig.
HTTP-Statuscode: 400
** ResourceNotFoundException **
Die angegebene Ressource wurde nicht gefunden.
HTTP-Statuscode: 404
## Weitere Informationen finden Sie unter:
Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden:
+ [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession)
+ [AWS SDK for C\+\+](https://docs.aws.amazon.com/goto/SdkForCpp/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession)
+ [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession)
+ [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession)
+ [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession)