

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 al `"+` *13605550122* `"` LEG-B o al tramo que se une desde la aplicación multimedia SIP a la reunión.

```
{
"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 asistentes IDs a los que se debe silenciar o reactivar  
*Valores permitidos: lista* de asistentes válidos IDs  
*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-llamar](https://github.com/aws-samples/amazon-chime-sma-update-call)