翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# JoinStorageSessionAsViewer
<a name="API_webrtc_JoinStorageSessionAsViewer"></a>

**注記**  
この API を使用する前に、 `GetSignalingChannelEndpoint` API を呼び出して WEBRTC エンドポイントをリクエストする必要があります。次に、`JoinStorageSessionAsViewer` API リクエストでエンドポイントとリージョンを指定します。

 `JoinStorageSessionAsViewer` を使用すると、ビューワーは進行中のクラウド録画 WebRTC ストリーミングセッションに参加できます。この API は、ビューワーと録画エージェントの間に SDP オファーと ICE 候補を送信することで WebRTC 接続を開始し、ビューワーが録画エージェントを介してマスターからリアルタイムビデオを受信し、録画エージェントを介して双方向音声通信に参加できるようにします。接続すると、ビューワーのオーディオは、提供された場合、マスター参加者を含む他の接続されたすべてのピアに転送され、Kinesis Video ストリームに保存される WebRTC ストリームに組み込まれます。

**重要**  
現在、視聴者は動画トラックを送信できません。ビューワーは、オプションのオーディオトラックを送信することも、トラックをまったく送信することもできません。  
現在のビューワー参加者の送信要件:  
ビデオトラック: サポートされていません
オーディオトラック (オプション): Opus

マスター参加者が現在ビデオ生成デバイスに接続されている場合、Kinesis ビデオストリームに取り込まれたビデオには、H.264 ビデオと AAC オーディオのパラメータが含まれます。

**注記**  
ビューワー参加者は、マスター参加者ではなく、ストレージセッションに直接接続します。ストレージセッションは、メディアの混合、複製、適切な宛先へのルーティングを処理します。

**注記**  
マスター参加者が存在しない場合、ビューワーは互いに聞くことができません。

ビューワー参加者が WebRTC を介して接続をネゴシエートすると、マスター参加者がストレージセッションにも接続されている限り、取り込まれたオーディオセッションは Kinesis ビデオストリームに保存されます。

取り込み済み WebRTC メディアでは、 `HLS`や`DASH`再生、[GetImages](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/gs-getImages.html) を介したイメージ生成などの既存の Kinesis Video Streams 機能を使用することもできます。

**注記**  
S3 イメージの配信と通知は現在サポートされていません。

**注記**  
チャネルのセッションに関連付けることができるビデオ生成デバイスクライアントは 1 つだけであるとします。複数のクライアントがビデオ生成デバイスとして特定のチャネルのセッションに参加する場合、最新のクライアントリクエストが優先されます。

 **制限** 

現在の制限は設定されています。
+  **ビューワーの最大数:** 3
+  ビュー**ワー参加者がマスター参加者なしでストレージセッションに接続したままになる最大時間:** 3 分

**重要**  
ビューワーがストレージセッションから切断した場合 (ピア接続を閉じる場合）、そのクォータ (ビューワー制限) は 1 分間消費されたままになります。この 1 分間、ビューワーは同じクライアント ID でこの API を呼び出して、追加のビューワークォータを消費することなくセッションに再参加できます。1 分後、ビューワークォータが解放され、他のビューワーが参加できるようになります。

 **追加情報** 
+  **べき等 **- この API はべき等ではありません。
+  **再試行動作** - これは新しい API コールとしてカウントされます。
+  **同時呼び出し** - 同時呼び出しは許可されます。オファーは、コールごとに 1 回送信されます。

## リクエストの構文
<a name="API_webrtc_JoinStorageSessionAsViewer_RequestSyntax"></a>

```
POST /joinStorageSessionAsViewer HTTP/1.1
Content-type: application/json

{
   "channelArn": "{{string}}",
   "clientId": "{{string}}"
}
```

## URI リクエストパラメータ
<a name="API_webrtc_JoinStorageSessionAsViewer_RequestParameters"></a>

リクエストでは URI パラメータを使用しません。

## リクエストボディ
<a name="API_webrtc_JoinStorageSessionAsViewer_RequestBody"></a>

リクエストは以下の JSON 形式のデータを受け入れます。

 ** [channelArn](#API_webrtc_JoinStorageSessionAsViewer_RequestSyntax) **   <a name="KinesisVideo-webrtc_JoinStorageSessionAsViewer-request-channelArn"></a>
シグナリングチャネルの Amazon リソースネーム (ARN)。  
この入力パラメータの大文字化に注意してください。
タイプ: 文字列  
Pattern: `arn:(aws[a-zA-Z-]*):kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+`   
必須: はい

 ** [clientId](#API_webrtc_JoinStorageSessionAsViewer_RequestSyntax) **   <a name="KinesisVideo-webrtc_JoinStorageSessionAsViewer-request-clientId"></a>
 セッションクライアントの一意の識別子 (ID)。  
タイプ: 文字列  
長さの制約: 最小長は 1 です。最大長は 256 です。  
パターン: `[a-zA-Z0-9_.-]+`   
必須: はい

## レスポンスの構文
<a name="API_webrtc_JoinStorageSessionAsViewer_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## レスポンス要素
<a name="API_webrtc_JoinStorageSessionAsViewer_ResponseElements"></a>

アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。

## エラー
<a name="API_webrtc_JoinStorageSessionAsViewer_Errors"></a>

すべてのアクションに共通のエラーについては、「[一般的なエラータイプ](CommonErrors.md)」を参照してください。

 ** AccessDeniedException **   
この操作を実行するために必要なアクセス許可がありません。  
HTTP ステータスコード: 403

 ** ClientLimitExceededException **   
 Kinesis Video Streams は、許可されたクライアントコールの制限を超えているため、リクエストをスロットリングしました。後で呼び出しを試みてください。  
HTTP ステータスコード: 400

 ** InvalidArgumentException **   
この入力パラメータの値は無効です。  
HTTP ステータスコード: 400

 ** ResourceNotFoundException **   
指定したリソースは見つかりませんでした。  
HTTP ステータスコード: 404

## 以下の資料も参照してください。
<a name="API_webrtc_JoinStorageSessionAsViewer_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSessionAsViewer) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSessionAsViewer) 
+  [AWS SDK for C\+\+](https://docs.aws.amazon.com/goto/SdkForCpp/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSessionAsViewer) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSessionAsViewer) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSessionAsViewer) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSessionAsViewer) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSessionAsViewer) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSessionAsViewer) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSessionAsViewer) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSessionAsViewer)