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.
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 a la reunión desde la aplicación multimedia SIP.
{
"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 |
|---|---|---|
|
|
El valor del parámetro |
El valor de |
|
|
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. |
|
|
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:
