Aller au contenu principal

Intégration domotique Nintendo Parental Controls, gratuite et open source

Intégration Nintendo Parental Controls pour Gladys Assistant

Temps de jeu Nintendo Switch : limite du jour, temps bonus, jeu en cours, alertes et boutons.

Voir sur GitHubToutes les intégrations

Présentation​

Cette intégration amène le contrôle parental de la Nintendo Switch dans Gladys, comme l'appli pour smartphone « Contrôle parental Nintendo Switch » : pour chaque console liée à votre compte Nintendo, le temps de jeu du jour, la limite du jour, le temps restant, le temps bonus, le jeu en cours ou le dernier jeu, si quelqu'un joue, et ce qui se passe à la limite (une alarme seule, ou le logiciel suspendu).

Elle agit aussi comme l'appli : changer la limite du jour, ajouter du temps bonus pour aujourd'hui, suspendre le logiciel à la limite. Des déclencheurs de scène permettent à Gladys de réagir quand un enfant commence à jouer, quand la limite est bientôt atteinte ou dépassée, et un widget de tableau de bord montre les consoles avec des boutons « +15 min » et « Suspendre ».

Elle fonctionne avec la Nintendo Switch, la Nintendo Switch Lite, la Nintendo Switch OLED et la Nintendo Switch 2, via les serveurs de Nintendo (la console doit avoir accès à Internet). Elle utilise la même API privée que l'appli, documentée par la bibliothèque pynintendoparental qu'utilise Home Assistant. Cette intégration n'est pas affiliée à Nintendo : Nintendo Switch est une marque de Nintendo.

Développée sans le matériel : ni console ni compte Nintendo n'étaient sous la main, tout a été construit sur de vraies réponses publiées avec pynintendoparental. Vos retours bienvenus, sur le forum ou dans les issues GitHub.

Prérequis​

  • Gladys Assistant 5.1.0 ou plus récent.
  • Un compte Nintendo (celui du parent), avec la ou les consoles déjà associées dans l'appli Contrôle parental Nintendo Switch (la mettre en place).
  • Le navigateur d'un ordinateur pour l'étape de connexion (le lien à copier y est plus facile à obtenir que sur un téléphone).

Configuration​

Dans Gladys, Intégrations, Nintendo Parental Controls, Configuration :

  1. Cliquez sur Connecter à côté de « Compte Nintendo » : la page de connexion de Nintendo s'ouvre dans un nouvel onglet.
  2. Identifiez-vous avec le compte parent utilisé dans l'appli Contrôle parental. Votre mot de passe se tape sur nintendo.com seulement et ne passe jamais par Gladys.
  3. Nintendo affiche le compte et un bouton rouge Choisir cette personne. Ne cliquez pas dessus : faites un clic droit dessus et choisissez Copier l'adresse du lien (sur un téléphone : appui long, Copier le lien). Le lien commence par npf54789befb391a838://auth#.
  4. Collez-le dans Lien de « Choisir cette personne » et enregistrez. Le badge passe à connecté en quelques secondes. Le lien ne sert qu'une fois et seulement quelques minutes : s'il est refusé, cliquez à nouveau sur Connecter et collez vite le nouveau lien.
ChampContenu
Compte NintendoLe bouton Connecter.
Lien de « Choisir cette personne »Le lien copié. Utilisé une fois : l'intégration garde ensuite sa propre session Nintendo dans son volume de données, jamais dans les journaux.
Intervalle de rafraîchissement1, 2 ou 5 minutes (1 minute par défaut).
Langue des noms de fonctionnalitésAnglais, français (par défaut), allemand ou espagnol : les noms des fonctionnalités, la liste des limites et les textes envoyés aux scènes.

Ouvrez ensuite l'onglet Découverte et ajoutez les consoles voulues comme appareils.

Appareils​

Un appareil par console, nommé d'après son nom dans l'appli et son modèle, par exemple « Salon (Nintendo Switch 2) ».

FonctionnalitéTypeContenu
Temps de jeu aujourd'huiDurée (minutes)Temps de jeu total de la console aujourd'hui, tous les joueurs additionnés.
Temps restantDurée (minutes)Ce que laisse la limite plus le bonus, ou le temps jusqu'à l'alarme du coucher si elle arrive avant. Sans limite ni coucher : le temps jusqu'à minuit, comme dans l'appli.
Limite du jourListe (commande)« Sans limite », ou de 15 minutes à 6 heures par 15 minutes, les choix de l'appli. En mode « identique chaque jour », elle change tous les jours ; en mode « par jour », seulement ce jour de la semaine, comme l'appli.
Temps bonus aujourd'huiDurée (minutes)Temps en plus accordé aujourd'hui, 0 sinon. « Sans limite aujourd'hui » s'affiche 1440.
Jeu en cours ou dernier jeuTexteLe jeu dont le temps a augmenté en dernier, ou le dernier jeu joué.
En jeuBinaire1 tant que le temps de jeu augmente. Voir « Limites » : connu avec quelques minutes de retard.
En ligneBinaire1 quand la console a transmis ses données de jeu dans les 20 dernières minutes, ou joue.
Suspendre le logiciel à la limiteInterrupteur (commande)Allumé : le logiciel est suspendu quand la limite est atteinte. Éteint : une alarme seule.

Les deux commandes sont des réglages parentaux, comme dans l'appli : elles ne débloquent jamais rien qu'un parent n'ait choisi. Tout utilisateur de Gladys autorisé à piloter les appareils (ou un assistant vocal relié à Gladys) peut s'en servir : gardez au besoin les consoles hors des pièces partagées avec les enfants.

Widget​

Le widget Nintendo Switch montre, pour la console choisie dans ses réglages (ou la seule du compte) : le temps joué, le temps restant et la limite, le jeu en cours ou le dernier jeu, le mode à la limite, et trois boutons, chacun avec une confirmation :

  • +15 min : 15 minutes de bonus pour aujourd'hui ;
  • Alarme seule et Suspendre : ce qui se passe à la limite, le mode actuel marqué d'une coche.

Une fois un bonus accordé pour la journée, Nintendo refuse tout changement du mode ou de la limite jusqu'au lendemain : le widget le dit à la place des boutons de mode. Sans console choisie et avec plusieurs consoles, le widget les liste toutes (temps joué / limite), sans boutons.

Déclencheurs de scène​

Chacun peut se limiter à une console, et transmet à la scène le nom de la console et le jeu.

  • Commence à jouer : le temps de jeu de la console se remet à augmenter (une nouvelle session après une pause de plus de 20 minutes). Un filtre facultatif garde un seul jeu (nom exact, comme dans l'appli). Connu avec quelques minutes de retard (voir « Limites »).
  • Limite bientôt atteinte : pendant le jeu, le temps restant avant la limite ou l'alarme du coucher descend à 30, 15, 10 ou 5 minutes (choisi dans le déclencheur). Une fois par passage ; un bonus ou une limite plus haute le réarme.
  • Limite dépassée : le temps de jeu du jour atteint la limite du jour plus le bonus. Une fois par jour, et de nouveau quand un bonus est épuisé.

La première lecture après un démarrage de l'intégration, et le début d'un nouveau jour, ne font que poser la référence : aucun événement.

Actions de scène​

  • Ajouter du temps bonus : 5, 10, 15 ou 30 minutes pour aujourd'hui, comme l'appli. Donne le bonus du jour et le temps restant aux étapes suivantes. Nintendo le refuse après le coucher ou quand la journée ne peut plus être prolongée : l'action de scène échoue alors avec la raison.
  • Changer la limite du jour : « Sans limite » ou de 15 minutes à 6 heures, écrite là où l'appli l'écrit (tous les jours, ou ce jour de la semaine en mode par jour).

Une fois un bonus accordé pour la journée, Nintendo refuse une nouvelle limite jusqu'au lendemain : l'action de scène échoue alors avec la raison.

Actions de configuration​

  • Tester la connexion : lit maintenant les consoles du compte et les liste, ou dit ce qui ne va pas.
  • Se déconnecter de Nintendo : supprime la session Nintendo gardée par l'intégration. Reconnectez-vous pour l'utiliser.

Exemples de scènes​

  • Prévenir avant la fin : déclencheur « Limite bientôt atteinte », 10 minutes, la console du salon → annoncer « Plus que 10 minutes de Switch » sur l'enceinte du salon.
  • La limite est passée : déclencheur « Limite dépassée » → envoyer un message aux parents, et allumer « Suspendre le logiciel à la limite » pour les jours suivants.
  • Les devoirs d'abord : déclencheur « Commence à jouer » un jour de semaine avant 17 h → envoyer une notification aux parents avec le jeu (variables console_name, game).
  • Récompense : quand une tâche est marquée faite dans Gladys → action de scène « Ajouter du temps bonus », 15 minutes.

Rafraîchissement et quotas de Nintendo​

L'intégration interroge Nintendo d'elle-même à l'intervalle choisi (elle ne dépend pas du sondage de Gladys) : par console, deux requêtes par rafraîchissement (les résumés du jour et les réglages), plus la liste des consoles toutes les 30 minutes et un nouveau jeton d'accès environ toutes les 10 minutes. Avec une console et l'intervalle par défaut, environ 2 requêtes par minute, le rythme de l'intégration Home Assistant.

Nintendo ne publie aucun quota pour cette API privée ; quand elle répond « trop de requêtes » (HTTP 429), l'intégration fait une pause de 5 minutes. Les données ne sont jamais plus fraîches que ce que la console transmet : une console envoie son temps de jeu toutes les quelques minutes, un intervalle plus court n'apporte donc pas de données plus récentes.

L'API est celle de l'appli officielle, utilisée ici de la même façon, pour votre propre compte seulement. Nintendo peut la changer à tout moment : si elle exige une version plus récente de l'appli, l'écran de configuration le dit et une mise à jour de l'intégration est nécessaire.

Dépannage​

  • « Le texte collé n'est pas le lien… » : copiez l'adresse du lien du bouton rouge « Choisir cette personne », pas l'adresse de la page.
  • « Nintendo a refusé le lien » : le lien a déjà servi ou est trop ancien (quelques minutes). Cliquez à nouveau sur Connecter et collez vite le nouveau lien.
  • « Ce lien vient d'une autre connexion » : le lien a été copié après un autre clic sur Connecter, ou depuis un autre outil. Cliquez à nouveau sur Connecter et utilisez la nouvelle page.
  • « Nintendo a mis fin à la session » : le mot de passe a changé, ou le compte a été déconnecté de tous les appareils. Reconnectez-vous.
  • « Aucune console n'est liée » : associez d'abord la console dans l'appli Contrôle parental Nintendo Switch.
  • Le temps de jeu ne bouge pas : la console doit être connectée à Internet ; elle transmet son temps de jeu toutes les quelques minutes.
  • Journaux : dans Gladys, la page de l'intégration, Journaux. Passez la variable LOG_LEVEL à debug pour voir chaque rafraîchissement. Aucun jeton n'y est jamais écrit.

Limites​

  • Développée sans le matériel : chaque réponse de Nintendo vient des tests publiés de pynintendoparental. Vos retours bienvenus.
  • En jeu, Commence à jouer et le jeu en cours sont déduits de la hausse du temps de jeu : Nintendo ne publie aucune information « en train de jouer ». Ils sont connus avec quelques minutes de retard, et un jeu lancé moins d'une minute peut ne pas apparaître.
  • En ligne signifie « a transmis des données de jeu dans les 20 dernières minutes » : Nintendo ne donne pas la présence en direct de la console.
  • L'alarme du coucher et sa fin, les réglages par jour, les restrictions de contenu, le code PIN et les rapports mensuels ne sont pas exposés : changez-les dans l'appli.
  • Une fois un bonus accordé pour la journée, Nintendo refuse tout changement de la limite ou du mode jusqu'au lendemain.
  • Un seul compte Nintendo par intégration.

Paramètres de configuration​

Voici les paramètres demandés par Nintendo Parental Controls dans son écran de configuration dans Gladys.

ParamètreTypeObligatoireDescription
Connecter votre compte NintendosectionNonCliquez sur Connecter et identifiez-vous avec le compte parent de l'appli Contrôle parental. Faites ensuite un clic droit sur le bouton rouge « Choisir cette personne », copiez l'adresse du lien et collez-la ci-dessous. Votre mot de passe ne passe jamais par Gladys.
Compte Nintendoaccount_linkNonOuvre la page de connexion de Nintendo.
Lien de « Choisir cette personne »secretNonCommence par npf54789befb391a838://auth. Utilisé une fois : l'intégration garde ensuite sa propre session.
Intervalle de rafraîchissementselectNonFréquence à laquelle Nintendo est interrogé. La console elle-même transmet toutes les quelques minutes.
Langue des noms de fonctionnalitésselectNonSert aussi aux titres des jeux et aux textes envoyés aux scènes.

Comment installer Nintendo Parental Controls dans Gladys​

  1. Dans Gladys, ouvrez Intégrations : Nintendo Parental Controls 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/guim31/gladys-nintendo-parental:1.0.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).
  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/guim31/gladys-nintendo-parental.

Nintendo Parental Controls 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​

Nintendo Parental Controls 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 guim31, 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