JoinChimeMeeting

出席者参加トークンを指定して、Amazon Chime SDK ミーティングに参加します。これを行うには、 CreateMeetingおよび CreateAttendee 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 関数呼び出しCallDetailsの におけるCallId参加者の

使用できる値 – 有効な通話 ID

必須 – いいえ

デフォルト値 – なし

ParticipantTag

説明 – CallDetails に接続されている参加者のうちの 1 人の 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 パラメータの値が無効です。	アクションの他のパラメータのいずれかが無効か、欠落しています。
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": {
        ...
    }
}

「https://github.com/aws-samples/amazon-chime-sma-update-call」の実例を参照してください GitHub。