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

# JoinChimeMeeting
<a name="join-chime-meeting"></a>

참석자에게 참여 토큰을 제공하여 Amazon Chime SDK 회의에 참여합니다. 이렇게 하려면 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_CreateMeeting.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_CreateMeeting.html) 및 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_CreateAttendee.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_CreateAttendee.html) APIs에 AWS SDK를 호출하여 토큰을 가져와 작업에서 전달합니다. 다음 예를 참조하세요.

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

```
{
    "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 함수 호출의에 있는 `CallId` 참가자에 `CallDetails` 대한 설명  
허용된 값** - 유효한 통화 ID  
필수** - 아니요  
*기본값* – 없음

**ParticipantTag**  
설명** - `CallDetails`의 연결된 참가자 중 한 명의 `ParticipantTag`입니다.  
허용된 값** - `LEG-A`  
필수** - 아니요  
기본값** - 간접 호출된 `callLeg`의 `ParticipantTag`(`CallId`를 지정한 경우 무시됨)

**MeetingId**  
설명** - `JoinToken`과 관련된 유효한 Amazon Chime SDK 회의 ID입니다. [Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime.html) 네임스페이스의 API를 사용하여 회의를 생성한 경우 회의 ID는 필요하지 않습니다. [Amazon Chime SDK 회의](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html) 네임스페이스의 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](https://github.com/aws-samples/amazon-chime-sma-update-call)