Documentación: Nodo Reproducir Audio en Altavoz (Speaker Play Audio)¶

Descripción General¶

El Nodo Reproducir Audio en Altavoz (Speaker Play Audio) es un nodo de acción de la familia Communication que reproduce un archivo de audio en uno o varios objetos de tipo altavoz (speaker) registrados en la plataforma (por ejemplo, los altavoces integrados en cámaras ONVIF o dispositivos de audio IP).

En entornos IoT, de seguridad e industriales es el canal ideal para mensajes sonoros automáticos: difundir un mensaje de evacuación ante una alarma de incendio, emitir una advertencia disuasoria cuando se detecta intrusión en zona restringida, o anunciar avisos operativos en una planta.

¿Cuándo usar este nodo?¶

Utiliza este nodo cuando necesites:

Reproducir un mensaje o tono de alerta en altavoces de campo como respuesta a un evento (alarma, intrusión, incidente).
Emitir avisos disuasorios en tiempo real (por ejemplo, al detectar movimiento fuera de horario).
Difundir mensajes operativos programados o accionados por una automatización.
Reproducir el mismo audio en varios altavoces a la vez como parte de un protocolo de respuesta.

Configuración del Nodo¶

El nodo cuenta con dos pestañas de configuración: Formulario (Form) y Editor de JSON (JSON Editor).

Configuración vacía del nodo Reproducir Audio en Altavoz

Vista Formulario¶

1. Objetos Altavoz (Speaker Objects) *Requerido¶

Los altavoces donde se reproducirá el audio. El selector está filtrado automáticamente para mostrar solo objetos de tipo altavoz (speaker). Expande el dispositivo y marca el o los altavoces deseados. El audio se reproduce en todos los seleccionados.

2. URL del Audio (Audio URL) *Requerido¶

La URL pública del archivo de audio a reproducir (por ejemplo, un .mp3). Debe ser accesible desde el dispositivo/plataforma. Soporta expresiones de plantilla para usar audios dinámicos.

3. Tiempo de Espera (Timeout, segundos)¶

Tiempo máximo (en segundos) asociado a la reproducción. Con 0 se usa el comportamiento por defecto del controlador.

Formulario configurado del nodo Reproducir Audio en Altavoz

Vista Editor de JSON¶

Vista JSON Editor del nodo Reproducir Audio en Altavoz

Estructura JSON (Parámetros de entrada)¶

{
  "objects_id": ["onvif_standard.speaker.28.AudioOutput1"],
  "url": "https://cdn.netsocs.com/audio/evacuation_alert.mp3",
  "timeout": 30
}

Campos del JSON¶

Campo	Tipo	Descripción
`objects_id`	array (string)	IDs de los objetos altavoz donde se reproducirá el audio.
`url`	string	URL pública del archivo de audio. Soporta expresiones de plantilla.
`timeout`	number	Tiempo máximo (segundos) asociado a la reproducción (`0` = por defecto).

Output: Dónde viene la data del nodo¶

El nodo envía el comando de reproducción al controlador de cada altavoz seleccionado; no produce un payload de datos. Al ejecutarse correctamente, el nodo finaliza marcado como exitoso (borde verde). La reproducción efectiva depende de que el dispositivo de audio esté disponible y la URL sea accesible.

Ejemplos de uso¶

Ejemplo 1: Mensaje de evacuación ante alarma de incendio¶

Caso de uso: Al dispararse la alarma de incendio, se reproduce automáticamente un mensaje de evacuación en los altavoces de la zona afectada.

Speaker Objects: el altavoz de la cámara/dispositivo de la zona
Audio URL: https://cdn.netsocs.com/audio/evacuation_alert.mp3
Timeout: 30

(ver estructura JSON anterior)

Ejemplo 2: Aviso disuasorio por intrusión¶

Caso de uso: Cuando se detecta movimiento fuera de horario en una zona restringida, se emite un mensaje disuasorio por el altavoz más cercano.

Audio URL: https://cdn.netsocs.com/audio/restricted_area_warning.mp3

Validación y errores¶

Condición	Causa / Solución habitual
No se reproduce el audio	Verifica que la URL sea pública y accesible desde el dispositivo/plataforma.
No hay altavoces para seleccionar	El dispositivo no expone un objeto de tipo `speaker`; revisa que el altavoz esté integrado y habilitado.
Sin objetos seleccionados	Selecciona al menos un altavoz en Speaker Objects.

Buenas prácticas¶

Usar URLs públicas y estables: aloja los audios en una ubicación accesible y permanente para que el dispositivo pueda descargarlos.
Audios cortos y claros: prefiere mensajes breves y comprensibles para alertas y avisos.
Agrupar por zona: selecciona los altavoces de la zona relevante para cada escenario, evitando difundir en toda la instalación cuando no es necesario.
Combinar con otras acciones: encadena con notificaciones o con la activación de una alarma para un protocolo de respuesta completo.