Aller au contenu principal

Intégration domotique Yoto Player Advanced, gratuite et open source

Intégration Yoto Player Advanced pour Gladys Assistant

Pilote un Yoto Player : veilleuse, volume, cartes et capteurs.

Voir sur GitHubToutes les intégrations

Cette intégration ajoute à Gladys Assistant chaque Yoto Player d'un compte Yoto : veilleuse, volume, capteurs, et lecture d'une carte depuis une scène. Gladys 5.3 ou plus récent est nécessaire.

Ce que vous obtenez​

Après la liaison du compte, chaque lecteur apparaît dans l'onglet Découverte. Une mise à jour du lecteur déjà ajouté (bouton Mettre à jour de cet onglet) ajoute les fonctionnalités nouvelles.

Commandes :

  • Veilleuse — marche/arrêt et couleur de l'anneau lumineux pour le profil en cours (jour ou nuit). L'arrêt envoie la couleur #0 de Yoto.
  • Luminosité — luminosité de l'écran de ce même profil, de 0 à 100. La valeur auto s'affiche comme 100 ; déplacer le curseur enregistre un nombre fixe.
  • Volume — de 0 à 100 %.
  • Volume max jour et Volume max nuit — les plafonds, affichés de 0 à 100 %. Le lecteur les enregistre sur sa molette à 17 crans : le curseur se cale sur le cran le plus proche.

Lecture seule :

  • Batterie, En charge (sur secteur, y compris batterie pleine), En ligne, Signal Wi-Fi, Lumière ambiante, Température.
  • Lecture et Carte en cours. Le titre, l'auteur et la pochette alimentent le lecteur musical de Gladys. La piste et la position ne sont pas disponibles : l'API ne les donne pas.

Tableau de bord​

Deux widgets : Lecteurs Yoto (tous les lecteurs du compte) et Lecteur Yoto (un lecteur, avec la courbe de batterie sur 24 h). Ils affichent la dernière lecture. Rafraîchir interroge le lecteur tout de suite.

Scènes​

Déclencheurs :

  • Une carte démarre — filtres : lecteur, titre exact. Variables : nom du lecteur, titre, identifiant.
  • Un lecteur arrête la lecture — filtre : lecteur.
  • Batterie faible — sous 20 %, une seule fois tant que le lecteur n'est pas rebranché ou remonté au-dessus de 25 %.

Actions :

  • Lire une carte Yoto — lecteur, identifiant de carte (par exemple 5WsQg), index de piste (0 = première piste du chapitre 01).
  • Lire l'état d'un lecteur Yoto — lit maintenant et passe batterie, volume, carte, température et veilleuse aux étapes suivantes.
  • Rafraîchir tous les lecteurs Yoto.

Le premier relevé après un démarrage ne déclenche pas de scène.

Configuration​

Ouvrez le site des applications Yoto, créez une application, puis ouvrez Edit Application.

  1. Application Type : laissez Public Client.
  2. Allowed Callback URLs : effacez l'exemple et mettez seulement https://my.gladysassistant.com/redirect/oauth.
  3. Scopes : cochez family:devices:control, family:devices:manage, family:view et offline_access. Les droits déjà marqués Included automatically suffisent, dont family:library:view pour le titre des cartes. Ne cochez pas family:library:manage ni user:content:manage.
  4. Laissez vides Description, Allowed Logout URLs, Application Logo et Application Privacy Policy URL.
  5. Cliquez sur Update Application.
  6. Dans Gladys, copiez le Client ID dans Identifiant. Laissez Secret vide, enregistrez, puis cliquez sur Lier mon compte Yoto. Connectez-vous avec le compte de la famille.
  7. Cliquez sur Tester la connexion Yoto. Les lecteurs apparaissent dans l'onglet Découverte.

La connexion se maintient toute seule. On ne la refait que si le mot de passe Yoto change, ou si l'application est retirée du compte.

Mise à jour des lecteurs règle le délai entre deux lectures. 300 correspond à 5 minutes, et Gladys ne peut pas descendre sous une minute. Demander un statut à jour demande au lecteur de se signaler avant la lecture. Décochez-le s'il se réveille trop souvent.

Paramètres de configuration​

Voici les paramètres demandés par Yoto Player Advanced dans son écran de configuration dans Gladys.

ParamètreTypeObligatoireDescription
Pour commencersectionNonSur le site Yoto, ouvrez Edit Application et laissez Application Type sur Public Client. Dans Allowed Callback URLs, effacez l'exemple et mettez seulement https://my.gladysassistant.com/redirect/oauth. Dans Scopes, cochez family:devices:control, family:devices:manage, family:view et offline_access. Les droits déjà marqués Included automatically suffisent. Laissez vides Description, Allowed Logout URLs, Application Logo et Application Privacy Policy URL, puis cliquez sur Update Application. Copiez le Client ID dans Identifiant, enregistrez, puis cliquez sur Lier mon compte Yoto.
IdentifiantstringOuiLe Client ID copié depuis votre application Yoto.
SecretsecretNonLaissez vide. Une application Public Client n'a pas de secret.
Lier mon compte Yotooauth2Non
Mise à jour des lecteurs (secondes)numberNonDélai entre deux lectures du lecteur. 300 correspond à 5 minutes.
Demander un statut à jour au lecteurbooleanNonAvant chaque lecture, demande au lecteur de se signaler. Décochez si le lecteur se réveille trop souvent.

Comment installer Yoto Player Advanced dans Gladys​

  1. Dans Gladys, ouvrez Intégrations : Yoto Player Advanced apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
  2. Cliquez sur Installer. Gladys télécharge l'image Docker (ghcr.io/b3n0/adavanced-yoto:1.0.6), 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).
  3. Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
  4. Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/b3n0/Adavanced-Yoto.

Yoto Player Advanced nécessite Gladys >=5.3.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​

Yoto Player Advanced 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 b3n0, et non par l'équipe cœur de Gladys.

Inscrivez-vous à la newsletter Gladys Assistant

Quelques emails par mois sur les nouveautés et l'actualité du projet. Envoyés par Pierre-Gilles Leymarie, le fondateur du projet. Désinscription possible à tout moment 🙂
Dernière mise à jour le