Micrófono

Un objeto de tipo microphone representa el micrófono físico de un dispositivo integrado en Netsocs. Su función es capturar audio en tiempo real y transmitirlo como un flujo RTP hacia la plataforma, permitiendo monitoreo auditivo remoto o grabación de eventos.

A diferencia de un sensor, el micrófono no entrega datos puntuales sino un flujo continuo de audio. Su ciclo de vida alterna entre reposo (sin transmitir) y transmisión activa (sesión de audio en curso).

Características principales

• Captura de audio en tiempo real: Transmite paquetes RTP desde el dispositivo hasta DriversHub.
• Sesiones gestionadas: Cada sesión de audio tiene un identificador único (session_id) que permite abrir y cerrar flujos de forma independiente.
• Configuración de audio: El objeto expone parámetros del perfil de medio del dispositivo (códec, frecuencia de muestreo, canales).

Casos de uso comunes

• Monitoreo auditivo de instalaciones industriales o de seguridad.
• Grabación de audio asociada a eventos de video (cámaras IP con micrófono integrado).
• Detección de anomalías acústicas mediante automatizaciones que reaccionan al estado streaming.
• Sistemas de comunicación bidireccional junto con un objeto speaker.

Estados

Estado	Descripción
microphone.state.idle	El micrófono está disponible pero no transmite.
microphone.state.streaming	Hay una sesión de audio activa en curso.

Acciones

Acción	Descripción
microphone.action.start_stream	Inicia una sesión de captura de audio. Requiere session_id en el payload.
microphone.action.stop_stream	Detiene la sesión de audio activa para el session_id indicado.

Propiedades de estado

Propiedad	Descripción
profile_token	Token del perfil de medio del dispositivo.
source_token	Token de la fuente de audio en el dispositivo.
codec	Códec de audio utilizado (ej. G711, G726, AAC).
sample_rate	Frecuencia de muestreo en Hz (ej. 8000).
channels	Número de canales de audio (ej. 1 para mono).