JoinChimeMeeting

透過提供出席者加入權杖，加入 Amazon Chime SDK 會議。若要這麼做，您可以對CreateMeeting和 CreateAttendeeAPI 進行 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

描述 — 中ParticipantTag其中一個已連接參與者的描述 CallDetails

允許的值 — LEG-A

必要 — 否

默認值-callLeg 被調用ParticipantTag的忽略，如果您指定 CallId

MeetingId

說明 — 與. 相關聯的JoinToken有效 Amazon Chime SDK 會議識別碼。如果會議是使用 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": {
        ...
    }
}

看到一個工作示例 GitHub：https://github.com/aws-samples/ amazon-chime-sma-update- 調用