本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
JoinStorageSession
注意
在使用此之前API，您必須調用GetSignalingChannelEndpointAPI以請求WEBRTC端點。然後，您可以在JoinStorageSessionAPI請求中指定端點和區域。
將正在進行的單向視頻和/或多路音頻 Web RTC 會話加入為輸入通道的視頻生成設備。如果該頻道沒有現有的工作階段，請建立新的串流工作階段，並提供信令通道的 Amazon 資源名稱 (ARN)。
目前，對於該SINGLE_MASTER類型，視頻生成設備能夠將音頻和視頻媒體吸收到流中。只有視訊製作裝置可以加入工作階段並錄製媒體。
重要
網頁RTC擷取目前需要音訊和視訊軌道。
目前的要求：
-
視頻軌道:H.264
-
音軌：作品
Kinesis 視訊串流中產生的擷取視訊將具有下列參數：H.264 視訊和音訊。AAC
一旦主參與者透過 Web 協商連線RTC，擷取的媒體工作階段就會儲存在 Kinesis 視訊串流中。然後，多個觀眾可以通過我們的播放播放播放實時媒體APIs。
您也可以使用現有的 Kinesis Video Streams 功能，例如HLSDASH播放GetImages、透過擷取的網路RTC媒體產生影像等。
注意
目前不支援 S3 影像交付和通知。
注意
假設只有一個視訊產生裝置用戶端可以與頻道的工作階段相關聯。如果有多個用戶端將特定頻道的工作階段加入為視訊產生裝置，則會優先使用最新的用戶端要求。
其他資訊
-
冪等-這不API是冪等的。
-
重試行為-這被計為一個新的API呼叫。
-
並發呼叫-允許並發呼叫。每次呼叫會傳送一次提議。
請求語法
POST /joinStorageSession HTTP/1.1
Content-type: application/json
{
"channelArn": "string"
}URI請求參數
請求不使用任何URI參數。
請求主體
請求接受以下JSON格式的數據。
- channelArn
-
信令通道的 Amazon 資源名稱（ARN）。
重要
請注意此輸入參數的大小寫。
類型：字串
模式：
^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狀態碼:4
- ClientLimitExceededException
-
Kinesis Video Streams 已限制要求，因為您已經超過允許的用戶端呼叫限制。稍後再嘗試撥打電話。
HTTP狀態碼:
- InvalidArgumentException
-
此輸入參數的值無效。
HTTP狀態碼:
- ResourceNotFoundException
-
找不到指定的資源。
HTTP狀態碼:
另請參閱
如需有關API在其中一種特定語言中使用此功能的詳細資訊 AWS SDKs，請參閱下列內容：
