기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# ModifyChimeMeetingAttendee(오디오 음소거 및 음소거 해제)
<a name="mute-unmute"></a>

Amazon Chime SDK 회의 ID 및 참석자 목록을 제공하여 SIP 미디어 애플리케이션이 텔레포니 참석자의 상태를 수정할 수 있도록 합니다.

**참고**  
이 작업은 현재 텔레포니 참석자에 대한 음소거 및 음소거 해제 작업을 지원합니다. 또한 사용자는 `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**  
설명** - 참석자 목록에서 수행할 작업입니다.  
허용된 값** - Mute, Unmute  
필수** - 예  
*기본값* – 없음

**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 함수를 호출합니다.


|  오류  |  메시지  |  이유  | 
| --- | --- | --- | 
|  `InvalidActionParameter`  |  The `ModifyChimeMeetingAttendees Operation` parameter value is invalid  |  `Operation` 값은 Mute 또는 Unmute여야 합니다.  | 
|     |  Meeting ID parameter value is invalid.  |  회의 ID가 비어 있습니다.  | 
|     |  Attendee List parameter value is invalid.  |  참석자 ID 목록이 비어 있거나 최대 100명을 초과합니다.  | 
|     |  Invalid action on the call.  |  통화가 연결되지 않았습니다.  | 
|     |  Call is not connected to Chime Meeting.  |  참석자가 Chime 회의에 연결되어 있지 않습니다.  | 
|     |  One or more attendees are not part of this meeting. All attendees must be part of this meeting.  |  참석자는 회의에서 참석자를 수정할 권한이 없습니다.  | 
|  `SystemException`  |  System error while running action.  |  작업을 실행하는 동안 시스템 오류가 발생했습니다.  | 

다음 예제 코드는 일반적인 실패 이벤트를 보여줍니다.

```
{
    "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)