As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
ModifyChimeMeetingAttendee(silenciando e reativando 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 uma AWS Lambda função com a mensagem de erro específica da instrução ou API com falha.
| Erro | Message | Motivo |
|---|---|---|
|
|
O valor do parâmetro |
O valor |
|
|
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. |
|
|
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 em GitHub:
