本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# ModifyChimeMeetingAttendee （靜音和取消靜音音訊）
<a name="mute-unmute"></a>

允許 SIP 媒體應用程式透過提供 Amazon Chime SDK 會議 ID 和出席者清單來修改電話出席者的狀態。

**注意**  
此動作目前支援電話語音出席者的靜音和取消靜音操作。此外，使用者必須使用 `JoinChimeMeeting`動作加入會議。此動作可以在 `participantTag=“LEG-B”`或對應的 上執行`CallId`。

此動作僅適用於從 SIP 媒體應用程式加入至 `"+`{{13605550122}}`"`、LEG-B 的 callLeg，或從 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

執行此動作後，Audio Service 一律會使用 `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 媒體應用程式會呼叫 AWS Lambda 函數，其中包含失敗指令或 API 特有的錯誤訊息。


|  錯誤  |  訊息  |  Reason  | 
| --- | --- | --- | 
| `InvalidActionParameter` | `ModifyChimeMeetingAttendees Operation` 參數值無效 | `Operation` 值必須是靜音或取消靜音。 | 
|   | 會議 ID 參數值無效。 | 會議 ID 為空。 | 
|   | 出席者清單參數值無效。 | 出席者 ID 清單為空，或超過上限 100。 | 
|   | 呼叫的動作無效。 | 呼叫不會橋接。 | 
|   | 通話未連線至 Chime 會議。 | 出席者未連線至 Chime 會議。 | 
|   | 一或多個出席者不屬於此會議。所有出席者都必須參加此會議。 | 出席者無權修改會議的出席者。 | 
| `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：//[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)