翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
JoinStorageSession
注記
この を使用する前にAPI、 を呼び出しGetSignalingChannelEndpointAPIてWEBRTCエンドポイントをリクエストする必要があります。次に、JoinStorageSessionAPIリクエストでエンドポイントとリージョンを指定します。
進行中の一方向動画および/または多方向音声ウェブRTCセッションを入力チャネルの動画生成デバイスとして参加します。チャネルに既存のセッションがない場合は、新しいストリーミングセッションを作成し、シグナリングチャネルの Amazon リソースネーム (ARN) を指定します。
現在、 SINGLE_MASTERタイプでは、ビデオ生成デバイスはオーディオメディアとビデオメディアの両方をストリームに取り込むことができます。セッションに参加してメディアを記録できるのは、ビデオ生成デバイスのみです。
重要
現在、ウェブRTC取り込みにはオーディオトラックとビデオトラックの両方が必要です。
現在の要件：
-
ビデオトラック: H.264
-
オーディオトラック: Opus
Kinesis ビデオストリームに取り込まれたビデオには、H.264 ビデオとAACオーディオのパラメータが含まれます。
マスター参加者が Web 経由で接続をネゴシエートするとRTC、取り込まれたメディアセッションが Kinesis ビデオストリームに保存されます。その後、複数のビューワーが再生 を通じてリアルタイムメディアを再生できますAPIs。
取り込み済みウェブRTCメディアではGetImages、 HLSや DASH再生、 を介したイメージ生成などの既存の Kinesis Video Streams 機能を使用することもできます。
注記
S3 イメージの配信と通知は現在サポートされていません。
注記
チャンネルのセッションに関連付けることができるビデオ生成デバイスクライアントは 1 つだけであるとします。複数のクライアントが特定のチャネルのセッションを動画生成デバイスとして参加する場合、最新のクライアントリクエストが優先されます。
追加情報
-
べき等 - API これはべき等ではありません。
-
再試行動作 - これは新しいAPI呼び出しとしてカウントされます。
-
同時呼び出し - 同時呼び出しが許可されます。オファーは、コールごとに 1 回送信されます。
リクエストの構文
POST /joinStorageSession HTTP/1.1
Content-type: application/json
{
"channelArn": "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]+$必須：はい
レスポンスの構文
HTTP/1.1 200
レスポンス要素
アクションが成功すると、サービスは空のHTTP本文を含む HTTP 200 レスポンスを返します。
エラー
すべてのアクションに共通のエラーについては、「共通エラー」を参照してください。
- AccessDeniedException
-
この操作を実行するために必要なアクセス許可がありません。
HTTP ステータスコード: 403
- ClientLimitExceededException
-
Kinesis Video Streams は、許可されたクライアントコールの制限を超えているため、リクエストをスロットリングしました。後で呼び出しを試みてください。
HTTP ステータスコード: 400
- InvalidArgumentException
-
この入力パラメータの値は無効です。
HTTP ステータスコード: 400
- ResourceNotFoundException
-
指定したリソースは見つかりませんでした。
HTTP ステータスコード: 404
以下の資料も参照してください。
言語固有の のいずれかAPIでこれを使用する方法の詳細については AWS SDKs、以下を参照してください。
