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

# JoinChimeMeeting
<a name="join-chime-meeting"></a>

提供与会者加入令牌即可加入 Amazon Chime SDK 会议。为此，您可以对[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_CreateMeeting.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_CreateMeeting.html)和 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_CreateAttendee.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_CreateAttendee.html)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**  
*描述* — `CallId` AWS Lambda 函数调用`CallDetails`中的参与者  
*允许的值* — 有效的调用 ID  
*必填* — 否  
*默认值* – 无

**ParticipantTag**  
*描述* — `CallDetails` 中一个已连接参与者的 `ParticipantTag`  
*允许的值* — `LEG-A`  
*必填* — 否  
*默认值* — 已调用 `callLeg` 的 `ParticipantTag`，如指定 `CallId`，则忽略该值

**MeetingId**  
*描述* — 与 `JoinToken` 关联的有效 Amazon Chime SDK 会议 ID。如果使用 [Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime.html) 命名空间中的 API 创建会议，则无需提供会议 ID。如果使用 [Amazon Chime SDK 会议](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html)命名空间中的 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 函数。


|  错误  |  Message  |  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](https://github.com/aws-samples/amazon-chime-sma-update-call)