JoinChimeMeeting

Nehmen Sie an einem Amazon Chime SDK-Meeting teil, indem Sie dem Teilnehmer das Teilnahme-Token zur Verfügung stellen. Dazu führen Sie AWS SDK-Aufrufe an die CreateMeetingund CreateAttendee-APIs durch, um das Token abzurufen und es in der Aktion weiterzugeben. Sehen Sie sich das folgende -Beispiel an.

Anmerkung

Sie können diese Aktion nicht bei einem Bridged-Call 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 Teilnahme-Token des Amazon Chime SDK-Meeting-Teilnehmers

Zulässige Werte — Gültiges Beitrittstoken

Erforderlich — Ja

Standardwert – Kein

CallId

Beschreibung — CallId des Teilnehmers am CallDetails AWS Lambda Funktionsaufruf

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

Erforderlich — Nein

Standardwert – Kein

ParticipantTag

Beschreibung — ParticipantTag eines der verbundenen Teilnehmer am CallDetails

Zulässige Werte — LEG-A

Erforderlich — Nein

Standardwert — ParticipantTag der aufgerufene Wert wird callLeg ignoriert, wenn Sie Folgendes angeben CallId

MeetingId

Beschreibung — Eine gültige Amazon Chime SDK-Meeting-ID, die JoinToken mit dem verknüpft ist. Wenn das Meeting mit einer API im Amazon Chime Chime-Namespace erstellt wurde, ist die Meeting-ID nicht erforderlich. Wenn das Meeting mithilfe einer API im Amazon Chime SDK Meetings-Namespace erstellt wurde, ist die Meeting-ID erforderlich. Die Teilnahme an der Besprechung erfolgt über den API-Endpunkt, der zur Erstellung des Meetings verwendet wurde.

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

Erforderlich — Nein.

Standardwert — Keiner.

Die SIP-Medienanwendung ruft immer eine AWS Lambda Funktion auf, nachdem sie diese Aktion ausgeführt hat. Sie gibt entweder den Ereignistyp ACTION_SUCCESSFUL oder den ACTION_FAILED Aufrufereignistyp zurück. 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 beim Bridging eines Meetings ein Validierungsfehler auftritt, ruft die SIP-Anwendung ihre AWS Lambda Funktion mit einer der in der folgenden Tabelle aufgeführten Fehlermeldungen auf.

Fehler	Fehlermeldung	Grund
InvalidActionParameter	JoinTokenDer Parameterwert 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 ein anderer Systemfehler aufgetreten.

Das folgende Beispiel zeigt ein typisches Fehlerereignis.

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

Ein funktionierendes Beispiel finden Sie unter GitHub: https://github.com/aws-samples/ amazon-chime-sma-update -call