Integración domótica LinkPlay (WiiM, Arylic…), gratuita y de código abierto
Controle WiiM, Arylic, Audio Pro y otros reproductores LinkPlay: fuentes, preajustes, grupos. Local.
Publicado por guim31
- Dispositivos
- Versión 1.0.1
- Requiere Gladys >=5.2.0
- ★ 0
Controle desde Gladys sus streamers y altavoces basados en la plataforma LinkPlay — WiiM, Arylic, Audio Pro, iEAST, ArtSound y otros — 100 % en local: reproducción, volumen, fuentes, preajustes, grupos multiroom, anuncios.
Esta integración no está afiliada a LinkPlay, WiiM, Arylic ni Audio Pro. Desarrollada sin el hardware: sus comentarios son bienvenidos. Sigue la API HTTP común a estos reproductores y las respuestas de reproductores reales publicadas por el proyecto Home Assistant; díganos qué funciona y qué no en su modelo.
Presentación
La integración habla con cada reproductor mediante su API HTTP local
(/httpapi.asp), la misma en todos los firmwares LinkPlay. Sin cuenta ni
nube.
Reproductores conocidos: WiiM Mini, Pro, Pro Plus, Amp, Amp Pro, Amp Ultra, Ultra; Arylic Up2Stream (Amp, Pro, Mini, Plate Amp), S10+, S50+, S50 Pro, A30, A50, A50+; Audio Pro C3, C10, A10 (primera generación); iEAST AudioCast M5; ArtSound Smart Zone 4, Smart Hyde; GGMM E2; modelos de Medion, August, Triangle y Muzo. Los demás reproductores LinkPlay suelen funcionar también, con un nombre genérico.
¿LinkPlay o DLNA? La integración DLNA reproduce medios en cualquier reproductor UPnP, reproductores LinkPlay incluidos. LinkPlay es el control completo de estos reproductores: entradas (TV, óptica, Bluetooth...), preajustes, grupos multiroom, ecualizador WiiM, anuncios sobre la música. Elija una de las dos para cada reproductor, para no tenerlo dos veces en Gladys.
Requisitos
- Gladys 5.2.0 o posterior.
- Los reproductores en la red de Gladys, ya configurados con su aplicación (WiiM Home, 4STREAM, Audio Pro...).
- Para el descubrimiento automático, Gladys y los reproductores en la misma red (mDNS y SSDP no atraviesan los routers). Si no, indique sus direcciones.
Configuración
Encontrar los reproductores
Abra la pestaña Descubrir de la integración: los reproductores encontrados
por Gladys (mDNS _linkplay._tcp y SSDP) aparecen allí; añada los que desee.
Un reproductor que sigue a un grupo multiroom se encuentra a través del líder
del grupo.
Campos de configuración
| Campo | Uso |
|---|---|
| Direcciones de los reproductores | Opcional. Direcciones IP o nombres de host, separados por comas, para los reproductores que el descubrimiento no ve (otra red, VLAN). Puede indicar http:// o un puerto cuando un reproductor lo necesita. |
| Idioma de los nombres y mensajes | Nombres de las funciones de los reproductores añadidos a partir de ahora (Gladys los conserva una vez añadido el reproductor), nombres de las fuentes, mensajes de comandos y escenas. Francés por defecto. |
Acciones
- Buscar reproductores: busca ahora, actualiza la pestaña Descubrir y lista lo que ha respondido, las direcciones configuradas que no respondieron y las entradas ignoradas.
- Probar una dirección: consulta una dirección y muestra el modelo, el firmware, cómo responde (HTTPS o HTTP) y sus fuentes.
Qué hace cada reproductor
Cada reproductor es un dispositivo de Gladys, con el nombre de su aplicación.
Reproducción y volumen
| Función | Tipo | Qué hace |
|---|---|---|
| Reproducir | music / play | Reanuda la reproducción |
| Pausa | music / pause | Pone en pausa |
| Detener | television / stop | Detiene (un botón en la tarjeta de la habitación) |
| Anterior, Siguiente | music / previous, next | Pista anterior o siguiente |
| Volumen | music / volume (0-100) | Lee y ajusta el volumen |
| Silenciar | television / volume-mute | Silencia, o devuelve el sonido si está silenciado (botón) |
| Estado de reproducción | music / playback_state | 1 durante la reproducción, 0 si no (en el historial) |
El widget Música del panel de Gladys utiliza estas funciones.
Fuente y ecualizador
- Fuente (una lista): las entradas de este reproductor — red (Wi-Fi), Bluetooth, entrada de línea, óptica, coaxial, HDMI / ARC, phono, USB... Elegir una cambia el reproductor a ella. Un reproductor que sigue a un grupo no tiene fuente propia.
- Ecualizador (solo WiiM): los preajustes de ecualizador del WiiM (Flat, Rock, Jazz...) o «Desactivado». La API de WiiM indica si el ecualizador está activo, no cuál: uno elegido en la aplicación WiiM Home queda desconocido hasta que lo elija en Gladys.
Títulos y grupo
- Título, Artista, Álbum: lo que suena; «—» cuando la fuente no da nada (una entrada, un reproductor que sigue a un grupo).
- Grupo multiroom: «Sin agrupar», «Dirige: Cocina, Dormitorio» o «Sigue a: Salón».
Hablar en un altavoz
La acción Hablar en un altavoz de las escenas de Gladys habla en el reproductor. En un WiiM, el anuncio suena sobre la música, que se reanuda después. En un firmware sin ese comando, el anuncio sustituye a la música: si sonaba una entrada (TV, línea...), el reproductor vuelve a ella después; un flujo de red (Spotify, una radio web) no se reinicia — vuelva a lanzarlo con un preajuste en la siguiente acción de la escena. Gladys no transmite el volumen de la acción a la integración.
Widget
El widget LinkPlay (panel → añadir un cuadro → LinkPlay, y luego elegir el reproductor) muestra el título, el artista y el álbum, el volumen en directo, la fuente, el estado y el grupo, y cuatro botones: Anterior, Reproducir / Pausa, Siguiente y Preajustes, que abre la lista de preajustes (con su nombre en un WiiM) y reproduce el elegido.
Disparador de escena
Fuente LinkPlay cambiada: un reproductor ha cambiado de entrada. Filtros: el reproductor (vacío: cualquiera) y las nuevas fuentes (vacío: cualquiera). Variables: reproductor, nueva fuente (su nombre y su clave), fuente anterior (clave).
No se dispara para una fuente elegida desde Gladys (una escena podría entrar en bucle), ni durante un anuncio.
Acciones de escena
| Acción | Campos | Resultado |
|---|---|---|
| Reproducir un preajuste LinkPlay | Reproductor, número del preajuste, volumen (opcional) | Nombre del preajuste (WiiM) |
| Reproducir una dirección en LinkPlay | Reproductor, dirección http(s), volumen (opcional) | — |
| Agrupar reproductores LinkPlay | Reproductor que se une, líder del grupo | — |
| Desagrupar un reproductor LinkPlay | Reproductor | — |
Los preajustes son los guardados en la aplicación del reproductor (de 6 a 12 según el modelo). Desagrupar un líder de grupo disuelve todo su grupo.
Ejemplos de escenas
- Noche de cine: disparador «Fuente LinkPlay cambiada», reproductor «Salón», fuente «HDMI ARC» → bajar las luces del salón.
- Despertador: cada día laborable a las 7:00 → «Reproducir un preajuste LinkPlay» en «Cocina», preajuste 1, volumen 20, y luego «Agrupar reproductores LinkPlay»: «Baño» se une a «Cocina».
- Timbre: suena el timbre → «Hablar en un altavoz» en «Salón»: «Hay alguien en la puerta».
- Salir de casa: la casa está vacía → «Desagrupar» y luego detener cada reproductor.
Actualización y tráfico de red
La integración consulta por sí misma los reproductores añadidos a Gladys: cada 5 segundos durante la reproducción, cada 30 segundos si no, cada minuto mientras un reproductor no responde, y justo después de una orden. Una consulta son una o dos peticiones en la red local; el grupo y el ecualizador se leen cada 30 segundos, los detalles del reproductor cada 10 minutos. Los reproductores no tienen cuota; nada sale de su red.
Solo los valores que cambian se envían a Gladys (y cada 6 horas de todos modos, para que Gladys nunca los muestre como antiguos). La red se explora al arrancar, con Buscar reproductores y cada 5 minutos mientras falta un reproductor añadido (una nueva dirección tras reiniciar el router se encuentra sola).
Solución de problemas
- No se encuentra un reproductor: está en otra red, o mDNS / SSDP no llegan a Gladys. Use Probar una dirección y luego añada su dirección en la configuración.
- «no responde»: compruebe que el reproductor está encendido y en la red. La integración prueba HTTPS (puerto 443, se acepta el certificado autofirmado del reproductor) y luego HTTP (puerto 80).
- Falta una fuente en la lista: el reproductor no la declara; indíquenos su modelo.
- Los títulos muestran «—»: la fuente no da títulos (una entrada, algunos servicios).
- Más detalles: ponga la variable
LOG_LEVELde la integración endebug; los registros nunca muestran entera la dirección de un anuncio.
Limitaciones
- Desarrollada sin el hardware: los comandos vienen de la API LinkPlay común y de respuestas públicas de reproductores reales, no de una prueba en cada modelo.
- Los reproductores Audio Pro recientes que solo responden en el puerto 4443 con un certificado de cliente aún no son compatibles.
- Los nombres de los preajustes solo vienen de los WiiM; en los demás, los preajustes van numerados.
- Sin avance, aleatorio ni repetición, ni exploración de una biblioteca musical: eso lo hace la integración DLNA.
- Un reproductor que sigue a un grupo no muestra títulos; el volumen de un grupo entero no se gestiona (cada reproductor conserva el suyo).
- El estado del ecualizador es desconocido cuando se cambia desde la aplicación WiiM Home.
Parámetros de configuración
Estos son los parámetros que LinkPlay (WiiM, Arylic…) te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Encontrar sus reproductores | section | No | Los reproductores LinkPlay de su red (WiiM, Arylic, Audio Pro, iEAST...) se encuentran automáticamente: abra la pestaña Descubrir y añada los que desee. Un reproductor en otra red (VLAN, otra subred) se añade por su dirección más abajo. |
| Direcciones de los reproductores (opcional) | string | No | Una o varias direcciones IP o nombres de host, separados por comas. La acción «Probar una dirección» comprueba una primero. |
| Idioma de los nombres y mensajes | select | No | Nombres de las funciones de los reproductores añadidos a partir de ahora (Gladys los conserva una vez añadido el reproductor), nombres de las fuentes y mensajes de comandos y escenas. |
Cómo instalar LinkPlay (WiiM, Arylic…) en Gladys
- En Gladys, abre Integraciones: LinkPlay (WiiM, Arylic…) 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-linkplay: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-linkplay.
LinkPlay (WiiM, Arylic…) requiere Gladys >=5.2.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
LinkPlay (WiiM, Arylic…) 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 externas
- Descubrir las integraciones nativas incluidas en Gladys
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación