JoinChimeMeeting

참석자에게 참여 토큰을 제공하여 Amazon Chime SDK 회의에 참여합니다. 이렇게 하려면 AWS SDK가 CreateMeeting 및 CreateAttendee API를 호출하여 토큰을 받고 작업에서 전달하도록 합니다. 다음 예제를 참조하세요.

참고

다중 통화에서는 이 작업을 실행할 수 없습니다.

{
    "Type": "JoinChimeMeeting",
    "Parameters": {
        "JoinToken": "meeting-attendee-join-token",
        "CallId": "call-id-1",
        "ParticipantTag": "LEG-A",
        "MeetingId": "meeting-id"
    }
}

JoinToken

설명 - Amazon Chime SDK 회의 참석자의 유효한 참여 토큰입니다.

허용된 값 - 유효한 참여 토큰

필수 - 예

기본값 – 없음

CallId

설명 - AWS Lambda 함수 간접 호출의 CallDetails에서 참가자의 CallId입니다.

허용된 값 - 유효한 통화 ID

필수 - 아니요

기본값 – 없음

ParticipantTag

설명 - CallDetails의 연결된 참가자 중 한 명의 ParticipantTag입니다.

허용된 값 - LEG-A

필수 - 아니요

기본값 - 간접 호출된 callLeg의 ParticipantTag(CallId를 지정한 경우 무시됨)

MeetingId

설명 - JoinToken과 관련된 유효한 Amazon Chime SDK 회의 ID입니다. Amazon Chime 네임스페이스의 API를 사용하여 회의를 생성한 경우 회의 ID는 필요하지 않습니다. Amazon Chime SDK 회의 네임스페이스의 API를 사용하여 회의를 생성한 경우 회의 ID가 필요합니다. 회의를 생성하는 데 사용된 API 엔드포인트를 사용하여 회의에 참여합니다.

허용된 값 - 유효한 회의 ID

필수 - 아니요

기본값 – 없음

SIP 미디어 애플리케이션은 이 작업을 실행한 후 항상 AWS Lambda 함수를 간접 호출합니다. ACTION_SUCCESSFUL 또는 ACTION_FAILED 간접 호출 이벤트 유형을 반환합니다. 다음 예제에서는 성공적인 간접 호출 이벤트 구조를 보여줍니다.

{
    "SchemaVersion": "1.0",
    "Sequence": 4,
    "InvocationEvent": "ACTION_SUCCESSFUL",
    "ActionData": {
        "Type": "JoinChimeMeeting",
        "Parameters": {
            "JoinToken": "meeting-attendee-join-token",
            "CallId": "call-id-1"
            "ParticipantTag": "LEG-A"
        }
    }
    "CallDetails": {
        ...
    }
}

오류 처리

회의를 연결하는 동안 검증 오류가 발생한 경우 SIP 애플리케이션은 다음 표에 표시된 오류 메시지 중 하나와 AWS Lambda 함수를 직접 호출합니다.

오류	메시지	이유
InvalidActionParameter	JoinToken parameter value is invalid.	작업의 다른 파라미터가 유효하지 않거나 누락되었습니다.
SystemException	System error while running action.	작업을 실행하는 동안 다른 유형의 시스템 오류가 발생했습니다.

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

{
    "SchemaVersion": "1.0",
    "Sequence": 3,
    "InvocationEvent": "ACTION_FAILED",
    "ActionData": {
        "Type": "JoinChimeMeeting",
        "Parameters": {
            "JoinToken": "meeting-attendee-join-token",
            "CallId": "call-id-1",
            "ParticipantTag": "LEG-A"
        },
        "Error": "ErrorJoiningMeeting: Error while joining meeting."
    }
    "CallDetails": {
        ...
    }
}

GitHub에서 작업 예제 참조: https://github.com/aws-samples/amazon-chime-sma-update-call