

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# ModifyChimeMeetingAttendee (activación y desactivación del audio)
<a name="mute-unmute"></a>

Permite que la aplicación multimedia SIP modifique el estado de un asistente de telefonía al proporcionar el ID de reunión de Amazon Chime SDK y la lista de asistentes.

**nota**  
Actualmente, esta acción admite las operaciones de silenciamiento y reactivación del silencio de los asistentes de telefonía. Además, el usuario debe unirse a una reunión mediante la acción `JoinChimeMeeting`. Esta acción se puede realizar en un `participantTag=“LEG-B”`, o en un `CallId` correspondiente. 

Esta acción solo se aplica al CallLeg que se une desde la aplicación multimedia SIP a `"+` {{13605550122}} `"` la reunión o al tramo que se une desde la aplicación multimedia SIP a la reunión. LEG-B

```
{
"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**  
*Descripción:* la operación que se debe realizar en la lista de asistentes  
*Valores permitidos*: silenciar, reactivar el silencio  
*Obligatorio*: sí  
*Valor predeterminado:* ninguno

**MeetingId**  
*Descripción*: el ID de la reunión a la que pertenecen los asistentes  
*Valores permitidos*: un identificador de reunión válido. La persona que silencia o desactiva el sonido también debe pertenecer a la reunión.  
*Obligatorio*: sí  
*Valor predeterminado:* ninguno

**CallId**  
*Descripción*: el ID de la reunión a la que pertenecen los asistentes  
*Valores permitidos*: un identificador de llamada válido.  
*Obligatorio:* no  
*Valor predeterminado:* ninguno

**ParticipantTag**  
*Descripción*: la etiqueta asignada al asistente.  
*Valores permitidos*: una etiqueta válida.  
*Obligatorio:* no  
*Valor predeterminado:* ninguno

**AttendeeList**  
*Descripción*: lista de identificadores de asistentes para silenciar o volver a silenciar  
*Valores permitidos*: una lista de identificadores de asistentes válidos  
*Obligatorio*: sí  
*Valor predeterminado*: ninguno, máximo 100

Tras ejecutar esta acción, Audio Service siempre invoca una función de AWS Lambda con el tipo de evento de invocación `ACTION_SUCCESSFUL` o `ACTION_FAILED`. En el siguiente ejemplo de código se muestra un evento `ACTION_SUCCESSFUL` de invocación 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": {
        ...
    }
}
```

**Gestión de errores**  
En los casos de parámetros de instrucción no válidos o errores en la API, las aplicaciones multimedia SIP llaman a una AWS Lambda función con el mensaje de error específico de la instrucción o API fallida.


|  Error  |  Mensaje  |  Motivo  | 
| --- | --- | --- | 
| `InvalidActionParameter` | El valor del parámetro `ModifyChimeMeetingAttendees Operation` no es válido. | El valor de `Operation` debe ser silenciado o no silenciado. | 
|   | El valor del parámetro de ID de reunión no es válido. | La ID de la reunión está vacía. | 
|   | El valor del parámetro de la lista de asistentes no es válido. | La lista de identificadores de asistentes está vacía o supera el máximo de 100. | 
|   | Acción no válida en la llamada. | La llamada no está gestionada. | 
|   | La llamada no está conectada a Chime Meeting. | El asistente no está conectado a una reunión de Chime. | 
|   | Uno o más asistentes no forman parte de esta reunión. Todos los asistentes deben ser parte de esta reunión. | El asistente no está autorizado a modificar a los asistentes a la reunión. | 
| `SystemException` | Error del sistema al ejecutar la acción. | Se ha producido un error del sistema al ejecutar una acción. | 

En el siguiente ejemplo de código se muestra un evento de error 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": {
        ...
    }
}
```

Consulte algunos ejemplos prácticos en 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)