Integración domótica Sony Audio, gratuita y de código abierto

Barras de sonido, receptores y altavoces Sony: encendido, volumen, fuente y sonido, en local.
Controle sus barras de sonido, receptores AV y altavoces inalámbricos Sony desde Gladys, en su red local: encendido, volumen, silencio, fuente, modo de sonido, modo nocturno, mejora de voz y nivel del subwoofer, actualizados en tiempo real.
Desarrollada sin el hardware: sus comentarios son bienvenidos. Cuente qué funciona y qué no en github.com/guim31/gladys-songpal/issues, con el modelo de su dispositivo.
Esta integración no está afiliada a Sony ni respaldada por Sony.
Presentación
La integración se comunica con los dispositivos compatibles con la aplicación Sony Music Center (antes SongPal) mediante su API local Audio Control: barras de sonido (HT-A7000, HT-A5000, HT-ST5000, HT-ZF9, HT-XF9000, HT-NT5…), receptores AV (STR-DN1080, STR-AN1000, STR-AZ…), altavoces inalámbricos (SRS-X77, SRS-X99, SRS-ZR7…). Sin cuenta ni nube: todo se queda en su red.
- Encontrados por la búsqueda de la pestaña Descubrimiento (ninguna dirección que escribir).
- Un dispositivo de Gladys por producto, solo con las funciones que tiene.
- Actualizaciones en tiempo real: un cambio hecho con el mando, el televisor o la aplicación de Sony aparece en Gladys en menos de un segundo.
- Dos widgets del panel, un disparador y dos acciones de escena.
Los televisores Sony Bravia usan la misma API, pero se dejan a la integración Sony Bravia TV.
Requisitos
- Gladys 5.1.0 o posterior.
- El dispositivo conectado a su red (Wi-Fi o Ethernet), configurado una vez con la aplicación Sony Music Center.
- Espera de red activada («Espera de red», «Inicio rápido» o «Encendido remoto», según el modelo): sin ella, el dispositivo sale de la red en espera, y Gladys no puede encenderlo ni verlo.
- Gladys y el dispositivo en la misma red: la búsqueda usa SSDP (UPnP), retransmitido por Gladys. Entre subredes, escriba la dirección del dispositivo en la configuración.
Instalación y configuración
- En Gladys, abra Integraciones → Instalar desde GitHub e instale
https://github.com/guim31/gladys-songpal(o instale Sony Audio desde la tienda). - Encienda su dispositivo (no en espera) para que dé sus fuentes y sus ajustes de sonido.
- Abra la pestaña Descubrimiento de la integración y lance una búsqueda. Cada dispositivo encontrado aparece con sus funciones: añádalo a Gladys.
- Opcional, en Configuración:
- Direcciones (opcional): solo para un dispositivo que la búsqueda no encuentra, su
dirección IP (varias separadas por comas, p. ej.
192.168.1.30, 192.168.1.31). Fíjela en su router. - Intervalo de lectura: cada cuánto se lee un dispositivo cuando no puede enviar sus cambios (30 segundos por defecto).
- Paso de volumen del widget: cuánto cambian el volumen los botones Volumen − y Volumen +.
- Idioma de los nombres de funciones: los nombres dados a las funciones de un dispositivo nuevo, y el idioma de los mensajes (francés por defecto).
- Direcciones (opcional): solo para un dispositivo que la búsqueda no encuentra, su
dirección IP (varias separadas por comas, p. ej.
- Probar la conexión lee cada dispositivo conocido e informa de lo que encuentra: encendido o en espera, fuente, volumen, y si las actualizaciones en directo funcionan.
Dispositivos y funciones
Cada producto es un dispositivo, identificado por su dirección MAC (una nueva dirección IP dada por su router conserva el mismo dispositivo: lance de nuevo una búsqueda, se encuentra en su nueva dirección). Solo se crean las funciones que el dispositivo tiene:
| Función | Tipo de Gladys | Qué hace |
|---|---|---|
| Encendido / espera | interruptor | Encendido / en espera. |
| Volumen | volumen de la música | El volumen, en las unidades del dispositivo (a menudo de 0 a 50, de 0 a 74 en un receptor). |
| Silencio | interruptor | Silencio activado / desactivado. |
| Fuente | lista | Las entradas del dispositivo (HDMI, TV, óptica, analógica, Bluetooth…), con los nombres ajustados en él. «Otra (red, aplicación)» mientras suena Spotify, Chromecast o USB. |
| Modo de sonido | lista | Los modos de sonido del dispositivo (Standard, Cine, Música…), o los preajustes del ecualizador de un altavoz. |
| Modo nocturno | interruptor | El modo nocturno de una barra de sonido. |
| Mejora de voz | interruptor, o lista | Activada/desactivada, o los niveles (Type 1, 2, 3) de las barras de sonido más antiguas. |
| Nivel del subwoofer | regulador | El nivel del subwoofer, dentro de los límites del dispositivo (en pasos de 0,5 dB en un receptor). |
| Reproducir, Pausa, Anterior, Siguiente | botones de música | Solo en una fuente de red o USB: una entrada (HDMI, TV) reproduce lo que envía su dispositivo. |
| Reproducción | estado de reproducción | Reproduciendo o en pausa, para la caja Música del panel. |
Elegir una fuente mientras el dispositivo está en espera lo enciende primero. Un receptor se controla en su zona principal.
Widgets
- Mando Sony Audio: el dispositivo y su estado, su fuente, su modo de sonido y su volumen, con cuatro botones: Encender (o Espera), Volumen −, Volumen + y Silencio (su icono es una marca mientras está silenciado).
- Fuentes Sony Audio: cuatro fuentes favoritas en un toque, el dispositivo encendido si hace
falta. Escriba sus nombres en la configuración del widget (p. ej.
TV,HDMI 1,Bluetooth); vacíos, las primeras entradas conectadas. La fuente en uso lleva una marca.
Elija el dispositivo en la configuración de cada widget (si no, el primero).
Disparador de escena
Sony Audio: fuente cambiada: la entrada en uso ha cambiado, la cambie quien la cambie: el televisor por HDMI (encender el televisor suele pasar la barra de sonido a él), una consola, el mando, la aplicación de Sony o Gladys. El encendido cuenta cuando el dispositivo llega a otra fuente que la última.
- Filtros: el dispositivo, y la nueva fuente, escrita exactamente como en la lista de fuentes del
dispositivo (p. ej.
HDMI 1; vacío: cualquier fuente). - Variables: el nombre del dispositivo, la nueva fuente, la fuente anterior.
Acciones de escena
- Sony Audio: elegir una fuente: por su nombre tal como lo muestra el dispositivo (
TV,HDMI 1,Bluetooth; mayúsculas y espacios indiferentes). Enciende el dispositivo antes si es necesario. Devuelve la fuente elegida. - Sony Audio: ajustar el sonido: en un paso, el modo de sonido por su nombre (
Movie,Music), el modo nocturno y la mejora de voz (activado, desactivado o sin cambios), y el volumen. Enciende el dispositivo antes si es necesario. Devuelve el modo de sonido y el volumen.
Ejemplos de escenas
- Noche de cine: cuando se lanza la escena «Película», Sony Audio: elegir una fuente
TV, luego Sony Audio: ajustar el sonido conMovie, mejora de voz activada y volumen 18; baje las luces. - Calma por la noche: cada día a las 22:00, si la barra de sonido está encendida, active el Modo nocturno y baje el Nivel del subwoofer.
- Hora de la consola: con Sony Audio: fuente cambiada filtrado en
HDMI 2, encienda la lámpara del mueble del televisor y envíe el mensaje «La consola está encendida».
Solución de problemas
- La búsqueda no encuentra nada: compruebe que el dispositivo está en la misma red que Gladys, con la espera de red activada, y que aparece en la aplicación Sony Music Center. Su router puede bloquear el multicast entre Wi-Fi y Ethernet: escriba la dirección en Direcciones (opcional).
- «no responde (desenchufado, o espera de red desactivada)»: el dispositivo ha salido de la red. Active la espera de red en sus ajustes. Su dispositivo de Gladys se queda, su encendido se muestra apagado hasta que responda.
- Sin actualizaciones en directo (la prueba dice «sin actualizaciones en directo»): el dispositivo no acepta la conexión WebSocket; se lee en su lugar con el intervalo de lectura. Nada que cambiar.
- Falta una fuente o un modo de sonido: las listas son las que el dispositivo da cuando está encendido. Enciéndalo y lance de nuevo una búsqueda: las listas de un dispositivo añadido se actualizan sin tocarlo.
- Aparece una función tras una actualización: un dispositivo añadido en espera aún no tenía sus ajustes de sonido; la pestaña Descubrimiento propone actualizarlo.
- Registros: la integración escribe poco (inicio, dispositivos perdidos y recuperados, acciones
del usuario). Para más detalles, ajuste
LOG_LEVEL=debugen la integración.
Límites
- Desarrollada sin el hardware: construida a partir de la referencia de la API Sony Audio Control y de los proyectos libres que la usan. Algunos modelos pueden nombrar sus ajustes de otra forma.
- El dispositivo debe quedarse en la red en espera para encenderse desde Gladys (sin Wake-on-LAN).
- Solo la zona principal de un receptor; sin grupos multisala, sin favoritos, sin navegación por los servicios de red, sin bandas de ecualizador.
- Reproducir y pausar dependen de la fuente: una entrada HDMI o TV no se puede pausar desde la barra de sonido.
- El dispositivo se lee como mucho cada 10 segundos cuando no puede notificar, cada 5 minutos si no; la API es local, sin cuota.
- Los televisores Bravia se dejan a la integración Sony Bravia TV.
Parámetros de configuración
Estos son los parámetros que Sony Audio te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Sus dispositivos de audio Sony | section | No | Barras de sonido, receptores y altavoces compatibles con la aplicación Sony Music Center (antes SongPal). Conéctelos a su red, active la espera de red («Espera de red» o «Inicio rápido») para poder encenderlos desde Gladys y luego busque en la pestaña Descubrimiento de esta integración. |
| Direcciones (opcional) | string | No | Solo para un dispositivo que la búsqueda no encuentra: su dirección IP, varias separadas por comas. Fíjela en su router. |
| Opciones | section | No | Los dispositivos envían sus cambios en el momento. Cuando no pueden, se leen con este intervalo. |
| Intervalo de lectura | select | No | |
| Paso de volumen del widget | select | No | Cuánto cambian el volumen los botones Volumen − y Volumen +. |
| Idioma de los nombres de funciones | select | No | Para los nombres de las funciones de un dispositivo nuevo y los mensajes de la integración. |
Cómo instalar Sony Audio en Gladys
- En Gladys, abre Integraciones: Sony Audio 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/guim31/gladys-songpal:1.0.1), 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/guim31/gladys-songpal.
Sony Audio requiere Gladys >=5.1.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
Sony Audio 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 guim31, 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