node-red-contrib-huemagic 4.2.2 → 5.0.1

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

@@ -0,0 +1,97 @@
+<script type="text/markdown" data-help-name="hue-light">
+Le nœud « Hue Lumière » peut commander les lumières reliées au bridge et recevoir leurs messages de statut.
+
+### Configuration
+
+Sélectionnez le Hue Bridge préconfiguré et cliquez sur le bouton de recherche pour trouver toutes les lumières disponibles. Si vous connaissez déjà l'ID d'une lumière, vous pouvez également le saisir ici manuellement. Vous pouvez attribuer en interne un nouveau nom à la lumière 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 de la lumière sélectionnée 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 activez le réglage « Activer la dénomination des couleurs », le nœud tentera de décrire la couleur de lumière définie pour chaque message de statut. Vous recevrez alors dans la sortie un paramètre supplémentaire contenant la description en anglais de la couleur actuelle.
+
+Si vous ne sélectionnez aucune lumière 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 lumière précise en transmettant l'ID de la lumière correspondante sous forme de chaîne dans `msg.topic` avec vos réglages.
+
+### Interroger le statut
+
+Émet le statut actuel de la lumière 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 lumière
+
+### Allumer / éteindre la lumière (mode simple)
+
+Pour allumer ou éteindre rapidement une lumière en mode simple, transmettez au nœud un objet ayant le contenu suivant :
+
+: payload (boolean): `true` allume la lumière, `false` l'éteint
+
+### Commandes de lumière (étendu)
+
+Outre le simple allumage et extinction, de nombreuses autres options sont disponibles pour commander la lumière. Tous les nœuds de HueMagic peuvent être pilotés avec des commandes additives. Cela signifie que vous pouvez transmettre d'abord un réglage, puis un autre dans une commande ultérieure sans annuler le réglage précédent. Transmettez les paramètres suivants dans un objet `msg.payload` pour effectuer des réglages plus poussés sur la lumière :
+
+: on (boolean): `true` allume la lumière, `false` l'éteint
+: toggle (boolean | any): Bascule entre allumage et extinction, selon le statut précédent de la lumière
+: brightness (int | string): Valeur en pourcentage de la luminosité (0-100) ou une chaîne contenant la valeur `auto` pour régler automatiquement la luminosité en fonction de l'heure actuelle
+: brightnessLevel (int): Valeur numérique de la luminosité (0-254)
+: incrementBrightness (int | boolean): Indique de combien de pour cent la lumière doit être éclaircie, ou `true` pour l'éclaircir par pas de 10 %
+: decrementBrightness (int | boolean): Indique de combien de pour cent la lumière doit être assombrie, ou `true` pour l'assombrir par pas de 10 %
+: color (string): `random` pour définir une couleur aléatoire ou un nom de couleur en anglais (p. ex. `red`)
+: hex (string): Valeur de couleur en hexadécimal sous forme de chaîne
+: rgb (array [0,0,0]): Valeur de couleur au format RGB sous forme de tableau
+: xyColor (object {x [float], y [float]}): Valeur de couleur au format XY sous forme d'objet
+: gradient (object {hex […]}): Un objet contenant un objet de couleur pris en charge (p. ex. `hex`, `rgb`, …) et plusieurs couleurs pour appliquer un dégradé aux lumières compatibles
+: mixColor (object): Une couleur à mélanger à la couleur de lumière actuelle. Accepte les objets `color`, `hex`, `rgb` ou `xyColor` et, en option, `amount` (int) pour indiquer la proportion de mélange en pourcentage
+: image (string): Chemin d'une image (locale ou sur le web) pour régler la couleur actuelle de la lumière sur la couleur moyenne de l'image
+: saturation (int): Pourcentage de saturation de la couleur actuelle (bêta)
+: colorTemp (int | string): Valeur comprise entre 153 et 500 pour régler la température de couleur de la lumière, ou les valeurs `cold`, `normal`, `warm`, `hot` et `auto` — `auto` correspondant à la température de couleur basée sur l'heure actuelle
+: incrementColorTemp (int | boolean): Valeur indiquant de combien la température de couleur doit être plus chaude, ou `true` pour la réchauffer par pas de 50
+: decrementColorTemp (int | boolean): Valeur indiquant de combien la température de couleur doit être plus froide, ou `true` pour la refroidir par pas de 50
+: transitionTime (float): Temps de transition du réglage actuel en secondes. Si `0` est indiqué, la lumière passe immédiatement au réglage souhaité. Si `3` est indiqué, la lumière passe au réglage souhaité avec une légère transition sur les 3 secondes suivantes
+: colorloop (float): Joue une animation « colorloop » pendant la durée choisie en secondes, puis rétablit l'état d'origine de la lumière
+: alert (float): Joue une animation « alert » pendant la durée choisie en secondes, puis rétablit l'état d'origine de la lumière
+
+### Messages de statut du nœud
+
+Dès qu'un changement des réglages de la lumière est détecté (que ce soit via Node-RED ou depuis l'extérieur), le nœud renvoie le message de statut suivant :
+
+#### Objet de statut dans `msg.payload`
+
+: on (boolean): État de la lumière, où `true` signifie allumée et `false` éteinte
+: brightness (int | boolean): Luminosité actuelle en pourcentage ou `false` si la lumière ne prend pas en charge le réglage de luminosité
+: brightnessLevel (int | boolean): Luminosité actuelle de 0 à 254 ou `false` si la lumière ne prend pas en charge le réglage de luminosité
+: reachable (boolean | string): `true` si la lumière est connectée 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
+: rgb (array [int, int, int] | optional): Couleur de lumière actuelle sous forme de valeur RGB, si la lumière peut afficher des couleurs
+: hex (string | optional): Couleur de lumière actuelle sous forme de valeur hexadécimale, si la lumière peut afficher des couleurs
+: xyColor (object {x [float], y [float]} | optional): Couleur de lumière actuelle sous forme de valeur XY, si la lumière peut afficher des couleurs
+: color (string | optional): Nom actuel de la couleur en anglais, si la lumière peut afficher des couleurs et que le réglage correspondant du nœud est activé
+: gradient (object | optional): Réglage de dégradé actuel avec toutes les unités de couleur disponibles sous forme de tableau, si la lumière prend en charge les dégradés, où `colors` renvoie les couleurs, `numColors` le nombre de couleurs définies dans le dégradé et `totalColors` le nombre maximal de couleurs que la ressource peut gérer dans le dégradé
+: colorTemp (int | boolean | optional): Température de couleur actuelle de la lumière, si la lumière prend en charge les températures de couleur et qu'une valeur a été définie
+: colorTempName (string | optional): Température de couleur actuelle de la lumière sous forme de chaîne descriptive avec les valeurs `cold`, `normal`, `warm` ou `hot`, si la lumière prend en charge les températures de couleur et qu'une valeur a été définie. Sinon, `unknown` est émis
+: updated (string): Heure de la dernière mise à jour de la ressource par HueMagic (ISO 8601)
+
+#### Informations sur la lumière dans `msg.info`
+
+: id (string): Indique le nouvel ID de la lumière
+: idV1 (string | boolean): Indique l'ancien ID de la lumière
+: uniqueId (string): L'ID unique de la lumière
+: deviceId (string): L'ID unique de l'appareil
+: name (string): Le nom actuellement attribué à la lumière
+: type (string): Le type de la lumière (toujours `light`)
+: softwareVersion (string): Le micrologiciel actuel de la lumière
+: model (object): Contient les informations de modèle de la lumière dans `id`, `manufacturer`, `name`, `type`, `certified`, `friendsOfHue`, `colorGamut` et `colorGamutType`
+
+#### 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 lumière. Si aucun changement n'a été enregistré, cet objet est vide.
+
+#### Dernier état de la lumière dans `msg.lastState`
+
+Contient l'objet de statut complet (voir les valeurs de sortie ci-dessus) du dernier état avant le dernier changement. 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-light.json

@@ -0,0 +1,44 @@
+{
+	"hue-light": {
+		"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)",
+			"colornamer": "Colornamer",
+			"colornamer-info": "Activer la dénomination des couleurs",
+			"input-name": "Nom de la lumière",
+			"searching": "Recherche de lumières…",
+			"none-found": "Aucune lumière trouvée !",
+			"light": "Lumière"
+		},
+		"node": {
+			"not-configured": "non configuré",
+			"init": "initialisation…",
+			"not-reachable": "non joignable",
+			"universal": "mode universel",
+			"command": "exécution de la commande…",
+			"statusmsg": "Statut interrogé avec succès…",
+			"title": "Hue Lumière",
+			"turned-on": "allumée",
+			"turned-on-percent": "allumée (__percent__ %)",
+			"turned-off": "éteinte",
+			"error-no-id": "Aucun ID de lumière défini. Consultez la documentation.",
+			"error-input": "erreur de saisie",
+			"error-invalid-temp": "Température de couleur non valide. Seules les valeurs de 153 à 500 sont autorisées.",
+			"input": "allumer / éteindre",
+			"output": "statut",
+			"error-not-available": "La lumière 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.",
+			"error-invalid-brightness-level": "Réglage de luminosité non valide. Seules les valeurs de 0 à 254 sont autorisées.",
+			"error-invalid-sat": "Réglage de saturation non valide. Seules les valeurs de 0 à 100 sont autorisées.",
+			"error-no-colorloop": "L'effet colorloop n'est pas disponible pour cette lumière.",
+			"error-invalid-effect": "Effet non valide. Cette lumière prend en charge : __effects__",
+			"error-invalid-powerup": "Réglage de mise sous tension non valide. Préréglages autorisés : __presets__"
+		}
+	}
+}

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>