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á.
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 se junta do aplicativo de mídia SIP ao "+ 13605550122 " LEG-B ou ao trecho unido do aplicativo de mídia SIP à 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 participantes IDs para ativar ou desativar o som
Valores permitidos — Uma lista de participantes válidos IDs
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": { ... } }
Gerenciamento 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 | Mensagem | 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:
