JoinChimeMeeting

Para unirse a una reunión de Amazon Chime SDK, proporcione el token de acceso de los asistentes. Para ello, debe realizar llamadas del AWS SDK a las CreateAttendeeAPI CreateMeetingy obtener el token y transferirlo a la acción. Consulte el siguiente ejemplo.

nota

No puede ejecutar esta acción en una llamada puente.

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

JoinToken

Descripción: un token de unión válido del asistente a la reunión de Amazon Chime SDK

Valores permitidos: token de unión válido

Obligatorio: sí

Valor predeterminado: ninguno

CallId

Descripción: CallId del participante en la invocación CallDetails de la AWS Lambda función

Valores permitidos: un identificador de llamada válido

Obligatorio: no

Valor predeterminado: ninguno

ParticipantTag

Descripción: la ParticipantTag de uno de los participantes conectados en los CallDetails

Valores permitidos: -LEG-A

Obligatorio: no

Valor predeterminado: ParticipantTag del callLeg invocado ignorado si se especifica el CallId

MeetingId

Descripción: un ID de reunión de Amazon Chime SDK válido asociado al JoinToken. Si la reunión se creó mediante una API en el espacio de nombres Amazon Chime, no se requiere el ID de la reunión. Si la reunión se creó mediante una API en el espacio de nombres de Amazon Chime SDK Meetings, se requiere el ID de la reunión. Se accede a la reunión mediante el punto de conexión de la API utilizado para crear la reunión.

Valores permitidos: un identificador de reunión válido.

Obligatorio: no.

Valor predeterminado: ninguno.

La aplicación multimedia SIP siempre invoca una AWS Lambda función después de ejecutar esta acción. Devuelve el tipo de evento ACTION_SUCCESSFUL o el tipo de evento ACTION_FAILED de invocación. En el siguiente ejemplo se muestra una estructura de eventos de invocación correcta.

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

Control de errores

Cuando se produce un error de validación al cerrar una reunión, la aplicación SIP llama a su AWS Lambda función con uno de los mensajes de error que se muestran en la siguiente tabla.

Error	Mensaje	Motivo
InvalidActionParameter	El valor del parámetro JoinToken no es válido.	Falta alguno de los demás parámetros de la acción o no es válido.
SystemException	Error del sistema al ejecutar la acción.	Se ha producido otro tipo de error de sistema al ejecutar la acción.

En el siguiente ejemplo, se muestra un evento típico de fallo.

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

Consulte un ejemplo práctico en GitHub: https://github.com/aws-samples/ -call amazon-chime-sma-update