JoinChimeMeeting

Partecipa a una riunione Amazon Chime SDK fornendo il token di partecipazione del partecipante. A tale scopo, effettui chiamate AWS SDK alle CreateAttendeeAPI CreateMeetingand per ottenere il token e trasmetterlo durante l'azione. Guarda l'esempio seguente.

Nota

Non puoi eseguire questa azione su una chiamata interrotta.

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

JoinToken

Descrizione: un token di accesso valido del partecipante alla riunione Amazon Chime SDK

Valori consentiti: token di iscrizione valido

Obbligatorio: sì

Valore predefinito - nessuno

CallId

Descrizione: CallId del partecipante all'CallDetailsinvocazione della AWS Lambda funzione

Valori consentiti: un ID di chiamata valido

Obbligatorio: no

Valore predefinito - nessuno

ParticipantTag

Descrizione: ParticipantTag di uno dei partecipanti connessi al CallDetails

Valori consentiti: LEG-A

Obbligatorio: no

Valore predefinito: ParticipantTag del valore callLeg Ignorato richiamato, se specificato CallId

MeetingId

Descrizione: un ID riunione Amazon Chime SDK valido associato a. JoinToken Se la riunione è stata creata utilizzando un'API nello spazio dei nomi Amazon Chime, l'ID della riunione non è richiesto. Se la riunione è stata creata utilizzando un'API nello spazio dei nomi Amazon Chime SDK Meetings, è necessario l'ID della riunione. Alla riunione si partecipa utilizzando l'endpoint API utilizzato per creare la riunione.

Valori consentiti: un ID riunione valido.

Obbligatorio: no.

Valore predefinito: Nessuno.

L'applicazione multimediale SIP richiama sempre una AWS Lambda funzione dopo aver eseguito questa azione. Restituisce i tipi di evento ACTION_SUCCESSFUL o di ACTION_FAILED invocazione. L'esempio seguente mostra una struttura di eventi di chiamata riuscita.

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

Gestione degli errori

Quando si verifica un errore di convalida durante il collegamento di una riunione, l'applicazione SIP richiama la sua AWS Lambda funzione con uno dei messaggi di errore mostrati nella tabella seguente.

Errore	Messaggio	Motivo
InvalidActionParameter	JoinTokenil valore del parametro non è valido.	Qualsiasi altro parametro dell'azione non è valido o è mancante.
SystemException	Errore di sistema durante l'esecuzione dell'azione.	Si è verificato un altro tipo di errore di sistema durante l'esecuzione dell'azione.

L'esempio seguente mostra un tipico evento di errore.

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

Vedi un esempio funzionante su GitHub: https://github.com/aws-samples/ amazon-chime-sma-update -call