JoinChimeMeeting

Participez à une réunion du SDK Amazon Chime en fournissant le jeton de connexion au participant. Pour ce faire, vous appelez le AWS SDK aux CreateAttendeeAPI CreateMeetingand pour obtenir le jeton et le transmettre dans l'action. Consultez l'exemple suivant.

Note

Vous ne pouvez pas exécuter cette action sur un appel ponté.

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

JoinToken

Description — Un jeton d'adhésion valide pour le participant à la réunion du SDK Amazon Chime

Valeurs autorisées : jeton de jointure valide

Obligatoire — Oui

Valeur par défaut – Aucune

CallId

Description — CallId du participant à l'CallDetailsinvocation de la AWS Lambda fonction

Valeurs autorisées : un identifiant d'appel valide

Obligatoire — Non

Valeur par défaut – Aucune

ParticipantTag

Description — ParticipantTag de l'un des participants connectés au CallDetails

Valeurs autorisées — LEG-A

Obligatoire — Non

Valeur par défaut — ParticipantTag de la valeur callLeg ignorée invoquée si vous spécifiez CallId

MeetingId

Description — Un identifiant de réunion du SDK Amazon Chime valide associé au. JoinToken Si la réunion a été créée à l'aide d'une API dans l'espace de noms Amazon Chime, l'identifiant de réunion n'est pas requis. Si la réunion a été créée à l'aide d'une API dans l'espace de noms Amazon Chime SDK Meetings, l'identifiant de réunion est requis. La réunion est jointe à l'aide du point de terminaison de l'API utilisé pour créer la réunion.

Valeurs autorisées : un identifiant de réunion valide.

Obligatoire — Non

Valeur par défaut : aucune.

L'application multimédia SIP invoque toujours une AWS Lambda fonction après avoir exécuté cette action. Il renvoie soit le type d'événement, ACTION_SUCCESSFUL soit le type d'événement d'ACTION_FAILEDinvocation. L'exemple suivant montre une structure d'événement d'invocation réussie.

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

Gestion des erreurs

Lorsqu'une erreur de validation se produit lors de la transition d'une réunion, l'application SIP appelle sa AWS Lambda fonction avec l'un des messages d'erreur présentés dans le tableau suivant.

Erreur	Message	Raison
InvalidActionParameter	JoinTokenla valeur du paramètre n'est pas valide.	L'un des autres paramètres de l'action n'est pas valide ou est absent.
SystemException	Erreur système lors de l'exécution de l'action.	Un autre type d'erreur système s'est produit lors de l'exécution de l'action.

L'exemple suivant illustre un événement de défaillance typique.

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

Voir un exemple pratique sur GitHub : https://github.com/aws-samples/ amazon-chime-sma-update -call