ModifyChimeMeetingAttendee (silenciar e reativar o áudio) - SDK do Amazon Chime

ModifyChimeMeetingAttendee (silenciar e reativar o áudio)

Permite que o aplicativo de mídia SIP modifique o status de um participante de uma chamada telefônica fornecendo o ID da reunião e a lista de participantes do SDK do Amazon Chime.

nota

Atualmente, essa ação oferece suporte às operações de ativar e desativar o áudio em participantes da chamada telefônica. Além disso, o usuário deve participar de uma reunião usando a ação JoinChimeMeeting. Essa ação pode ser executada em um participantTag=“LEG-B” ou em um CallId correspondente.

Essa ação se aplica somente ao callLeg que ingressa a partir do aplicativo de mídia SIP ao "+13605550122", LEG-B ou ao trecho do aplicativo de mídia SIP que ingressou à reunião.

{
"SchemaVersion": "1.0",
  "Actions": [
    {
      "Type" : "ModifyChimeMeetingAttendees",
      "Parameters" : {
        "Operation": "Mute",
        "MeetingId": "meeting-id",
        "CallId": "call-id",
        "ParticipantTag": LEG-B",
        "AttendeeList": ["attendee-id-1", "attendee-id-2"]
      }
    }
  ]
}
Operation

Descrição – A operação a ser executada na lista de participantes

Valores permitidos: ativar, desativar áudio

Obrigatório – Sim

Valor padrão: nenhum

MeetingId

Descrição – O ID da reunião à qual os participantes pertencem

Valores permitidos: um ID de reunião válido. A pessoa que está ativando ou desativando o áudio também deve pertencer à reunião.

Obrigatório – Sim

Valor padrão: nenhum

CallId

Descrição – O ID da reunião à qual os participantes pertencem

Valores permitidos: um ID de chamada válido.

Obrigatório – Não

Valor padrão: nenhum

ParticipantTag

Descrição – A tag atribuída ao participante.

Valores permitidos: uma tag válida.

Obrigatório – Não

Valor padrão: nenhum

AttendeeList

Descrição – Lista de IDs de participantes para ativar ou desativar o áudio

Valores permitidos: uma lista de IDs de participantes válidos

Obrigatório – Sim

Valor-padrão: nenhum, máximo de 100

Depois de executar essa ação, o serviço de áudio sempre invoca um perfil AWS Lambda com o tipo de evento de invocação ACTION_SUCCESSFUL ou ACTION_FAILED. O código do exemplo a seguir mostra um evento de invocação ACTION_SUCCESSFUL típico.

{
    "SchemaVersion": "1.0",
    "Sequence": INTEGER,
    "InvocationEventType": "ACTION_SUCCESSFUL",
    "ActionData": {
        "Type" : "ModifyChimeMeetingAttendees",
        "Parameters" : {
            "Operation": "Mute",
            "MeetingId": "meeting-id",
            "CallId": "call-id",
            "ParticipantTag": "LEG-B",
            "AttendeeList": ["attendee-id-1", "attendee-id-2"]
        }
    }
    "CallDetails": {
        ...
    }
}
Tratamento de erros

Em casos de parâmetros de instrução inválidos ou falhas de API, os aplicativos de mídia SIP chamam um perfil AWS Lambda com a mensagem de erro específica da instrução ou API com falha.

Erro Message Motivo

InvalidActionParameter

O valor do parâmetro ModifyChimeMeetingAttendees Operation é inválido

O valor Operation deve ser Desativar ou Ativar.

O valor do parâmetro ID da reunião é inválido.

O ID da reunião está vazio.

O valor do parâmetro Lista de participantes é inválido.

A lista de IDs de participantes está vazia ou excede o máximo de 100.

Ação inválida na chamada.

A ligação não foi ancorada.

A chamada não está conectada ao Chime Meeting.

O participante não está conectado ao Chime Meeting.

Um ou mais participantes não fazem parte dessa reunião. Todos os participantes devem fazer parte dessa reunião.

O participante não está autorizado a modificar os participantes da reunião.

SystemException

Erro do sistema ao executar a ação.

Ocorreu um erro do sistema na execução de uma ação.

O código do exemplo a seguir mostra um evento de falha típico:

{
    "SchemaVersion": "1.0",
    "Sequence": INTEGER,
    "InvocationEventType": "ACTION_FAILED",
    "ActionData": {
        "Type" : "ModifyChimeMeetingAttendees",
        "Parameters" : {
            "Operation": "Mute",
            "MeetingId": "meeting-id",
            "CallId": "call-id",
            "ParticipantTag": "LEG-B",
            "AttendeeList": ["attendee-id-1", "attendee-id-2"]
        },
        "ErrorType": "",
        "ErrorMessage": "",
        "ErrorList": []
    }
    "CallDetails": {
        ...
    }
}

Veja exemplos de trabalho no GitHub: