node-red-contrib-huemagic 4.2.2 → 5.0.0

package/huemagic/locales/fr/hue-magic.html

@@ -0,0 +1,68 @@
+<script type="text/markdown" data-help-name="hue-magic">
+Le nœud « Hue Magic » peut appliquer des animations complexes et personnalisées à des lumières et des groupes.
+
+### Configuration
+
+Donnez d'abord un nom au nœud afin de pouvoir identifier clairement votre animation dans l'interface Node-RED. Vous avez ensuite le choix entre les options « Boucle » et « Restaurer ». Sélectionnez l'option boucle si vous souhaitez que votre animation s'exécute indéfiniment sur une lumière ou un groupe jusqu'à ce que vous l'arrêtiez manuellement. Si vous souhaitez restaurer l'état précédent de la ressource cible (lumière / groupe) une fois l'animation terminée, cochez l'option « Restaurer ». Sinon, la dernière image de l'animation reste appliquée à la ressource concernée.
+
+Vous pouvez ensuite choisir parmi les animations prêtes à l'emploi de HueMagic. Cliquez sur l'animation souhaitée pour la définir.
+
+### Lancer / arrêter l'animation
+
+Pour lancer ou arrêter une animation, transmettez au nœud un objet ayant le contenu suivant :
+
+: payload (boolean): `true` lance l'animation, `false` l'arrête
+
+### Animations personnalisées
+
+Si vous transmettez votre propre animation au nœud, l'animation prédéfinie sélectionnée (le cas échéant) est temporairement remplacée par la vôtre. Les animations HueMagic personnalisées sont une séquence de commandes regroupées dans un tableau. Chaque élément du tableau constitue une étape, sachant qu'une étape peut elle-même comporter plusieurs images (effets de transition).
+
+Créez un `array` contenant les différentes étapes de l'animation sous forme d'objet et transmettez-le au nœud HueMagic dans `msg.payload.steps`.
+
+: delay (int): Nombre de millisecondes à attendre avant l'exécution de cette étape
+: animation (object): L'objet contient la ou les actions à exécuter lors de cette étape. Paramètres identiques à ceux des nœuds « Hue Lumière » et « Hue Groupe »
+
+### Exemple d'animation personnalisée
+
+Cet exemple montre à quoi pourrait ressembler une animation simple. Lors de la première étape, le délai de 500 millisecondes est respecté. La couleur de la lumière passe ensuite lentement au rouge sur une seconde. Dès que la lumière est entièrement passée au rouge, la deuxième étape est exécutée, elle aussi avec un délai de 500 millisecondes. Pour finir, la couleur passe au bleu.
+
+Si vous avez réglé l'animation en boucle, ce processus se répète indéfiniment jusqu'à ce que vous arrêtiez l'animation manuellement ou redéployiez le nœud.
+
+Transmettez l'objet suivant dans `msg.payload` pour lancer l'animation d'exemple.
+
+    {
+        "animate": true,
+        "steps": [
+            {
+                "delay": 500,
+                "animation": {
+                    "hex": "#FF0000",
+                    "transitionTime": 1
+                }
+            },
+            {
+                "delay": 500,
+                "animation": {
+                    "hex": "#0000FF",
+                    "transitionTime": 1
+                }
+            }
+        ]
+    }
+
+### Commandes spéciales
+
+Il est parfois judicieux de jouer une animation de manière désordonnée, p. ex. pour imiter le feu de façon plus réaliste. Pour jouer les différentes étapes de manière aléatoire, vous pouvez transmettre la commande suivante dans `msg.payload.specials` :
+
+: randomOrder (boolean | any): `true` active la lecture aléatoire des différentes étapes de l'animation
+
+### Conseils et remarques
+
+Ce nœud n'émet aucun message de statut. Reliez la sortie du nœud à un groupe plutôt qu'à des lumières individuelles si vous souhaitez animer plusieurs lumières en même temps avec la même animation. Les aperçus des animations prêtes à l'emploi sont des simulations et peuvent différer légèrement (rythme, couleurs) de l'animation réelle sur une ressource.
+
+### Exemples de HueMagic
+
+HueMagic met à disposition quelques exemples de configuration pour ce nœud. Pour importer un exemple complet dans votre interface Node-RED, cliquez sur l'icône de menu de Node-RED, sélectionnez « Importer » puis naviguez vers « Exemples » dans la barre latérale de la fenêtre. Sélectionnez ensuite le dossier HueMagic et le nœud souhaité pour importer un flux d'exemple.
+
+![examples](hue/assets/huemagic-examples.gif)
+</script>

package/huemagic/locales/fr/hue-magic.json

@@ -0,0 +1,26 @@
+{
+	"hue-magic": {
+		"config": {
+			"name": "Nom",
+			"input-name": "Nom de l'animation",
+			"loop": "Boucle",
+			"loop-endless": "Répéter indéfiniment",
+			"restore": "Restaurer",
+			"restore-state": "Restaurer l'état précédent après l'arrêt",
+			"animation": "Animation",
+			"unknown-error": "Une erreur est survenue. Veuillez réessayer.",
+			"seconds": "s",
+			"minutes": "min"
+		},
+		"node": {
+			"title": "Hue Magic",
+			"no-animation": "aucune animation indiquée",
+			"animating": "animation en cours…",
+			"stopped": "arrêtée",
+			"input": "lancer / arrêter l'animation",
+			"output": "lumière ou groupe",
+			"command": "exécution de la commande…",
+			"playmsg": "Animation lancée…"
+		}
+	}
+}

package/huemagic/locales/fr/hue-motion.html

@@ -0,0 +1,64 @@
+<script type="text/markdown" data-help-name="hue-motion">
+Le nœud « Hue Mouvement » peut enregistrer et signaler les mouvements détectés par un capteur adapté relié au bridge.
+
+### Configuration
+
+Sélectionnez le Hue Bridge préconfiguré et cliquez sur le bouton de recherche pour trouver tous les capteurs disponibles. Si vous connaissez déjà l'ID du capteur, vous pouvez également le saisir ici manuellement. Vous pouvez attribuer en interne un nouveau nom au capteur ou conserver son nom prédéfini. En option, vous pouvez désactiver tous les messages de statut automatiques de ce nœud à l'aide du réglage « Ignorer les messages du nœud ». Le nœud n'émettra alors plus de mises à jour d'appareil. Vous pouvez également choisir que le message d'initialisation du nœud ne soit pas supprimé au démarrage de Node-RED. Si vous activez ce réglage, vous recevrez un message de statut du capteur sélectionné après chaque déploiement. Si vous préférez que le nœud reste silencieux jusqu'à ce que vous lui envoyiez quelque chose, activez « Signaler uniquement après une commande ». Il ignorera alors les changements provenant de l'application ou d'un interrupteur et ne répondra qu'à vos propres commandes.
+
+Si vous ne sélectionnez aucun capteur et utilisez la configuration du nœud de cette manière, le nœud fonctionne dans ce que l'on appelle le « mode universel ». Dans ce mode, le nœud reçoit et émet tous les messages de statut du même type. Vous pouvez également appliquer des réglages en mode universel à un capteur précis en transmettant l'ID du capteur correspondant sous forme de chaîne dans `msg.topic` avec vos réglages.
+
+### Interroger le statut
+
+Émet le statut actuel du capteur dès qu'un objet `msg.payload` ayant le contenu suivant est transmis au nœud. Vous pouvez également appuyer sur le bouton dans l'interface Node-RED sans avoir à transmettre au préalable un message au nœud.
+
+: status (boolean): Renvoie le statut actuel du capteur
+
+### Activer / désactiver le capteur
+
+Si nécessaire, le capteur peut être activé et désactivé à distance. Une fois désactivé, il n'enregistre plus aucun mouvement et n'en émet donc plus. Pour cela, transmettez un objet ayant le contenu suivant :
+
+: payload (boolean): `true` active le capteur, `false` le désactive
+
+### Messages de statut du nœud
+
+Dès que le capteur enregistre un mouvement, le nœud renvoie le message de statut suivant :
+
+#### Objet de statut dans `msg.payload`
+
+: active (boolean): Indique si le capteur est activé ou désactivé
+: reachable (boolean | string): `true` si le capteur est connecté au bridge, `unknown` si le statut de connexion diverge
+: connectionStatus (string): Le statut de connexion actuel avec le bridge sous forme de chaîne. Peut contenir `connected`, `disconnected`, `connectivity_issue` ou `unidirectional_incoming` comme valeur
+: motion (boolean): Indique si un mouvement a été enregistré
+: updated (string): Heure de la dernière mise à jour de la ressource par HueMagic (ISO 8601)
+
+#### Informations sur le capteur dans `msg.info`
+
+: id (string): Indique le nouvel ID du capteur
+: idV1 (string | boolean): Indique l'ancien ID du capteur
+: uniqueId (string): L'ID unique du capteur
+: deviceId (string): L'ID unique de l'appareil
+: name (string): Le nom actuellement attribué au capteur
+: type (string): Le type du capteur (toujours `motion`)
+: softwareVersion (string): Le micrologiciel actuel du capteur
+: battery (float): Le niveau de batterie actuel du capteur
+: batteryState (string): Le statut actuel du niveau de batterie. Peut contenir `normal`, `low` ou `critical` comme valeur
+: model (object): Contient les informations de modèle du capteur dans `id`, `manufacturer`, `name`, `type` et `certified`
+
+#### Changements d'état dans `msg.updated`
+
+Énumère sous forme d'objet les paramètres qui ont changé par rapport au dernier état du capteur. Si aucun changement n'a été enregistré, cet objet est vide.
+
+#### Dernier état du capteur dans `msg.lastState`
+
+Contient l'objet de statut complet (voir les valeurs de sortie ci-dessus) du dernier état avant le dernier changement enregistré. Si HueMagic n'a pas encore enregistré le dernier état, `false` est émis.
+
+#### Dernière commande dans `msg.command` (facultatif)
+
+Si le statut du nœud a changé suite à une commande particulière, la commande complète qui a été exécutée est également émise. Sinon, cet objet n'est pas émis par le nœud.
+
+### Exemples de HueMagic
+
+HueMagic met à disposition quelques exemples de configuration pour ce nœud. Pour importer un exemple complet dans votre interface Node-RED, cliquez sur l'icône de menu de Node-RED, sélectionnez « Importer » puis naviguez vers « Exemples » dans la barre latérale de la fenêtre. Sélectionnez ensuite le dossier HueMagic et le nœud souhaité pour importer un flux d'exemple.
+
+![examples](hue/assets/huemagic-examples.gif)
+</script>

package/huemagic/locales/fr/hue-motion.json

@@ -0,0 +1,36 @@
+{
+	"hue-motion": {
+		"config": {
+			"name": "Nom",
+			"skipevents-node": "Ignorer les messages du nœud",
+			"sendinitevents-node": "Ne pas supprimer l'événement d'initialisation",
+			"onlycommands-node": "Signaler uniquement après une commande",
+			"unknown-error": "Une erreur est survenue. Veuillez réessayer.",
+			"bridge": "Bridge",
+			"universalevents": "Événements universels",
+			"universalevents-node": "Reçoit tous les messages des autres nœuds du même type (uniquement en mode universel)",
+			"input-name": "Nom du capteur",
+			"searching": "Recherche de détecteurs de mouvement…",
+			"none-found": "Aucun détecteur de mouvement trouvé !",
+			"sensor": "Capteur"
+		},
+		"node": {
+			"not-configured": "non configuré",
+			"not-reachable": "non joignable",
+			"activated": "activé",
+			"deactivated": "désactivé",
+			"universal": "mode universel",
+			"command": "exécution de la commande…",
+			"statusmsg": "Statut interrogé avec succès…",
+			"title": "Hue Mouvement",
+			"motion": "mouvement détecté",
+			"no-motion": "aucun mouvement",
+			"input": "activer / désactiver / statut",
+			"output": "mouvement détecté",
+			"error-no-id": "Veuillez indiquer un ID de capteur valide.",
+			"error-not-available": "Le capteur n'est pas encore disponible. Veuillez attendre que HueMagic ait établi la connexion avec le bridge ou vérifiez si l'ID de ressource indiqué dans la configuration est valide.",
+			"error-no-sensitivity": "Cette source de mouvement n'a pas de sensibilité réglable.",
+			"error-invalid-sensitivity": "Sensibilité non valide. Seules les valeurs de 0 à __max__ sont autorisées."
+		}
+	}
+}

package/huemagic/locales/fr/hue-rules.html

@@ -0,0 +1,69 @@
+<script type="text/markdown" data-help-name="hue-rules">
+Le nœud « Hue Règle » peut activer ou désactiver les règles enregistrées dans le bridge et consulter leurs réglages.
+
+### Configuration
+
+Sélectionnez le Hue Bridge préconfiguré et cliquez sur le bouton de recherche pour trouver toutes les règles disponibles. Si vous connaissez déjà l'ID de la règle, vous pouvez également le saisir ici manuellement. Vous pouvez aussi attribuer un nouveau nom ou conserver le nom prédéfini de la règle. En option, vous pouvez désactiver tous les messages de statut automatiques de ce nœud à l'aide du réglage « Ignorer les messages du nœud ». Le nœud n'émettra alors plus de mises à jour. Vous pouvez également choisir que le message d'initialisation du nœud ne soit pas supprimé au démarrage de Node-RED. Si vous préférez que le nœud reste silencieux jusqu'à ce que vous lui envoyiez quelque chose, activez « Signaler uniquement après une commande ». Il ignorera alors les changements provenant de l'application ou d'un interrupteur et ne répondra qu'à vos propres commandes.
+
+Si vous ne sélectionnez aucune règle et utilisez la configuration du nœud de cette manière, le nœud fonctionne dans ce que l'on appelle le « mode universel ». Dans ce mode, le nœud reçoit et émet tous les messages de statut du même type. Vous pouvez également appliquer des réglages en mode universel à une règle précise en transmettant l'ID de la règle correspondante sous forme de chaîne dans `msg.topic` avec vos réglages.
+
+### Interroger les propriétés et réglages
+
+Émet les propriétés actuelles de la règle dès qu'un objet `msg.payload` ayant le contenu suivant est transmis au nœud. Vous pouvez également appuyer sur le bouton dans l'interface Node-RED sans avoir à transmettre au préalable un message au nœud.
+
+: status (boolean): Renvoie le statut actuel de la règle
+
+### Activer / désactiver la règle
+
+La règle peut être activée et désactivée si nécessaire. Une fois désactivée, elle ne s'exécutera plus dans le bridge jusqu'à ce que vous la réactiviez. Pour cela, transmettez un objet ayant le contenu suivant :
+
+: payload (boolean): `true` active la règle, `false` la désactive
+
+### Messages de statut du nœud
+
+Dès que le statut (activée / désactivée) d'une règle change, le nœud renvoie le message de statut suivant :
+
+#### Objet de statut dans `msg.payload`
+
+: enabled (boolean): Indique si la règle est activée ou désactivée
+: triggered (string): Heure de la dernière exécution (ISO 8601)
+
+#### Informations sur la règle dans `msg.info`
+
+: id (string): L'ID unique de la règle
+: created (string): Date de création de la règle (ISO 8601)
+: name (string): Nom de la règle sur le bridge
+: timesTriggered (int): Nombre de fois où la règle a été exécutée sur le bridge
+: owner (string): ID du propriétaire de cette règle
+: status (string): Statut de la règle sous forme de chaîne
+
+#### Conditions de la règle dans `msg.conditions` (tableau)
+
+: address (string): Chemin vers un attribut d'un capteur
+: operator (string): Opérateur
+: value (string): La valeur à vérifier
+
+#### Actions de la règle dans `msg.actions` (tableau)
+
+: address (string): L'adresse de destination de la ressource
+: method (string): La méthode de la requête
+: body (object): L'action à exécuter
+
+#### Changements d'état dans `msg.updated`
+
+Énumère sous forme d'objet les paramètres qui ont changé par rapport au dernier état de la règle. Si aucun changement n'a été enregistré, cet objet est vide.
+
+#### Dernier état de la règle dans `msg.lastState`
+
+Contient l'objet complet (voir les valeurs de sortie ci-dessus) du dernier état avant le dernier changement enregistré de la règle. Si HueMagic n'a pas encore enregistré le dernier état, `false` est émis.
+
+#### Dernière commande dans `msg.command` (facultatif)
+
+Si le statut du nœud a changé suite à une commande particulière, la commande complète qui a été exécutée est également émise. Sinon, cet objet n'est pas émis par le nœud.
+
+### Exemples de HueMagic
+
+HueMagic met à disposition quelques exemples de configuration pour ce nœud. Pour importer un exemple complet dans votre interface Node-RED, cliquez sur l'icône de menu de Node-RED, sélectionnez « Importer » puis naviguez vers « Exemples » dans la barre latérale de la fenêtre. Sélectionnez ensuite le dossier HueMagic et le nœud souhaité pour importer un flux d'exemple.
+
+![examples](hue/assets/huemagic-examples.gif)
+</script>

package/huemagic/locales/fr/hue-rules.json

@@ -0,0 +1,30 @@
+{
+	"hue-rules": {
+		"config": {
+			"name": "Nom",
+			"skipevents-node": "Ignorer les messages du nœud",
+			"sendinitevents-node": "Ne pas supprimer l'événement d'initialisation",
+			"onlycommands-node": "Signaler uniquement après une commande",
+			"unknown-error": "Une erreur est survenue. Veuillez réessayer.",
+			"bridge": "Bridge",
+			"input-name": "Nom de la règle",
+			"searching": "Recherche de règles…",
+			"none-found": "Aucune règle trouvée !",
+			"rule": "Règle"
+		},
+		"node": {
+			"init": "initialisation…",
+			"universal": "mode universel",
+			"command": "exécution de la commande…",
+			"statusmsg": "Statut interrogé avec succès…",
+			"title": "Hue Règle",
+			"no-rule": "aucune règle sélectionnée",
+			"enabled": "activée",
+			"disabled": "désactivée",
+			"output": "règle (déclenchée)",
+			"input": "activer / désactiver",
+			"error-no-id": "Veuillez indiquer un ID de règle valide.",
+			"error-not-available": "La règle n'est pas encore disponible. Veuillez attendre que HueMagic ait établi la connexion avec le bridge ou vérifiez si l'ID de ressource indiqué dans la configuration est valide."
+		}
+	}
+}

package/huemagic/locales/fr/hue-scene.html

@@ -0,0 +1,43 @@
+<script type="text/markdown" data-help-name="hue-scene">
+Le nœud « Hue Scène » peut rappeler des scènes enregistrées dans le bridge et les appliquer à certains groupes.
+
+### Configuration
+
+Sélectionnez le Hue Bridge préconfiguré et cliquez sur le bouton de recherche pour trouver toutes les scènes disponibles. Les scènes sont d'abord triées par pièce ou zone, puis par nom, de sorte que les scènes d'une même pièce restent toujours regroupées dans la liste. Si vous connaissez déjà l'ID de la scène, vous pouvez également le saisir ici manuellement. Vous pouvez aussi attribuer en interne un nom à la scène ou conserver son nom prédéfini.
+
+### Activer une scène
+
+Vous pouvez activer une scène prédéfinie en transmettant un objet ayant le contenu suivant :
+
+: payload (boolean): Active une scène préconfigurée
+: transitionTime (float): Temps de transition de la scène en secondes. Si `0` est transmis, la scène est appliquée immédiatement. Si vous transmettez `3`, les lumières fondent vers la scène en 3 secondes. Le bridge accepte jusqu'à 6000 secondes
+: brightness (float): Luminosité de l'ensemble de la scène en pourcentage (`0` – `100`), ce qui vous permet de rappeler une même scène plus claire ou plus tamisée selon l'heure de la journée
+
+> [!NOTE]
+> Ces deux réglages ne sont disponibles que pour les scènes normales. Une scène intelligente suit les horaires que vous avez définis pour elle dans l'application Philips Hue.
+
+### Activer une scène en mode universel
+
+Si vous utilisez ce nœud dans ce que l'on appelle le « mode universel » et que vous n'avez défini aucune scène dans la configuration du nœud, vous pouvez également transmettre au nœud la scène souhaitée sous forme de commande. Pour cela, transmettez un objet `msg.payload` ayant le contenu suivant :
+
+: scene (string): ID de la scène à activer sur le bridge
+
+### Activer une scène sur certains groupes
+
+Reliez la sortie de ce nœud à un ou plusieurs groupes pour appliquer une scène à des groupes précis. Vous pouvez également le faire « dynamiquement » en transmettant au nœud un objet `msg.payload` ayant le contenu suivant :
+
+: group (string | array [string,…]): ID du groupe ou tableau contenant les ID de plusieurs groupes afin de limiter la scène à ces groupes
+
+### Informations complémentaires sur le nœud
+
+Ce nœud n'émet aucun message de statut.
+
+> [!IMPORTANT]
+> Vous ne pouvez appliquer des scènes à des groupes que si ceux-ci sont déjà liés à la scène correspondante sur le bridge. Sinon, rien ne sera appliqué.
+
+### Exemples de HueMagic
+
+HueMagic met à disposition quelques exemples de configuration pour ce nœud. Pour importer un exemple complet dans votre interface Node-RED, cliquez sur l'icône de menu de Node-RED, sélectionnez « Importer » puis naviguez vers « Exemples » dans la barre latérale de la fenêtre. Sélectionnez ensuite le dossier HueMagic et le nœud souhaité pour importer un flux d'exemple.
+
+![examples](hue/assets/huemagic-examples.gif)
+</script>

package/huemagic/locales/fr/hue-scene.json

@@ -0,0 +1,32 @@
+{
+	"hue-scene": {
+		"config": {
+			"name": "Nom",
+			"input-name": "Nom de la scène",
+			"skipevents-node": "Ignorer les messages du nœud",
+			"sendinitevents-node": "Ne pas supprimer l'événement d'initialisation",
+			"searching": "Recherche de scènes…",
+			"none-found": "Aucune scène trouvée !",
+			"unknown-error": "Une erreur est survenue. Veuillez réessayer.",
+			"scene": "Scène",
+			"group": "Groupe",
+			"group-none-found": "Aucun groupe trouvé !",
+			"group-searching": "Recherche de groupes…",
+			"groups-all": "Tous les groupes / lumières",
+			"bridge": "Bridge"
+		},
+		"node": {
+			"title": "Hue Scène",
+			"not-configured": "non configuré",
+			"recalled": "scène activée",
+			"recalled-on-group": "scène activée sur le groupe",
+			"no-id": "Aucun ID de scène.",
+			"input": "activer la scène",
+			"output": "groupe(s) cible(s)",
+			"command": "exécution de la commande…",
+			"statusmsg": "Activation de la scène…",
+			"error-not-available": "La scène n'est pas encore disponible. Veuillez attendre que HueMagic ait établi la connexion avec le bridge ou vérifiez si l'ID de ressource indiqué dans la configuration est valide.",
+			"error-invalid-brightness": "Réglage de luminosité non valide. Seules les valeurs de 0 à 100 pour cent sont autorisées."
+		}
+	}
+}

package/huemagic/locales/fr/hue-speaker.html

@@ -0,0 +1,80 @@
+<script type="text/markdown" data-help-name="hue-speaker">
+Le nœud « Hue Haut-parleur » peut jouer les sons d'un carillon Hue Secure et l'utiliser comme sirène d'intérieur.
+
+### Configuration
+
+Sélectionnez le Hue Bridge préconfiguré et cliquez sur le bouton de recherche pour trouver tous les haut-parleurs disponibles. Si vous connaissez déjà l'ID du haut-parleur, vous pouvez également le saisir ici manuellement. Vous pouvez attribuer en interne un nouveau nom au haut-parleur ou conserver son nom prédéfini. En option, vous pouvez désactiver tous les messages de statut automatiques de ce nœud à l'aide du réglage « Ignorer les messages du nœud ». Le nœud n'émettra alors plus de mises à jour d'appareil. Vous pouvez également choisir que le message d'initialisation du nœud ne soit pas supprimé au démarrage de Node-RED. Si vous activez ce réglage, vous recevrez un message de statut du haut-parleur sélectionné après chaque déploiement. Si vous préférez que le nœud reste silencieux jusqu'à ce que vous lui envoyiez quelque chose, activez « Signaler uniquement après une commande ». Il ignorera alors les changements provenant de l'application ou d'un interrupteur et ne répondra qu'à vos propres commandes.
+
+Si vous ne sélectionnez aucun haut-parleur et utilisez la configuration du nœud de cette manière, le nœud fonctionne dans ce que l'on appelle le « mode universel ». Dans ce mode, le nœud reçoit et émet tous les messages de statut du même type. Vous pouvez également appliquer des réglages en mode universel à un haut-parleur précis en transmettant l'ID du haut-parleur correspondant sous forme de chaîne dans `msg.topic` avec vos réglages.
+
+### Interroger le statut
+
+Émet le statut actuel du haut-parleur dès qu'un objet `msg.payload` ayant le contenu suivant est transmis au nœud. Vous pouvez également appuyer sur le bouton dans l'interface Node-RED sans avoir à transmettre au préalable un message au nœud.
+
+: status (boolean): Renvoie le statut actuel du haut-parleur
+
+### Jouer un son
+
+Un haut-parleur connaît trois canaux distincts. `chime` est le son de la sonnette, `alarm` la sirène et `alert` une courte notification. Les sons réellement connus d'un appareil sont listés sous `msg.info.sounds`. Transmettez les paramètres suivants dans un objet `msg.payload` :
+
+: chime (string | object | boolean): Nom du son de la sonnette ; `false` l'arrête à nouveau
+: alarm (string | object | boolean): Nom du son de la sirène ; `false` l'arrête à nouveau
+: alert (string | object | boolean): Nom du son de notification ; `false` l'arrête à nouveau
+: mute (boolean): `true` met le haut-parleur en sourdine, `false` réactive le son
+
+Au lieu d'un simple nom de son, vous pouvez également transmettre un objet pour contrôler le volume et la durée :
+
+: sound (string): Nom du son, p. ex. `ding_dong_classic` ou `siren`
+: volume (int): Volume en pourcentage (0-100)
+: duration (float): Durée de lecture en secondes
+
+### Messages de statut du nœud
+
+Dès que le haut-parleur commence ou cesse de jouer, le nœud renvoie le message de statut suivant.
+
+> [!NOTE]
+> Le bridge signale le dernier son joué et ne le réinitialise que bien après la fin de la lecture ; ces valeurs sont donc légèrement en retard sur l'audio.
+
+#### Objet de statut dans `msg.payload`
+
+: reachable (boolean | string): `true` si le haut-parleur est connecté au bridge, `unknown` si le statut de connexion diverge
+: connectionStatus (string): Le statut de connexion actuel avec le bridge sous forme de chaîne. Peut contenir `connected`, `disconnected`, `connectivity_issue` ou `unidirectional_incoming` comme valeur
+: playing (boolean): `true` tant que le haut-parleur joue un son quelconque
+: chime (string | boolean): Nom du son de sonnette en cours de lecture ou `false`
+: alarm (string | boolean): Nom du son de sirène en cours de lecture ou `false`
+: alert (string | boolean): Nom du son de notification en cours de lecture ou `false`
+: muted (boolean): Indique si le haut-parleur est en sourdine
+: updated (string): Heure de la dernière mise à jour de la ressource par HueMagic (ISO 8601)
+
+#### Informations sur le haut-parleur dans `msg.info`
+
+: id (string): Indique le nouvel ID du haut-parleur
+: idV1 (string | boolean): Indique l'ancien ID du haut-parleur
+: uniqueId (string): L'ID unique du haut-parleur
+: deviceId (string): L'ID unique de l'appareil
+: name (string): Le nom actuellement attribué au haut-parleur
+: type (string): Le type de l'appareil (toujours `speaker`)
+: softwareVersion (string): Le micrologiciel actuel du haut-parleur
+: battery (float | boolean): Le niveau de batterie actuel du haut-parleur, `false` s'il n'y a pas de batterie
+: batteryState (string | boolean): Le statut actuel du niveau de batterie. Peut contenir `normal`, `low` ou `critical` comme valeur, `false` s'il n'y a pas de batterie
+: sounds (object): Contient les sons connus de cet appareil dans `chime`, `alarm` et `alert`
+: model (object): Contient les informations de modèle du haut-parleur dans `id`, `manufacturer`, `name`, `type` et `certified`
+
+#### Changements d'état dans `msg.updated`
+
+Énumère sous forme d'objet les paramètres qui ont changé par rapport au dernier état du haut-parleur. Si aucun changement n'a été enregistré, cet objet est vide.
+
+#### Dernier état du haut-parleur dans `msg.lastState`
+
+Contient l'objet de statut complet (voir les valeurs de sortie ci-dessus) du dernier état avant le dernier changement enregistré. Si HueMagic n'a pas encore enregistré le dernier état, `false` est émis.
+
+#### Dernière commande dans `msg.command` (facultatif)
+
+Si le statut du nœud a changé suite à une commande particulière, la commande complète qui a été exécutée est également émise. Sinon, cet objet n'est pas émis par le nœud.
+
+### Exemples de HueMagic
+
+HueMagic met à disposition quelques exemples de configuration pour ce nœud. Pour importer un exemple complet dans votre interface Node-RED, cliquez sur l'icône de menu de Node-RED, sélectionnez « Importer » puis naviguez vers « Exemples » dans la barre latérale de la fenêtre. Sélectionnez ensuite le dossier HueMagic et le nœud souhaité pour importer un flux d'exemple.
+
+![examples](hue/assets/huemagic-examples.gif)
+</script>

package/huemagic/locales/fr/hue-speaker.json

@@ -0,0 +1,38 @@
+{
+	"hue-speaker": {
+		"config": {
+			"name": "Nom",
+			"skipevents-node": "Ignorer les messages du nœud",
+			"sendinitevents-node": "Ne pas supprimer l'événement d'initialisation",
+			"onlycommands-node": "Signaler uniquement après une commande",
+			"unknown-error": "Une erreur est survenue. Veuillez réessayer.",
+			"bridge": "Bridge",
+			"universalevents": "Événements universels",
+			"universalevents-node": "Reçoit tous les messages des autres nœuds du même type (uniquement en mode universel)",
+			"input-name": "Nom du haut-parleur",
+			"searching": "Recherche de haut-parleurs…",
+			"none-found": "Aucun haut-parleur trouvé !",
+			"speaker": "Haut-parleur"
+		},
+		"node": {
+			"not-configured": "non configuré",
+			"not-reachable": "non joignable",
+			"universal": "mode universel",
+			"command": "exécution de la commande…",
+			"statusmsg": "Statut interrogé avec succès…",
+			"title": "Hue Haut-parleur",
+			"silent": "silencieux",
+			"muted": "muet",
+			"playing-alarm": "alarme (__sound__)",
+			"playing-chime": "carillon (__sound__)",
+			"playing-alert": "alerte (__sound__)",
+			"input": "jouer un son / statut",
+			"output": "haut-parleur",
+			"error-no-id": "Veuillez indiquer un ID de haut-parleur valide.",
+			"error-not-available": "Le haut-parleur n'est pas encore disponible. Veuillez attendre que HueMagic ait établi la connexion avec le bridge ou vérifiez si l'ID de ressource indiqué dans la configuration est valide.",
+			"error-no-channel": "Ce haut-parleur n'a pas de son de type __channel__.",
+			"error-invalid-sound": "Son __channel__ non valide. Sons autorisés : __sounds__",
+			"error-invalid-volume": "Réglage de volume non valide. Seules les valeurs de 0 à 100 sont autorisées."
+		}
+	}
+}

package/huemagic/locales/fr/hue-syncbox-config.html

@@ -0,0 +1,19 @@
+<script type="text/markdown" data-help-name="hue-syncbox-config">
+Se connecte à une Philips Hue Play HDMI Sync Box.
+
+### Nom
+
+Vous pouvez attribuer à la sync box un autre nom interne ou conserver le nom par défaut.
+
+### IP de la Sync Box
+
+L'adresse IP de votre sync box dans votre réseau local. Dès que vous l'avez saisie, HueMagic tente de lire le nom du boîtier et le renseigne pour vous.
+
+### Jeton d'accès
+
+La sync box ne fait pas partie de votre Hue Bridge et nécessite son propre jeton. Cliquez sur le bouton à côté du champ, puis maintenez enfoncé le bouton de la sync box jusqu'à ce que sa LED clignote en vert. HueMagic interroge le boîtier pendant une minute et enregistre le jeton dès qu'il répond.
+
+### Actualisation
+
+La sync box n'envoie pas son état d'elle-même : HueMagic l'interroge donc régulièrement. Ce réglage définit le nombre de secondes entre deux requêtes. La valeur par défaut de 10 secondes est un bon compromis entre réactivité du statut et trafic réseau — ne la baissez pas plus que nécessaire.
+</script>

package/huemagic/locales/fr/hue-syncbox-config.json

@@ -0,0 +1,25 @@
+{
+	"hue-syncbox-config": {
+		"config": {
+			"name": "Nom",
+			"syncbox-ip": "IP de la Sync Box",
+			"token": "Jeton d'accès",
+			"pollinterval": "Actualisation (s)",
+			"missing-ip": "IP de la Hue Sync Box manquante…",
+			"connecting": "Connexion à la sync box…",
+			"invalid": "Désolé. La Hue Sync Box sélectionnée n'est pas valide : ",
+			"error-select-first": "Veuillez saisir l'IP de votre Hue Sync Box avant de créer un nouveau jeton !",
+			"waiting": "en attente de l'appui sur le bouton…",
+			"new-user-press": "Maintenez le bouton de votre Hue Sync Box enfoncé jusqu'à ce que la LED clignote en vert !",
+			"retry": "Aucun appui détecté. Veuillez réessayer…",
+			"success": "Jeton d'accès créé avec succès !"
+		},
+		"node": {
+			"title": "Hue Sync Box",
+			"initializing": "Initialisation de la sync box (__syncbox__)…",
+			"connected": "Connecté à la sync box",
+			"request-error": "Erreur lors de la demande d'informations à la sync box (__error__)",
+			"statusmsg": "Statut interrogé avec succès…"
+		}
+	}
+}

package/huemagic/locales/fr/hue-syncbox.html

@@ -0,0 +1,86 @@
+<script type="text/markdown" data-help-name="hue-syncbox">
+Le nœud « Hue Sync Box » commande une Philips Hue Play HDMI Sync Box et signale ce qu'elle est en train de faire.
+
+### Configuration
+
+La sync box n'est pas reliée à votre Hue Bridge mais parle sa propre API locale : elle nécessite donc sa propre configuration. Saisissez l'adresse IP de votre sync box et cliquez sur le bouton à côté du champ du jeton d'accès. Maintenez ensuite enfoncé le bouton de la sync box jusqu'à ce que sa LED clignote en vert — HueMagic interroge le boîtier pendant une minute et enregistre le jeton dès qu'il répond.
+
+Comme la sync box n'envoie pas son état d'elle-même, HueMagic l'interroge régulièrement. Vous pouvez définir la fréquence dans la configuration ; la valeur par défaut est de 10 secondes. En option, vous pouvez désactiver tous les messages de statut automatiques de ce nœud à l'aide du réglage « Ignorer les messages du nœud ». Vous pouvez également choisir que le message d'initialisation du nœud ne soit pas supprimé au démarrage de Node-RED. Si vous préférez que le nœud reste silencieux jusqu'à ce que vous lui envoyiez quelque chose, activez « Signaler uniquement après une commande ». Il ignorera alors les changements provenant de l'application ou d'un interrupteur et ne répondra qu'à vos propres commandes.
+
+### Interroger le statut
+
+Émet le statut actuel de la sync box dès qu'un objet `msg.payload` ayant le contenu suivant est transmis au nœud. Vous pouvez également appuyer sur le bouton dans l'interface Node-RED sans avoir à transmettre au préalable un message au nœud.
+
+: status (boolean): Renvoie le statut actuel de la sync box
+
+### Allumer / éteindre (mode simple)
+
+Pour allumer ou éteindre rapidement la sync box, transmettez au nœud un objet ayant le contenu suivant. À l'allumage, le dernier mode de synchronisation utilisé est rétabli.
+
+: payload (boolean): `true` lance la synchronisation, `false` met le boîtier en veille
+
+### Commandes de la sync box (étendu)
+
+Transmettez les paramètres suivants dans un objet `msg.payload` pour commander la sync box plus finement :
+
+: mode (string): L'un des modes `powersave`, `passthrough`, `video`, `game`, `music` ou `ambient`
+: sync (boolean): `true` lance la synchronisation, `false` l'arrête
+: toggle (boolean | any): Bascule la synchronisation selon l'état précédent
+: passthrough (boolean): `true` transmet l'image à votre téléviseur sans synchronisation
+: intensity (string): L'intensité avec laquelle les lumières suivent l'image. L'une des valeurs `subtle`, `moderate`, `high` ou `intense`
+: brightness (int): Valeur en pourcentage de la luminosité (0-100)
+: brightnessLevel (int): Valeur numérique de la luminosité telle que le boîtier la compte (0-200, 100 étant la valeur de référence)
+: incrementBrightness (int | boolean): Indique de combien de pour cent la luminosité de la sync box doit être augmentée, ou `true` pour des pas de 10 %
+: decrementBrightness (int | boolean): Indique de combien de pour cent la luminosité de la sync box doit être réduite, ou `true` pour des pas de 10 %
+: input (string | int): L'entrée HDMI à afficher, soit `input1` à `input4`, soit simplement `1` à `4`
+: entertainmentArea (string): La zone de divertissement que le boîtier doit piloter, p. ex. `groups/13`
+
+### Messages de statut du nœud
+
+Chaque fois que l'état de la sync box change, le nœud renvoie le message de statut suivant :
+
+#### Objet de statut dans `msg.payload`
+
+: on (boolean): `false` tant que le boîtier est en veille
+: syncing (boolean): `true` tant que les lumières suivent l'image
+: passthrough (boolean): `true` tant que le boîtier transmet l'image sans synchronisation
+: mode (string): Le mode actuellement actif
+: lastSyncMode (string): Le dernier mode de synchronisation utilisé
+: intensity (string | boolean): Intensité du mode actuellement actif
+: brightness (int | boolean): Luminosité en pourcentage
+: brightnessLevel (int | boolean): Luminosité telle que le boîtier la compte (0-200)
+: input (string | boolean): L'entrée HDMI actuellement affichée
+: inputs (object): Les quatre entrées HDMI avec leur `name`, `type`, `status` (`unplugged`, `plugged`, `linked` ou `unknown`) et si elles sont `active`
+: entertainmentArea (string | boolean): La zone de divertissement pilotée par le boîtier
+: updated (string): Heure de la dernière mise à jour de la ressource par HueMagic (ISO 8601)
+
+#### Informations sur la sync box dans `msg.info`
+
+: id (string | boolean): L'ID unique de la sync box
+: name (string | boolean): Le nom actuellement attribué à la sync box
+: type (string): Le type de l'appareil (toujours `syncbox`)
+: ipAddress (string | boolean): L'adresse IP que le boîtier indique pour lui-même
+: softwareVersion (string | boolean): Le micrologiciel actuel de la sync box
+: apiLevel (int | boolean): Le niveau d'API de la sync box
+: ledMode (int | boolean): Le mode LED actuellement configuré
+: wifi (object | boolean): Contient `ssid` et `strength` de la connexion sans fil
+: model (object): Contient les informations de modèle de la sync box dans `id`, `manufacturer` et `name`
+
+#### Changements d'état dans `msg.updated`
+
+Énumère sous forme d'objet les paramètres qui ont changé par rapport au dernier état de la sync box. Si aucun changement n'a été enregistré, cet objet est vide.
+
+#### Dernier état de la sync box dans `msg.lastState`
+
+Contient l'objet de statut complet (voir les valeurs de sortie ci-dessus) du dernier état avant le dernier changement enregistré. Si HueMagic n'a pas encore enregistré le dernier état, `false` est émis.
+
+#### Dernière commande dans `msg.command` (facultatif)
+
+Si le statut du nœud a changé suite à une commande particulière, la commande complète qui a été exécutée est également émise. Sinon, cet objet n'est pas émis par le nœud.
+
+### Exemples de HueMagic
+
+HueMagic met à disposition quelques exemples de configuration pour ce nœud. Pour importer un exemple complet dans votre interface Node-RED, cliquez sur l'icône de menu de Node-RED, sélectionnez « Importer » puis naviguez vers « Exemples » dans la barre latérale de la fenêtre. Sélectionnez ensuite le dossier HueMagic et le nœud souhaité pour importer un flux d'exemple.
+
+![examples](hue/assets/huemagic-examples.gif)
+</script>