翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# JoinStorageSession
**注記**
この API を使用する前に、 `GetSignalingChannelEndpoint` API を呼び出して WEBRTC エンドポイントをリクエストする必要があります。次に、`JoinStorageSession` API リクエストでエンドポイントとリージョンを指定します。
進行中の一方向ビデオおよび/または多方向オーディオ WebRTC セッションを入力チャネルのビデオ生成デバイスとして参加します。チャネルに既存のセッションがない場合は、新しいストリーミングセッションを作成し、シグナリングチャネルの Amazon リソースネーム (ARN) を指定します。
現在、 `SINGLE_MASTER`タイプでは、ビデオ生成デバイスはオーディオメディアとビデオメディアの両方をストリームに取り込むことができます。ビデオ生成デバイスのみがセッションに参加し、メディアを記録できます。
**重要**
現在、WebRTC 取り込みにはオーディオトラックとビデオトラックの両方が必要です。
現在の要件:
ビデオトラック: H.264
オーディオトラック: Opus
動画:
最大解像度は SQFHD (1920x1920)
KVS WebRTC 取り込みは現在、特定の H264 プロファイルのセットをサポートしています。
制約されたベースライン
ベースライン
メイン
high
制約付き - 高
プログレッシブ高
Kinesis ビデオストリームに取り込まれたビデオには、H.264 ビデオと AAC オーディオのパラメータがあります。
マスター参加者が WebRTC を介して接続をネゴシエートすると、取り込まれたメディアセッションは Kinesis ビデオストリームに保存されます。その後、複数のビューワーが再生 APIs を使用してリアルタイムメディアを再生できます。
取り込み済み WebRTC メディアでは、 `HLS`や`DASH`再生、[GetImages](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/gs-getImages.html) を介したイメージ生成などの既存の Kinesis Video Streams 機能を使用することもできます。
**注記**
S3 イメージの配信と通知は現在サポートされていません。
**注記**
チャネルのセッションに関連付けることができるビデオ生成デバイスクライアントは 1 つだけであるとします。複数のクライアントがビデオ生成デバイスとして特定のチャネルのセッションに参加する場合、最新のクライアントリクエストが優先されます。
**追加情報**
+ **べき等 **- この API はべき等ではありません。
+ **再試行動作** - これは新しい API コールとしてカウントされます。
+ **同時呼び出し** - 同時呼び出しは許可されます。オファーは、コールごとに 1 回送信されます。
## リクエストの構文
```
POST /joinStorageSession HTTP/1.1
Content-type: application/json
{
"channelArn": "{{string}}"
}
```
## URI リクエストパラメータ
リクエストでは URI パラメータを使用しません。
## リクエストボディ
リクエストは以下の JSON 形式のデータを受け入れます。
** [channelArn](#API_webrtc_JoinStorageSession_RequestSyntax) **
シグナリングチャネルの Amazon リソースネーム (ARN)。
この入力パラメータの大文字化に注意してください。
タイプ: 文字列
Pattern: `arn:(aws[a-zA-Z-]*):kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+`
必須: はい
## レスポンスの構文
```
HTTP/1.1 200
```
## レスポンス要素
アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。
## エラー
すべてのアクションに共通のエラーについては、「[一般的なエラータイプ](CommonErrors.md)」を参照してください。
** AccessDeniedException **
この操作を実行するために必要なアクセス許可がありません。
HTTP ステータスコード: 403
** ClientLimitExceededException **
Kinesis Video Streams は、許可されたクライアントコールの制限を超えているため、リクエストをスロットリングしました。後で呼び出しを試みてください。
HTTP ステータスコード: 400
** InvalidArgumentException **
この入力パラメータの値は無効です。
HTTP ステータスコード: 400
** ResourceNotFoundException **
指定したリソースは見つかりませんでした。
HTTP ステータスコード: 404
## 以下の資料も参照してください。
言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+ [AWS コマンドラインインターフェイス 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 for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession)
+ [AWS SDK for 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 for 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)