JoinChimeMeeting

Nehmen Sie an einem Amazon Chime SDK-Meeting teil, indem Sie das Teilnehmer-Token bereitstellen. Um dies zu tun, machst duAWSDas SDK ruft aufCreateMeetingundcreateAttenDeeAPIs, um das Token zu erhalten und es in der Aktion weiterzugeben. Sehen Sie sich das folgende -Beispiel an.

Anmerkung

Sie können diese Aktion bei einem überbrückten Anruf nicht ausführen.

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

JoinToken

Beschreibung— Ein gültiges Beitrittstoken des Amazon Chime SDK-Meeting-Teilnehmers

Zulässige Werte- Gültiges Join-Token

Erforderlich— Yes

Standardwert – Keine

CalLid

Beschreibung–CallIddes Teilnehmers derCallDetailsderAWS LambdaAufrufen der -Funktion

Zulässige Werte- Eine gültige Anruf-ID

Erforderlich— Nein

Standardwert – Keine

ParticipantTag

Beschreibung–ParticipantTageines der verbundenen Teilnehmer imCallDetails

Zulässige Werte–LEG-A

Erforderlich— Nein

Standardwert–ParticipantTagder aufgerufenencallLegIgnoriert wenn Sie angebenCallId

meetingId

Beschreibung— Eine gültige Amazon Chime SDK-Meeting-ID, die mit demJoinTokenaus. Wenn das Meeting mit einer API imAmazon ChimeNamespace, die Besprechungs-ID ist nicht erforderlich. Wenn das Meeting mit einer API imAmazon Chime SDK-MeetingsNamespace ist die Meeting-ID erforderlich. Das Meeting wird über den API-Endpunkt beigetreten, der zum Erstellen des Meetings verwendet wurde.

Zulässige Werte— Eine gültige Meeting-ID.

Erforderlich— Nein.

Standardwert— Keine.

Die SIP-Medienanwendung ruft immer einAWS Lambda-Funktion nach dem Ausführen dieser Aktion. Es gibt entweder dieACTION_SUCCESSFULoderACTION_FAILEDAufruf-Ereignistypen. Das folgende Beispiel zeigt eine erfolgreiche Aufrufereignisstruktur.

{
    "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": {
        ...
    }
}

Fehlerbehandlung

Wenn während der Überbrückung eines Meetings ein Validierungsfehler auftritt, ruft die SIP-AnwendungAWS Lambda-Funktion mit einer der Fehlermeldungen, die in der folgenden Tabelle aufgeführt sind.

Fehler	Fehlermeldung	Grund
InvalidActionParameter	JoinTokenParameterwert ist ungültig.	Jeder der anderen Parameter der Aktion ist ungültig oder fehlt.
SystemException	Systemfehler beim Ausführen der Aktion.	Beim Ausführen der Aktion ist eine andere Art von Systemfehler aufgetreten.

Das folgende Beispiel zeigt ein typisches Ausfallsereignis.

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

Sehen Sie sich ein Arbeitsbeispiel auf GitHub an:https://github.com/aws-samples/amazon-chime-sma-update-call