Altavoz

Un objeto de tipo speaker representa el altavoz o canal de retorno de audio (backchannel) de un dispositivo integrado en Netsocs. Su función es recibir audio desde la plataforma y reproducirlo en el dispositivo físico, habilitando la comunicación de voz en dirección operador → dispositivo.

Complementa al objeto microphone: mientras el micrófono capta audio del entorno, el altavoz permite que un operador hable hacia él. Juntos forman la base de un sistema de comunicación bidireccional.

Características principales

• Talkback en tiempo real: Recibe paquetes RTP desde DriversHub y los reenvía al canal de audio del dispositivo.
• Sesiones gestionadas: Cada sesión de talkback tiene un session_id único que permite gestionarlas de forma independiente.
• Configuración de salida: Expone parámetros del canal de audio del dispositivo (códec, frecuencia, nivel de volumen).

Casos de uso comunes

• Intercomunicadores y sistemas de megafonía IP.
• Instrucciones de voz en tiempo real hacia zonas vigiladas.
• Advertencias sonoras automáticas activadas por automatizaciones.
• Comunicación bidireccional en cámaras IP con altavoz integrado.

Estados

Estado	Descripción
speaker.state.idle	El altavoz está disponible pero no está reproduciendo audio.
speaker.state.talkback	Hay una sesión de talkback activa y el altavoz está en uso.

Acciones

Acción	Descripción
speaker.action.start_talkback	Inicia una sesión de talkback. Requiere session_id en el payload.
speaker.action.stop_talkback	Detiene la sesión de talkback activa para el session_id indicado.

Propiedades de estado

Propiedad	Descripción
profile_token	Token del perfil de medio del dispositivo.
output_token	Token de la salida de audio en el dispositivo.
decoder_token	Token del decodificador de audio para el backchannel.
codec	Códec de audio utilizado (ej. G711).
sample_rate	Frecuencia de muestreo en Hz (ej. 8000).
output_level	Nivel de volumen de salida de 0 a 100.