Integración comunitaria AirPlay, gratuita y de código abierto
Notificaciones de voz, timbres y audio en sus altavoces AirPlay (HomePod, Apple TV…).
Publicado por gboulvin
- Dispositivos
- Versión 2.0.0
- Requiere Gladys >=5.3.0
- ★ 0
Reproduzca notificaciones de voz, timbres y archivos de audio en sus altavoces AirPlay desde Gladys: HomePod y HomePod mini, Apple TV, AirPort Express, y los altavoces y receptores de otras marcas compatibles con AirPlay o AirPlay 2 (Sonos, Bose, Denon/Marantz, Yamaha, Bang & Olufsen, Libratone…).
Esta integración sustituye al servicio AirPlay integrado en Gladys y añade un volumen por altavoz, timbres integrados, acciones y disparadores de escena y un widget para el panel.
Dónde funciona
- Países: en todas partes. La integración solo se comunica con los altavoces en su red local; no depende de ningún país, cuenta de fabricante ni servicio en línea.
- Red: los altavoces deben estar en la misma red local (misma subred) que el servidor Gladys. Un altavoz en una Wi-Fi de invitados, una VLAN separada o detrás de una VPN no se encuentra.
- Internet: no hace falta para reproducir un timbre, un archivo o un flujo de su red local. Las notificaciones de voz usan la voz sintetizada elegida en Gladys: Gladys Plus por defecto (requiere internet), o una integración local de síntesis de voz.
- Idiomas: inglés, francés, alemán y español.
Requisitos
- Gladys Assistant 5.3.0 o posterior.
- En la app Casa de su iPhone (Ajustes de la casa > Altavoces y TV), Permitir acceso a altavoces y TV debe estar en Todos o Cualquiera en la misma red. «Solo las personas que comparten esta casa» bloquea a Gladys.
- Si definió una contraseña AirPlay, indíquela en la configuración.
Instalación
- Instale AirPlay desde el catálogo de integraciones de Gladys.
- Abra la pestaña Descubrimiento: sus altavoces aparecen en unos segundos. Pulse Crear en cada altavoz que quiera añadir.
- Use el botón Probar un altavoz de la pestaña Configuración: el altavoz elegido reproduce un timbre de dos tonos.
Desde el servicio AirPlay integrado
Los altavoces del servicio integrado y los de esta integración son dispositivos distintos. Una vez creados aquí sus altavoces:
- Edite las escenas que usan Reproducir una notificación y elija los nuevos altavoces.
- Elimine los altavoces antiguos de la integración AirPlay integrada.
Configuración
| Ajuste | Por defecto | Efecto |
|---|---|---|
| Volumen por defecto (%) | 70 | Volumen de un altavoz cuyo volumen nunca se ajustó en Gladys. |
| Duración máxima (s) | 300 | Toda reproducción se detiene tras este tiempo (10 a 1800 s). |
| Comprobación de disponibilidad (s) | 300 | Frecuencia de comprobación (60 a 3600 s). Alimenta los disparadores desconectado/conectado. |
| Protocolo AirPlay | Automático | Automático lee lo que anuncia cada altavoz. Fuerce AirPlay 1 para un receptor antiguo mudo. |
| Nombre del emisor | Gladys | Nombre que muestran los altavoces que indican quién reproduce. |
| Contraseña AirPlay | (vacío) | Solo para altavoces protegidos con contraseña. |
Sus altavoces en Gladys
Cada altavoz es un dispositivo con cuatro funciones:
- Notificación — la usa la acción de escena Reproducir una notificación de Gladys: el texto se convierte en voz y se reproduce en el altavoz.
- Volumen — el volumen de reproducción de Gladys (0 a 100 %). AirPlay no puede leer el volumen de un altavoz en reposo: es un ajuste propio de Gladys, guardado por altavoz; cambiarlo durante una reproducción lo aplica al instante.
- Estado de reproducción — reproduciendo o inactivo.
- Reproduciendo ahora — lo que Gladys está reproduciendo.
La tarjeta del dispositivo muestra una insignia local cuando el altavoz responde, e inaccesible cuando no.
Escenas
Acciones
- Reproducir una notificación (integrada en Gladys) — dice un texto en un altavoz.
- Reproducir una URL de audio en AirPlay — reproduce un archivo de sonido
o un flujo (MP3, AAC, WAV, OGG, FLAC, radio por internet…) desde una
dirección
http://ohttps://, con un volumen opcional. Con Esperar hasta el final, la escena espera al final del audio (100 s como máximo). Salidas: Reproducción iniciada y Duración reproducida. - Reproducir un timbre en AirPlay — un sonido integrado: Timbre, Notificación o Alerta. No necesita internet ni síntesis de voz: ideal para un timbre de puerta o una alarma.
- Detener la reproducción AirPlay — detiene lo que Gladys reproduce en un altavoz.
Un altavoz que no responde no detiene la escena: Reproducción iniciada vale entonces falso; úsela en una condición para enviar un mensaje en su lugar.
Disparadores
- Altavoz AirPlay desconectado — un altavoz dejó de responder (desenchufado, Wi-Fi perdido…).
- Altavoz AirPlay conectado de nuevo — un altavoz vuelve a responder.
Deje el altavoz vacío para reaccionar a cualquiera. El nombre del altavoz
está disponible como {{triggerEvent.data.name}}. La detección sigue el
intervalo de Comprobación de disponibilidad.
Panel
Añada el widget Altavoces AirPlay:
- sin altavoz elegido, lista sus altavoces con su estado (accesible, inaccesible, reproduciendo) y un botón Comprobar;
- con un altavoz elegido, muestra su volumen, su estado, su dirección y su protocolo, y los botones Timbre, Reproducir URL y Detener.
Limitaciones
- Solo audio: sin vídeo ni duplicación de pantalla.
- Un altavoz por reproducción: sin multiroom sincronizado.
- Gladys no transmite a las integraciones externas el volumen elegido en Reproducir una notificación: la notificación suena al Volumen del altavoz. Para hablar más alto o más bajo en una escena, ajuste antes el volumen con una acción Controlar un dispositivo.
- Gladys emite en su propia sesión AirPlay: una reproducción interrumpe lo que sonaba en el altavoz (Apple Music, Spotify…), que no se reanuda después.
- HomePod y Apple TV solo reproducen AirPlay 2 (desde su OS 27 aceptan una sesión AirPlay 1 pero no suenan), y solo con un reloj PTP que Gladys sirve en los puertos UDP 319 y 320. La integración se ejecuta en un contenedor Docker en su propia red: si el altavoz no puede alcanzar ese reloj, acepta la sesión y no suena, o la integración indica que el reloj PTP no se puede servir. Los altavoces AirPlay 2 de otras marcas recurren a un reloj NTP, y los receptores AirPlay 1 no lo necesitan.
- La contraseña AirPlay solo se aplica a los altavoces AirPlay 2.
- Un Apple TV o HomePod configurado en «Solo las personas que comparten esta casa» rechaza a Gladys (vea los requisitos).
Solución de problemas
| Síntoma | Qué hacer |
|---|---|
| Ningún altavoz en la pestaña Descubrimiento | Compruebe que el altavoz está encendido y en la misma red que Gladys, y vuelva a abrir la pestaña. |
| «El altavoz no responde» | Despierte el altavoz (reproduzca algo desde su teléfono), compruebe que su IP no ha cambiado. |
| «El altavoz pide una contraseña» | Indique la contraseña AirPlay en la configuración. |
| «El altavoz rechazó el emparejamiento» | App Casa > Ajustes de la casa > Altavoces y TV > permita a todos en la misma red. |
| La notificación suena sin voz | Compruebe la voz elegida en Gladys (ajustes de Inteligencia artificial) y su suscripción. |
| El timbre de prueba no suena | Altavoz de otra marca: cambie el protocolo a AirPlay 1 (RAOP) o AirPlay 2 y vuelva a probar. HomePod y Apple TV: vea las limitaciones. |
| «necesita un reloj PTP» | Los puertos UDP 319/320 están ocupados o prohibidos en el servidor Gladys: vea las limitaciones. |
La integración registra cada reproducción (altavoz, dirección, protocolo, causa de un fallo) en su pestaña Registros.
Parámetros de configuración
Estos son los parámetros que AirPlay te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Antes de empezar | section | No | Todo se queda en su red local: sin cuenta ni nube. Sus altavoces deben estar en la misma red que Gladys y permitir AirPlay a «Todos en la misma red» (app Casa > Ajustes de la casa > Altavoces y TV). Añádalos desde la pestaña Descubrimiento. Las notificaciones de voz usan la voz sintetizada de Gladys (Gladys Plus por defecto). |
| Volumen por defecto (%) | number | No | Volumen de un altavoz cuyo volumen nunca se ajustó en Gladys. |
| Duración máxima (s) | number | No | Toda reproducción se detiene tras este tiempo, en segundos. |
| Comprobación de disponibilidad (s) | number | No | Frecuencia de comprobación de los altavoces, en segundos. Alimenta los disparadores de escena desconectado/conectado. |
| Protocolo AirPlay | select | No | Automático lee lo que anuncia cada altavoz. Fuerce AirPlay 1 para un receptor antiguo que se queda en silencio. |
| Nombre del emisor | string | No | Nombre que muestran los altavoces que indican quién reproduce. |
| Contraseña AirPlay | secret | No | Solo para altavoces AirPlay 2 protegidos con contraseña (si no, déjelo vacío). |
Cómo instalar AirPlay en Gladys
- En Gladys, abre Integraciones: AirPlay aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
- Haz clic en Instalar. Gladys descarga la imagen Docker (
ghcr.io/gboulvin/gladys-airplay:2.0.0), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración). - Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
- También puedes instalarla directamente desde la URL de su repositorio: https://github.com/gboulvin/Gladys-Airplay.
AirPlay requiere Gladys >=5.3.0. El catálogo de Gladys se actualiza cada hora, así que una nueva versión está disponible como máximo una hora después de publicarse.
¿Todavía no usas Gladys? Es gratuito y de código abierto: sigue la guía de instalación para empezar.
Sobre las integraciones externas
AirPlay es una integración externa: una integración comunitaria empaquetada como contenedor Docker y publicada en GitHub. Gladys la instala con un clic y la ejecuta en un entorno aislado del núcleo. La publica y mantiene gboulvin, no el equipo principal de Gladys.
- Explorar todas las integraciones, nativas y de la comunidad
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación