

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

**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-ligar](https://github.com/aws-samples/amazon-chime-sma-update-call)