SendSdpOffer - Kinesis Video Streams
请求响应错误局限/限制幂等重试行为并发调用
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

SendSdpOffer

将提议发送给目标接收方。先决条件是客户端必须已连接到从 GetSignalingChannelEndpoint API 获取的 WebSocket 终端节点。

如果发送方类型是查看器，则它会将提议发送给主设备。此外，没有必要指定 RecipientClientId，并将忽略为 RecipientClientId 指定的任何值。如果发送方类型为主设备，提议将发送到由 RecipientClientId 指定的目标查看器。在这种情况下，RecipientClientId 是必需的输入。

允许主设备客户端应用程序向任何查看器发送提议，而只允许查看器客户端应用程序将提议发送到主设备客户端应用程序。如果查看器客户端应用程序尝试向其他查看器客户端应用程序发送提议，则不会接受该请求。如果同一客户端的未完成提议尚未交付，则该提议将被新提议覆盖。

请求

{
    "action": "SDP_OFFER",
    "recipientClientId": "string",
    "messagePayload": "string",
    "correlationId": "string"
}

  • action - 正在发送的消息的类型。

    • 类型：ENUM

    • 有效值：SDP_OFFER、SDP_ANSWER、ICE_CANDIDATE

    • 长度限制：最小长度为 1。长度上限为 256。

    • 模式：[a-zA-Z0-9_.-]+

    • 必需：是

  • recipientClientId - 接收方的唯一标识符。

    • 类型：字符串

    • 长度限制：最小长度为 1。长度上限为 256。

    • 模式：[a-zA-Z0-9_.-]+

    • 必需：是

  • messagePayload - 以 base-64 编码的消息内容。

    • 类型：字符串

    • 长度限制：最小长度为 1。最大长度为 10K。

    • 必需：是

  • correlationId - 消息的唯一标识符。此参数为可选参数。

    • 类型：字符串

    • 长度限制：最小长度为 1。长度上限为 256。

    • 模式：[a-zA-Z0-9_.-]+

    • 必需：否

响应

如果信令后端成功接收消息，则不会返回任何响应。如果服务遇到错误，并且在请求中指定了 correlationId，则错误详细信息将作为 STATUS_RESPONSE 消息返回。有关更多信息，请参阅异步消息接收。

错误

局限/限制

如果以过高的速率调用 API，此 API 将在账户级别受到限制。受到限制时返回错误以及 ClientLimitExceededException。

幂等

此 API 不是幂等的。

重试行为

这被视为新的 API 调用。

并发调用

允许并发调用。每次调用发送一次提议。