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

# 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)