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

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

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

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"]
      }
    }
  ]
}
오퍼레이션

설명 — 참석자 목록에서 수행할 작업

허용되는 값 — 음소거, 음소거 해제

필수 — 예

기본값 – 없음

MeetingId

설명 — 참석자가 속한 미팅의 ID

허용되는 값 — 유효한 미팅 ID입니다. 음소거 또는 음소거 해제하는 사람도 회의에 참석해야 합니다.

필수 — 예

기본값 – 없음

CallId

설명 — 참석자가 속한 미팅의 ID

허용된 값 — 유효한 통화 ID입니다.

필수 — 아니요

기본값 – 없음

ParticipantTag

설명 — 참석자에게 할당된 태그입니다.

허용된 값 — 유효한 태그입니다.

필수 — 아니요

기본값 – 없음

AttendeeList

설명 — 음소거 또는 음소거 해제할 참석자 ID 목록

허용된 값 — 유효한 참석자 ID 목록

필수 — 예

기본값 — 없음, 최대 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 미디어 애플리케이션은 실패한 명령 또는 API와 관련된 오류 메시지와 함께AWS Lambda 함수를 호출합니다.

오류 메시지 이유

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 참조하십시오.