

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 (silenciar e reativar o áudio)
<a name="mute-unmute"></a>

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 a `"+` {{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 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  |  Mensagem  |  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 em GitHub:
+ [https://github.com/aws-samples/amazon-chime-sma-bridging](https://github.com/aws-samples/amazon-chime-sma-bridging).
+ [https://github.com/aws-samples/amazon-chime-sma-update-call](https://github.com/aws-samples/amazon-chime-sma-update-call)