Saltar al contenido principal

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

Integración Sony Audio para Gladys Assistant

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​

  1. En Gladys, abra Integraciones → Instalar desde GitHub e instale https://github.com/guim31/gladys-songpal (o instale Sony Audio desde la tienda).
  2. Encienda su dispositivo (no en espera) para que dé sus fuentes y sus ajustes de sonido.
  3. 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.
  4. 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).
  5. 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ónTipo de GladysQué hace
Encendido / esperainterruptorEncendido / en espera.
Volumenvolumen de la músicaEl volumen, en las unidades del dispositivo (a menudo de 0 a 50, de 0 a 74 en un receptor).
SilenciointerruptorSilencio activado / desactivado.
FuentelistaLas 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 sonidolistaLos modos de sonido del dispositivo (Standard, Cine, Música…), o los preajustes del ecualizador de un altavoz.
Modo nocturnointerruptorEl modo nocturno de una barra de sonido.
Mejora de vozinterruptor, o listaActivada/desactivada, o los niveles (Type 1, 2, 3) de las barras de sonido más antiguas.
Nivel del subwooferreguladorEl nivel del subwoofer, dentro de los límites del dispositivo (en pasos de 0,5 dB en un receptor).
Reproducir, Pausa, Anterior, Siguientebotones de músicaSolo en una fuente de red o USB: una entrada (HDMI, TV) reproduce lo que envía su dispositivo.
Reproducciónestado de reproducciónReproduciendo 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 con Movie, 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=debug en 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ámetroTipoObligatorioDescripción
Sus dispositivos de audio SonysectionNoBarras 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)stringNoSolo para un dispositivo que la búsqueda no encuentra: su dirección IP, varias separadas por comas. Fíjela en su router.
OpcionessectionNoLos dispositivos envían sus cambios en el momento. Cuando no pueden, se leen con este intervalo.
Intervalo de lecturaselectNo
Paso de volumen del widgetselectNoCuánto cambian el volumen los botones Volumen − y Volumen +.
Idioma de los nombres de funcionesselectNoPara los nombres de las funciones de un dispositivo nuevo y los mensajes de la integración.

Cómo instalar Sony Audio en Gladys​

  1. En Gladys, abre Integraciones: Sony Audio aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
  2. 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).
  3. Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
  4. 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.

Suscríbete a la newsletter de Gladys Assistant

Unos pocos correos al mes sobre nuevas versiones y novedades del proyecto. Enviados por Pierre-Gilles Leymarie, fundador del proyecto. Puedes darte de baja cuando quieras 🙂