JoinChimeMeeting

Participe de uma reunião do SDK do Amazon Chime fornecendo o token de participação do participante. Para fazer isso, você faz chamadas AWS do SDK para o CreateMeeting e CreateAttendee APIs para obter o token e repassá-lo na ação. Veja o exemplo a seguir.

nota

Você não pode executar essa ação em uma chamada ancorada.

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

JoinToken

Descrição: um token de participação válido do participante da reunião do SDK do Amazon Chime

Valores permitidos: token de participação válido

Obrigatório – Sim

Valor-padrão: nenhum

CallId

Descrição — CallId do participante na CallDetails invocação da AWS Lambda função

Valores permitidos: um ID de chamada válido

Obrigatório – Não

Valor-padrão: nenhum

ParticipantTag

Descrição – ParticipantTag de um dos participantes conectados no CallDetails

Valores permitidos: LEG-A

Obrigatório – Não

Valor-padrão: ParticipantTag do callLeg invocado ignorado se você especificar CallId

MeetingId

Descrição: um ID de reunião válido do SDK do Amazon Chime associado ao JoinToken. Se a reunião foi criada usando uma API no namespace Amazon Chime, o ID da reunião não é necessário. Se a reunião foi criada usando uma API no namespace SDK do Amazon Chime, o ID da reunião é necessário. A reunião é ingressada usando o endpoint da API usado para criar a reunião.

Valores permitidos: um ID de reunião válido.

Obrigatório – Não.

Valor-padrão: nenhum.

O aplicativo de mídia SIP sempre invoca uma AWS Lambda função depois de executar essa ação. Ele retorna os tipos de eventos de invocação ACTION_SUCCESSFUL ou ACTION_FAILED. O exemplo a seguir mostra uma estrutura de evento de invocação bem-sucedida.

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

Gerenciamento de erros

Quando ocorre um erro de validação ao interligar uma reunião, o aplicativo SIP chama sua AWS Lambda função com uma das mensagens de erro mostradas na tabela a seguir.

Erro	Mensagem	Motivo
InvalidActionParameter	O valor do parâmetro JoinToken é inválido.	Qualquer um dos outros parâmetros da ação é inválido ou está ausente.
SystemException	Erro do sistema ao executar a ação.	Ocorreu outro tipo de erro do sistema na execução da ação.

O exemplo a seguir mostra um evento de falha típico.

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

Veja um exemplo prático em GitHub: https://github.com/aws-samples/amazon-chime-sma-update-call