翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
JoinStorageSessionAsViewer
注記
マルチビューワーサポート (プレビュー) によるウェブRTC取り込みは、 AWS 「サービス条件」で定義されているようにプレビューで提供されており、変更される可能性があります。現在、us-east-1 () でのみ使用できますIAD。
プレビューに参加するには、kvs-webrtc-multi-view-preview@amazon.com まで E
注記
この を使用する前にAPI、 を呼び出しGetSignalingChannelEndpointAPIてWEBRTCエンドポイントをリクエストする必要があります。次に、JoinStorageSessionAsViewerAPIリクエストでエンドポイントとリージョンを指定します。
JoinStorageSessionAsViewer を使用すると、ビューワーは進行中のクラウド録画ウェブRTCストリーミングセッションに参加できます。これにより、ビューワーと録画エージェントの間でSDPオファーとICE候補を送信してウェブRTC接続APIが開始され、ビューワーは録画エージェントを介してマスターからリアルタイムのビデオを受信し、録画エージェントを介して双方向の音声通信に参加できるようになります。接続すると、ビューワーのオーディオが提供されていれば、マスター参加者を含む他のすべての接続ピアに転送され、Kinesis Video ストリームに保存されるウェブRTCストリームに組み込まれます。
重要
現在、視聴者はビデオトラックを送信できません。ビューワーは、オプションのオーディオトラックを送信することも、トラックをまったく送信しないこともできます。
現在の視聴者参加者の送信要件：
-
ビデオトラック: サポートされていません
-
オーディオトラック (オプション): Opus
マスター参加者が現在ビデオ生成デバイスに接続されている場合、Kinesis ビデオストリームに取り込まれたビデオには、H.264 ビデオとAACオーディオのパラメータがあります。
注記
ビューワー参加者は、マスター参加者ではなく、ストレージセッションに直接接続します。ストレージセッションは、メディアの混合、複製、適切な宛先へのルーティングを処理します。
注記
マスター参加者が存在しない場合、ビューワーは互いに聞くことができません。
ビューワー参加者が Web 経由で接続をネゴシエートするとRTC、マスター参加者がストレージセッションにも接続されている限り、取り込まれたオーディオセッションは Kinesis ビデオストリームに保存されます。
取り込み済みウェブRTCメディアではGetImages、 HLSや のDASH再生、 によるイメージ生成などの既存の Kinesis Video Streams 機能を使用することもできます。
注記
S3 イメージの配信と通知は現在サポートされていません。
注記
チャンネルのセッションに関連付けることができるビデオ生成デバイスクライアントは 1 つだけであるとします。複数のクライアントがビデオ生成デバイスとして特定のチャネルのセッションに参加する場合、最新のクライアントリクエストが優先されます。
制限
現在の制限が適用されます。
-
ビューワーの最大数： 3
-
ビューワー参加者がマスター参加者が存在しない状態でストレージセッションに接続したままの最大時間： 3 分
重要
ビューワーがストレージセッションから切断した場合 (ピア接続を閉じる場合）、そのクォータ (ビューワー制限) は 1 分間消費されたままになります。この 1 分間、ビューワーは同じクライアント ID APIでこれを呼び出して、追加のビューワークォータを消費することなくセッションに再参加できます。1 分後、ビューワークォータが解放され、他のビューワーが参加できるようになります。
追加情報
-
べき等 - これはべき等APIではありません。
-
再試行動作 - これは新しいAPI呼び出しとしてカウントされます。
-
同時通話 - 同時通話が許可されます。オファーは、コールごとに 1 回送信されます。
リクエストの構文
POST /joinStorageSessionAsViewer HTTP/1.1
Content-type: application/json
{
"channelArn": "string",
"clientId": "string"
}URI リクエストパラメータ
リクエストではURIパラメータを使用しません。
リクエスト本文
リクエストは、 JSON形式の次のデータを受け入れます。
- channelArn
-
シグナリングチャネルの Amazon リソースネーム (ARN）。
重要
この入力パラメータの大文字を書き留めます。
タイプ: 文字列
Pattern:
^arn:(aws[a-zA-Z-]*):kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+$必須: はい
- clientId
-
セッションクライアントの一意の識別子 (ID)。
タイプ: 文字列
長さの制約: 最小長は 1 です。最大長は 256 です。
Pattern:
^[a-zA-Z0-9_.-]+$必須: はい
レスポンスの構文
HTTP/1.1 200
レスポンス要素
アクションが成功すると、サービスは空のHTTP本文を持つ HTTP 200 レスポンスを返します。
エラー
すべてのアクションに共通のエラーについては、「共通エラー」を参照してください。
- AccessDeniedException
-
この操作を実行するために必要なアクセス許可がありません。
HTTP ステータスコード: 403
- ClientLimitExceededException
-
Kinesis Video Streams は、許可されたクライアントコールの制限を超えているため、リクエストをスロットリングしました。後で呼び出しを試みてください。
HTTP ステータスコード: 400
- InvalidArgumentException
-
この入力パラメータの値は無効です。
HTTP ステータスコード: 400
- ResourceNotFoundException
-
指定したリソースは見つかりませんでした。
HTTP ステータスコード: 404
以下の資料も参照してください。
言語固有の 1 つAPIでこれを使用する方法の詳細については AWS SDKs、以下を参照してください。
