Intégration domotique Sennheiser AMBEO Soundbar, gratuite et open source
Pilotez les barres de son Sennheiser AMBEO Max, Plus et Mini sur votre réseau local.
Publiée par tomgermany
- Appareils
- Version 1.1.1
- Nécessite Gladys >=5.1.0
- ★ 0
Pilote une barre de son AMBEO Max, Plus ou Mini sur votre réseau local (sans cloud). La Plus est le modèle de référence ; la Mini et la Max sont prises en charge de la même façon.
Mise en route
- Trouvez l'adresse IP de la barre (app Smart Control ou routeur).
- Saisissez-la dans l'écran Configuration de l'intégration.
- Appuyez sur Tester la connexion : l'intégration interroge la barre et dit ce qu'elle a répondu (modèle, firmware, nombre d'entrées, volume). En cas d'erreur, l'adresse est fausse ou la barre n'est pas joignable sur son port 80.
- Lancez une recherche d'appareils : un appareil avec tous les réglages de votre modèle est créé.
Fonctions de l'appareil
Marche/arrêt, volume, sourdine, entrée, profil sonore, mode nuit, mode AMBEO, amélioration des voix, retour sonore, caisson de basses, luminosité LED/logo/écran, appairage Bluetooth, mode éco, codec audio et lecture en cours (lecture seule). Les Plus et Mini exposent en plus le volume central ; la Max expose le niveau AMBEO et les niveaux centre/latéral/haut.
La marche/arrêt dépend du modèle : la Max peut être réveillée et mise en veille, le bouton du widget est masqué sur les autres modèles.
Un modèle qui ne répond pas à tout un groupe de réglages (certaines versions de firmware) apparaît quand même : ce qu'il ne répond pas est journalisé et ignoré.
Widget « Télécommande barre de son »
Marche/arrêt, volume −/+ (pas configurable), sourdine et un bouton par entrée sélectionnable.
Scènes
Action « Jouer un son sur la barre de son » joue un MP3 ou WAV :
- Fichier du dossier « sounds » : l'intégration sert le fichier elle-même et la barre
le récupère. Le dossier vit dans le volume de données de l'intégration, et le son par
défaut est nommé dans la configuration (laissez le champ de la scène vide pour l'utiliser).
Un son d'exemple de trois secondes (
tone.wav) est livré et installé au premier démarrage. - URL http(s) : un lien direct vers le fichier, joignable par la barre.
Le champ volume optionnel règle le volume avant la lecture.
Action « Lire l'état de la barre de son » renvoie volume, sourdine, entrée, profil
sonore et codec, lisibles par les étapes suivantes via {{outputs.<clé>}}.
Action « Régler le volume de la barre » règle un volume absolu.
Déclencheur « Le volume franchit une limite » se déclenche quand le volume passe au-dessus de la limite « trop fort » ou en dessous de la limite « trop faible » de la configuration. Il porte le sens, la limite et le nouveau volume. Il se déclenche une fois par franchissement : pour une simple condition « volume au-dessus de X », utilisez le déclencheur « l'état d'un appareil change » de Gladys sur la fonction volume.
Remarques
L'API de la barre n'est pas documentée officiellement ; les chemins suivent la bibliothèque open source pyambeo. La lecture d'un fichier n'est pas encore vérifiée sur un appareil.
Mention légale
Ce projet est indépendant et non officiel. Il n'est ni affilié, ni autorisé, ni approuvé, ni sponsorisé par Sennheiser electronic SE & Co. KG ni par aucune de ses filiales : ce n'est pas un produit ni un service officiel de Sennheiser.
Sennheiser et AMBEO sont des marques ou des marques déposées de Sennheiser electronic SE & Co. KG, utilisées ici uniquement pour décrire le matériel avec lequel cette intégration fonctionne. Toutes les autres marques, noms de produits et noms de sociétés appartiennent à leurs propriétaires respectifs.
Paramètres de configuration
Voici les paramètres demandés par Sennheiser AMBEO Soundbar dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Adresse IP de la barre de son | string | Oui | Adresse IP ou nom d'hôte de la barre de son (visible dans l'app Smart Control ou votre routeur). |
| Intervalle de rafraîchissement (s) | number | Non | Fréquence de lecture de l'état, en secondes (une minute minimum). |
| Pas de volume du widget | number | Non | Unités de volume ajoutées ou retirées par les boutons Plus fort / Moins fort. |
| Sons des scènes | section | Non | Les fichiers sons sont servis par l'intégration elle-même sur son propre port : ouvrez ce port, déposez vos MP3 ou WAV, puis rechargez cet écran. Un son d'exemple de trois secondes est installé au premier démarrage. |
| Fichier son par défaut | string | Non | Nom du fichier joué quand une scène n'en nomme pas. Fichiers d'exemple : tone.wav, ou tone.mp3 dès que vous l'ajoutez au dossier. |
| Trop fort au-delà de | number | Non | Déclenche « le volume franchit une limite » quand le volume dépasse cette valeur. 0 désactive. |
| Trop faible en dessous de | number | Non | Déclenche « le volume franchit une limite » quand le volume passe sous cette valeur. 0 désactive. |
Comment installer Sennheiser AMBEO Soundbar dans Gladys
- Dans Gladys, ouvrez Intégrations : Sennheiser AMBEO Soundbar apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
- Cliquez sur Installer. Gladys télécharge l'image Docker (
ghcr.io/tomgermany/gladys-sennheiser-ambeo:1.1.1), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration). - Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
- Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/tomgermany/gladys-sennheiser-ambeo.
Sennheiser AMBEO Soundbar nécessite Gladys >=5.1.0. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.
Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.
À propos des intégrations externes
Sennheiser AMBEO Soundbar est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par tomgermany, et non par l'équipe cœur de Gladys.
- Parcourir toutes les intégrations, natives et communautaires
- Créer et publier votre propre intégration externe
- Code source sur GitHub — source de cette documentation