本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
JoinStorageSession
重要
此 API 与以下内容有关WebRTC 摄入并且仅在us-west-2地区。
注意
在使用此 API 之前，您必须调用GetSignalingChannelEndpoint用于请求 WEBRTC 终端节点的 API。然后，您可以在您的中指定终端节点和区域JoinStorageSessionAPI 请求。
作为输入通道的视频制作设备，加入正在进行的单向视频和/或多路音频 WebRTC 会话。如果该频道没有现有会话，则需要创建新的流媒体会话，并且必须提供信号通道的 Amazon 资源名称 (ARN)。
目前对于SINGLE_MASTER类型，视频制作设备能够将音频和视频媒体同时收录到流中，而观众只能收录音频。视频制作设备和观众都可以先加入会话，然后等待其他参与者。
注意
目前，摄入 WebRTC 需要同时使用音频和视频轨道。
当参与者通过 WebRTC 进行点对点对话时，收录的媒体会话将存储到 Kinesis Video Stream 中。多个观众可以播放实时媒体。
客户还可以使用现有的 Kinesis Video Streams 功能，例如HLS要么DASH使用采集的 WebRTC 媒体进行播放、图像生成等。
注意
假设只有一个视频制作设备客户端可以与该频道的会话相关联。如果有多个客户端作为视频制作设备加入特定频道的会话，则最新的客户端请求优先。
注意
此 API 在中不可用Amazon中国地区。
请求语法
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 状态代码：403
- ClientLimitExceededException
-
Kinesis Video Streams 限制了该请求，因为您已超过允许的客户端呼叫限制。稍后再试打电话。
HTTP 状态代码：400
- InvalidArgumentException
-
此输入参数的值无效。
HTTP 状态代码：400
- ResourceNotFoundException
-
找不到指定的资源。
HTTP 状态代码：404
另请参阅
有关在特定语言的 Amazon 软件开发工具包中使用此 API 的更多信息，请参阅以下内容：