ModifyChimeMeetingAttendee(오디오 음소거 및 음소거 해제) - Amazon Chime SDK

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

ModifyChimeMeetingAttendee(오디오 음소거 및 음소거 해제)

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

Error 메시지 이유

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