JoinChimeMeeting

提供与会者加入令牌即可加入 Amazon Chime SDK 会议。要执行这一操作，您可以对 CreateMeeting 和 CreateAttendee API 进行 AWS SDK 调用，以获得令牌并将其传递到后续的操作中。请参阅以下示例。

注意

您无法在桥接调用上运行此操作。

{
    "Type": "JoinChimeMeeting",
    "Parameters": {
        "JoinToken": "meeting-attendee-join-token",
        "CallId": "call-id-1",
        "ParticipantTag": "LEG-A",
        "MeetingId": "meeting-id"
    }
}

JoinToken

描述 — Amazon Chime SDK 会议与会者的有效加入令牌

允许的值 — 有效加入令牌

必填 — 是

默认值 – 无

CallId

描述 — AWS Lambda 函数调用的 CallDetails 中参与者的 CallId

允许的值 — 有效的调用 ID

必填 — 否

默认值 – 无

ParticipantTag

描述 — CallDetails 中一个已连接参与者的 ParticipantTag

允许的值 — LEG-A

必填 — 否

默认值 — 已调用 callLeg 的 ParticipantTag，如指定 CallId，则忽略该值

MeetingId

描述 — 与 JoinToken 关联的有效 Amazon Chime SDK 会议 ID。如果使用 Amazon Chime 命名空间中的 API 创建会议，则无需提供会议 ID。如果使用 Amazon Chime SDK 会议命名空间中的 API 创建会议，则需要提供会议 ID。使用用于创建会议的 API 终端节点加入会议。

允许的值 — 有效的会议 ID

必填 — 否。

默认值 — 无。

运行此操作后，SIP 媒体应用程序始终会调用 AWS Lambda 函数。它会返回 ACTION_SUCCESSFUL 或 ACTION_FAILED 调用事件类型。以下示例显示成功调用事件结构。

{
    "SchemaVersion": "1.0",
    "Sequence": 4,
    "InvocationEvent": "ACTION_SUCCESSFUL",
    "ActionData": {
        "Type": "JoinChimeMeeting",
        "Parameters": {
            "JoinToken": "meeting-attendee-join-token",
            "CallId": "call-id-1"
            "ParticipantTag": "LEG-A"
        }
    }
    "CallDetails": {
        ...
    }
}

错误处理

当桥接会议时出现验证错误时，SIP 应用程序会使用下表所示的错误消息之一调用其 AWS Lambda 函数。

错误	消息	Reason
InvalidActionParameter	JoinToken 参数值无效。	该操作的任何其他参数无效或缺失。
SystemException	运行操作时出现系统错误。	运行操作时出现另一种类型的系统错误。

以下示例显示了典型故障事件。

{
    "SchemaVersion": "1.0",
    "Sequence": 3,
    "InvocationEvent": "ACTION_FAILED",
    "ActionData": {
        "Type": "JoinChimeMeeting",
        "Parameters": {
            "JoinToken": "meeting-attendee-join-token",
            "CallId": "call-id-1",
            "ParticipantTag": "LEG-A"
        },
        "Error": "ErrorJoiningMeeting: Error while joining meeting."
    }
    "CallDetails": {
        ...
    }
}

在 GitHub 上查看工作示例：https://github.com/aws-samples/amazon-chime-sma-update-call