翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# 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**  
*説明* – `CallId` AWS Lambda 関数呼び出し`CallDetails`の の参加者の説明  
*使用できる値* – 有効な通話 ID  
*必須* – いいえ  
*デフォルト値* – なし

**ParticipantTag**  
*説明* – `CallDetails` に接続されている参加者のうちの 1 人の `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 関数を呼び出します。


|  エラー  |  メッセージ  |  Reason  | 
| --- | --- | --- | 
| `InvalidActionParameter` | `JoinToken` パラメータの値が無効です。 | アクションの他のパラメータのいずれかが無効か、欠落しています。 | 
| `SystemException` | アクションの実行中にシステムエラーが発生しました。 | アクションの実行中に、別のタイプのシステムエラーが発生しました。 | 

次の例は、一般的な失敗イベントを示しています。

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