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

# ModifyChimeMeetingAttendee（将音频静音和取消静音）
<a name="mute-unmute"></a>

允许 SIP 媒体应用程序通过提供 Amazon Chime SDK 会议 ID 和与会者列表修改电话与会者的状态。

**注意**  
此操作目前支持对电话与会者进行静音和取消静音操作。此外，用户必须使用 `JoinChimeMeeting` 操作加入会议。可以在 `participantTag=“LEG-B”` 上或对应的 `CallId` 上执行此操作。

此操作仅适用于从 SIP 媒体应用程序加入会议的 CallLeg `"+` *13605550122* `"`、LEG-B 或从 SIP 媒体应用程序加入会议的分支。

```
{
"SchemaVersion": "1.0",
  "Actions": [
    {
      "Type" : "ModifyChimeMeetingAttendees",
      "Parameters" : {
        "Operation": "Mute",
        "MeetingId": "meeting-id",
        "CallId": "call-id",
        "ParticipantTag": LEG-B",
        "AttendeeList": ["attendee-id-1", "attendee-id-2"]
      }
    }
  ]
}
```

**Operation**  
*描述* — 要对与会者列表执行的操作  
*允许的值* — 静音、取消静音  
*必填* — 是  
*默认值* – 无

**MeetingId**  
*描述* — 与会者所属会议的 ID  
*允许的值* — 有效的会议 ID 设置静音或取消静音的人员也必须属于会议。  
*必填* — 是  
*默认值* – 无

**CallId**  
*描述* — 与会者所属会议的 ID  
*允许的值* — 有效的调用 ID。  
*必填* — 否  
*默认值* – 无

**ParticipantTag**  
*描述* — 分配给与会者的标签。  
*允许的值* — 有效的标签。  
*必填* — 否  
*默认值* – 无

**AttendeeList**  
*描述*- IDs 要静音或取消静音的与会者列表  
*允许的值*-有效与会者列表 IDs  
*必填* — 是  
*默认值* — 无，最大值 100

执行此操作后，音频服务始终调用 `ACTION_SUCCESSFUL` 或 `ACTION_FAILED` 调用事件类型的 AWS Lambda 函数。以下示例代码显示了典型的 `ACTION_SUCCESSFUL` 调用事件。

```
{
    "SchemaVersion": "1.0",
    "Sequence": INTEGER,
    "InvocationEventType": "ACTION_SUCCESSFUL",
    "ActionData": {
        "Type" : "ModifyChimeMeetingAttendees",
        "Parameters" : {
            "Operation": "Mute",
            "MeetingId": "meeting-id",
            "CallId": "call-id",
            "ParticipantTag": "LEG-B",
            "AttendeeList": ["attendee-id-1", "attendee-id-2"]
        }
    }
    "CallDetails": {
        ...
    }
}
```

**错误处理**  
如果指令参数无效或 API 出现故障，SIP 媒体应用程序会调用带有特定于失败指令或 API 的错误消息的 AWS Lambda 函数。


|  错误  |  Message  |  Reason  | 
| --- | --- | --- | 
|  `InvalidActionParameter`  |  `ModifyChimeMeetingAttendees Operation` 参数值无效  |  `Operation` 值必须为“静音”或“取消静音”。  | 
|     |  会议 ID 参数值无效。  |  会议 ID 为空。  | 
|     |  与会者列表参数值无效。  |  与会者 ID 列表为空，或者超过最大值 100。  | 
|     |  对调用的操作无效。  |  调用没有桥接。  | 
|     |  调用未连接到 Chime Meeting。  |  与会者未连接到 Chime Meeting。  | 
|     |  一位或多位与会者并不是此会议的一部分。所有与会者必须是会议的一部分。  |  与会者无权修改会议中的与会者。  | 
|  `SystemException`  |  运行操作时出现系统错误。  |  运行操作时出现系统错误。  | 

以下示例代码显示了典型失败事件。

```
{
    "SchemaVersion": "1.0",
    "Sequence": INTEGER,
    "InvocationEventType": "ACTION_FAILED",
    "ActionData": {
        "Type" : "ModifyChimeMeetingAttendees",
        "Parameters" : {
            "Operation": "Mute",
            "MeetingId": "meeting-id",
            "CallId": "call-id",
            "ParticipantTag": "LEG-B",
            "AttendeeList": ["attendee-id-1", "attendee-id-2"]
        },
        "ErrorType": "",
        "ErrorMessage": "",
        "ErrorList": []
    }
    "CallDetails": {
        ...
    }
}
```

参见以下方面的工作示例 GitHub：
+ [https://github.com/aws-samples/amazon-chime-sma-bridging](https://github.com/aws-samples/amazon-chime-sma-bridging).
+ [https://github.com/aws-samples/amazon-chime-sma-update-打电话](https://github.com/aws-samples/amazon-chime-sma-update-call)