本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
JoinStorageSessionAsViewer
注意
具有多檢視器支援 （預覽） 的 WebRTC 擷取會在預覽版中提供，如 AWS 服務條款所定義，且可能有所變更。它目前僅適用於 us-east-1 （IAD）。
若要參與預覽，請傳送電子郵件至 kvs-webrtc-multi-view-preview@amazon.com
注意
使用此 之前API，您必須呼叫 GetSignalingChannelEndpointAPI來請求WEBRTC端點。然後，您可以在JoinStorageSessionAsViewerAPI請求中指定端點和區域。
將正在進行的單向影片和/或多向音訊 WebRTC 工作階段加入為輸入頻道的影片產生裝置。如果頻道沒有現有的工作階段，請建立新的串流工作階段，並提供訊號傳送頻道的 Amazon Resource Name （ARN）。
目前，對於 SINGLE_MASTER類型，產生影片的裝置能夠同時將音訊和影片媒體擷取到串流中。
重要
檢視器目前無法傳送任何影片曲目。檢視器可以傳送選用的音訊曲目或完全沒有曲目。
目前的檢視器參與者傳送需求：
-
影片追蹤：不支援
-
音軌 （選用）：Opus
如果主要參與者目前連接至影片產生裝置，則 Kinesis 影片串流中產生的擷取影片將具有下列參數：H.264 影片和AAC音訊。
所有參與者，包括檢視者和主人，都能夠互相聆聽。所有檢視器也會透過 Web 接收來自主要參與者的媒體RTC。
注意
檢視器參與者會直接連線至儲存工作階段，而不是直接連線至主要參與者。儲存工作階段負責混合、複製和路由媒體至適當的目的地。
注意
如果主要參與者不存在，檢視者將無法互相聆聽。
一旦檢視器參與者透過 Web 協商連線RTC，只要主要參與者也連接至儲存工作階段，擷取的音訊工作階段就會儲存在 Kinesis 影片串流中。
您也可以使用現有的 Kinesis Video Streams 功能，例如 HLS或DASH播放GetImages、透過 產生映像，以及透過擷取 WebRTC 媒體使用更多功能。
注意
目前不支援 S3 映像交付和通知。
注意
假設只有一個產生影片的裝置用戶端可以與頻道的工作階段建立關聯。如果多個用戶端將特定頻道的工作階段作為影片製作裝置加入，則以最新的用戶端請求為優先。
限制
目前的限制已到位：
-
檢視器數目上限：3
-
檢視器參與者保持連線至儲存工作階段的時間上限，但主要參與者不存在：3 分鐘
重要
如果檢視器中斷與儲存工作階段的連線 （關閉對等連線），其配額 （檢視器限制） 會維持使用 1 分鐘。在這 1 分鐘期間，檢視器可以使用API相同的用戶端 ID 調用此 ID，以重新加入工作階段，而無需額外的檢視器配額。1 分鐘後，檢視器配額會釋出，可供其他檢視器加入。
其他資訊
-
閒置 - API這不是等冪。
-
重試行為 - 這會視為新的API呼叫。
-
並行呼叫 - 允許並行呼叫。每次呼叫會傳送一次提議。
請求語法
POST /joinStorageSessionAsViewer HTTP/1.1
Content-type: application/json
{
"channelArn": "string",
"clientId": "string"
}URI 請求參數
請求不會使用任何URI參數。
請求主體
請求接受下列JSON格式的資料。
- channelArn
-
訊號傳送通道的 Amazon Resource Name （ARN）。
重要
請注意此輸入參數的大寫。
類型：字串
模式：
^arn:(aws[a-zA-Z-]*):kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+$必要：是
- clientId
-
寄件者用戶端的唯一識別碼。
類型：字串
長度限制：長度下限為 1。長度上限為 256。
模式：
^[a-zA-Z0-9_.-]+$必要：是
回應語法
HTTP/1.1 200
回應元素
如果動作成功，服務會傳回 200 HTTP 個回應，內HTTP文為空白。
錯誤
如需所有動作常見錯誤的資訊，請參閱常見錯誤。
- AccessDeniedException
-
您沒有執行此操作所需的許可。
HTTP 狀態碼：403
- ClientLimitExceededException
-
Kinesis Video Streams 已調節請求，因為您已超過允許的用戶端呼叫限制。稍後嘗試撥打電話。
HTTP 狀態碼：400
- InvalidArgumentException
-
此輸入參數的值無效。
HTTP 狀態碼：400
- ResourceNotFoundException
-
找不到指定的資源。
HTTP 狀態碼：404
另請參閱
如需在其中一種語言特定 API中使用此功能的詳細資訊 AWS SDKs，請參閱下列內容：
