Integración domótica Sennheiser AMBEO Soundbar, gratuita y de código abierto
Controla las barras de sonido Sennheiser AMBEO Max, Plus y Mini en tu red local.
Publicado por tomgermany
- Dispositivos
- Versión 1.1.1
- Requiere Gladys >=5.1.0
- ★ 0
Controla una barra de sonido AMBEO Max, Plus o Mini a través de tu red local (sin nube). La Plus es el modelo de referencia; la Mini y la Max se admiten de la misma forma.
Puesta en marcha
- Busca la dirección IP de la barra (app Smart Control o tu router).
- Introdúcela en la pantalla Configuración de la integración.
- Pulsa Probar la conexión: la integración consulta la barra y dice lo que ha respondido (modelo, firmware, número de entradas, volumen). Si da error, la dirección es incorrecta o no se puede alcanzar la barra en su puerto 80.
- Lanza una búsqueda de dispositivos: se crea un dispositivo con todos los ajustes que admite tu modelo.
Funciones del dispositivo
Encendido, volumen, silencio, entrada, perfil de sonido, modo noche, modo AMBEO, mejora de voz, retorno sonoro, altavoz de graves, brillo de LED/logo/pantalla, emparejamiento Bluetooth, modo eco, códec de audio y reproducción actual (solo lectura). Las Plus y Mini exponen además el volumen central; la Max expone el nivel AMBEO y los niveles central/lateral/superior.
El encendido depende del modelo: la Max se puede despertar y poner en espera, el botón del widget se oculta en los demás modelos.
Un modelo que no responde a todo un grupo de ajustes (algunas versiones de firmware) aparece igualmente: lo que no responde se registra en el log y se ignora.
Widget «Mando de la barra de sonido»
Encendido/apagado, volumen −/+ (paso configurable), silencio y un botón que recorre las entradas que la propia barra comunica. La entrada activa aparece en la fila de estado, y el botón de entrada muestra a cuál va a cambiar.
En los ajustes del widget puedes elegir la barra que controla esa tarjeta y ocultar los botones de volumen si prefieres dejar libre ese hueco.
Escenas
Acción «Reproducir un sonido en la barra de sonido» reproduce un MP3 o WAV:
- Archivo de la carpeta «sounds»: la integración sirve el archivo ella misma y la
barra lo descarga. La carpeta vive en el volumen de datos de la integración y el
sonido por defecto se indica en la configuración (deja vacío el campo de la escena
para usarlo). Se incluye un tono de ejemplo de tres segundos (
tone.wav) que se instala en el primer arranque. - URL http(s): un enlace directo al archivo, accesible desde la barra.
El campo volumen opcional ajusta el volumen antes de reproducir.
Acción «Leer el estado de la barra de sonido» devuelve volumen, silencio, entrada,
perfil de sonido y códec, legibles por los pasos siguientes como {{outputs.<clave>}}.
Acción «Ajustar el volumen de la barra» fija un volumen absoluto.
Disparador «El volumen cruza un límite» se activa cuando el volumen supera el límite de «demasiado alto» o baja del de «demasiado bajo» configurados. Lleva la dirección, el límite y el nuevo volumen. Se activa una vez por cruce: para una simple condición «volumen por encima de X», usa el disparador «el estado de un dispositivo cambia» de Gladys sobre la función de volumen.
Notas
La API de la barra no está documentada oficialmente; las rutas siguen la biblioteca de código abierto pyambeo. La reproducción de un archivo aún no se ha verificado en un dispositivo.
Aviso legal
Este es un proyecto independiente y no oficial. No está afiliado, autorizado, respaldado ni patrocinado por Sennheiser electronic SE & Co. KG ni por ninguna de sus filiales, y no es un producto ni un servicio oficial de Sennheiser.
Sennheiser y AMBEO son marcas comerciales o marcas registradas de Sennheiser electronic SE & Co. KG, utilizadas aquí únicamente para describir el hardware con el que funciona esta integración. Todas las demás marcas, nombres de productos y nombres de empresas pertenecen a sus respectivos propietarios.
Parámetros de configuración
Estos son los parámetros que Sennheiser AMBEO Soundbar te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Dirección IP de la barra de sonido | string | Sí | Dirección IP o nombre de host de la barra (en la app Smart Control o en tu router). |
| Intervalo de actualización (s) | number | No | Cada cuánto se lee el estado, en segundos (mínimo un minuto). |
| Paso de volumen del widget | number | No | Unidades de volumen que suman o restan los botones de subir y bajar. |
| Sonidos de las escenas | section | No | Los archivos de sonido los sirve la propia integración en su puerto: ábrelo, deja allí tus MP3 o WAV y recarga esta pantalla. En el primer arranque se instala un tono de ejemplo de tres segundos. |
| Archivo de sonido por defecto | string | No | Nombre del archivo que se reproduce cuando una escena no indica ninguno. Ejemplos: tone.wav, o tone.mp3 en cuanto lo añadas. |
| Demasiado alto por encima de | number | No | Activa «el volumen cruza un límite» cuando el volumen supera este valor. 0 lo desactiva. |
| Demasiado bajo por debajo de | number | No | Activa «el volumen cruza un límite» cuando el volumen baja de este valor. 0 lo desactiva. |
Cómo instalar Sennheiser AMBEO Soundbar en Gladys
- En Gladys, abre Integraciones: Sennheiser AMBEO Soundbar 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/tomgermany/gladys-sennheiser-ambeo:1.1.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/tomgermany/gladys-sennheiser-ambeo.
Sennheiser AMBEO Soundbar 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
Sennheiser AMBEO Soundbar 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 tomgermany, 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