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

# 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**  
*描述* — 要静音或取消静音的与会者 ID 列表  
*允许的值* — 有效的与会者 ID 列表  
*必填* — 是  
*默认值* — 无，最大值 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-call](https://github.com/aws-samples/amazon-chime-sma-update-call)