node-red-contrib-huemagic 4.2.2 → 5.0.0

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

@@ -0,0 +1,70 @@
+<script type="text/markdown" data-help-name="hue-brightness">
+Le nœud « Hue Luminosité » peut lire le niveau de luminosité actuel d'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.
+
+Le réglage « Sombre en dessous de » détermine à partir de quel niveau de luminosité le nœud considère qu'une pièce est sombre. Une pièce dotée d'une lampe puissante nécessite une valeur très différente d'un couloir sans fenêtre : saisissez donc simplement le nombre de lux qui convient à votre pièce. Les valeurs `dark` et `daylight` suivront alors votre réglage plutôt que la valeur par défaut de 90 lux.
+
+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 changement de luminosité 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 détecte un changement de luminosité, le message de statut suivant est renvoyé :
+
+#### 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
+: lux (int): Indique la valeur LUX réelle du niveau de luminosité
+: lightLevel (int): Indique l'intensité lumineuse du capteur
+: dark (boolean): `true` si l'obscurité a été enregistrée
+: daylight (boolean): `true` si la lumière du jour a été enregistrée
+: darkThreshold (int): Le niveau de luminosité en lux en dessous duquel le nœud signale l'obscurité
+: 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 `light_level`)
+: 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-brightness.json

@@ -0,0 +1,37 @@
+{
+	"hue-brightness": {
+		"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 de luminosité",
+			"searching": "Recherche de capteurs…",
+			"none-found": "Aucun capteur de luminosité trouvé !",
+			"sensor": "Capteur",
+			"all": "Tous les groupes / lumières",
+			"darkthreshold": "Sombre en dessous de"
+		},
+		"node": {
+			"not-configured": "non configuré",
+			"deactivated": "désactivé",
+			"init": "initialisation…",
+			"not-reachable": "non joignable",
+			"universal": "mode universel",
+			"command": "exécution de la commande…",
+			"statusmsg": "Statut interrogé avec succès…",
+			"title": "Hue Luminosité",
+			"lux": "__lux__ lux",
+			"lux-dark": "__lux__ lux (sombre)",
+			"lux-daylight": "__lux__ lux (lumière du jour)",
+			"input": "interrogation du statut",
+			"output": "luminosité (modifiée)",
+			"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."
+		}
+	}
+}

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

@@ -0,0 +1,59 @@
+<script type="text/markdown" data-help-name="hue-buttons">
+Le nœud « Hue Boutons » reçoit les événements de commutation des périphériques d'entrée reliés au bridge.
+
+### Configuration
+
+Sélectionnez le Hue Bridge préconfiguré et cliquez sur le bouton de recherche pour trouver tous les interrupteurs et boutons disponibles. Si vous connaissez déjà l'ID de l'interrupteur ou du bouton, vous pouvez également le saisir ici manuellement. Vous pouvez attribuer en interne un nouveau nom à l'appareil 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 d'événements de commutation. 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 l'interrupteur ou du bouton 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 interrupteur ou bouton 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.
+
+### Interroger le statut
+
+Émet le statut actuel de l'interrupteur ou du bouton 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 l'interrupteur ou du bouton
+
+### Messages de statut du nœud
+
+Dès qu'une touche est actionnée, le nœud renvoie le message de statut suivant :
+
+#### Objet de statut dans `msg.payload`
+
+: reachable (boolean | string): `true` si l'interrupteur ou le bouton 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
+: button (int | boolean): ID numérique de la touche actionnée en dernier ou `false` si aucune touche n'a été actionnée
+: action (string | boolean): `false` si aucune touche n'a été actionnée, ou `initial_press`, `repeat`, `short_release`, `long_press`, `long_release` ou `double_short_release` sous forme de chaîne
+: rotation (object | boolean): `false` si l'appareil n'a pas de molette ou n'a pas été tourné ; sinon un objet avec `action` (`start` ou `repeat`), `direction` (`clock_wise` ou `counter_clock_wise`), `clockwise` (booléen), `steps` (1000 pas correspondent à un tour complet), `degrees` et `duration` en millisecondes
+: updated (string): Heure de la dernière mise à jour de la ressource par HueMagic (ISO 8601)
+
+#### Informations sur l'interrupteur ou le bouton dans `msg.info`
+
+: id (string): Indique le nouvel ID de l'interrupteur ou du bouton
+: idV1 (string | boolean): Indique l'ancien ID de l'interrupteur ou du bouton
+: uniqueId (string): L'ID unique de l'interrupteur ou du bouton
+: deviceId (string): L'ID unique de l'appareil
+: name (string): Le nom actuellement attribué à l'interrupteur ou au bouton
+: type (string): Le type de l'interrupteur ou du bouton (toujours `button`)
+: softwareVersion (string): Le micrologiciel actuel de l'interrupteur ou du bouton
+: battery (float | boolean): Le niveau de batterie actuel de l'interrupteur ou du bouton, `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
+: model (object): Contient les informations de modèle de l'interrupteur ou du bouton 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 de l'interrupteur ou du bouton. Si aucun changement n'a été enregistré, cet objet est vide.
+
+#### Dernier état de l'interrupteur ou du bouton 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-buttons.json

@@ -0,0 +1,42 @@
+{
+	"hue-buttons": {
+		"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 bouton",
+			"searching": "Recherche de Hue Buttons…",
+			"none-found": "Aucun Hue Button trouvé !",
+			"button": "Bouton"
+		},
+		"node": {
+			"not-configured": "non configuré",
+			"universal": "mode universel",
+			"command": "exécution de la commande…",
+			"statusmsg": "Statut interrogé avec succès…",
+			"title": "Hue Boutons",
+			"waiting": "en attente…",
+			"button-on": "On",
+			"action-pressed": "appuyé",
+			"action-holded": "maintenu",
+			"action-shortreleased": "relâché brièvement",
+			"action-longreleased": "relâché après maintien",
+			"action-repeated": "répété",
+			"action-doublepressed": "double appui",
+			"dial-clockwise": "Molette ↻ __degrees__°",
+			"dial-counterclockwise": "Molette ↺ __degrees__°",
+			"button-status": "Bouton n° __button__ (__action__)",
+			"input": "interrogation du statut",
+			"output": "bouton appuyé",
+			"error-no-id": "Veuillez indiquer un ID de interrupteur valide.",
+			"error-not-available": "L'interrupteur 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-switchmode": "Cet appareil n'a pas de mode d'interrupteur configurable.",
+			"error-invalid-switchmode": "Mode d'interrupteur non valide. Cet appareil prend en charge : __modes__"
+		}
+	}
+}

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

@@ -0,0 +1,67 @@
+<script type="text/markdown" data-help-name="hue-contact">
+Le nœud « Hue Contact » indique si un capteur de contact (p. ex. Hue Secure) est actuellement ouvert ou fermé.
+
+### 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 changement de contact 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 contact change, 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
+: contact (string | boolean): `contact` si le contact est fermé, `no_contact` s'il est ouvert ou `false` si le capteur n'a pas encore transmis de valeur
+: changed (string | boolean): Heure du dernier changement de contact (ISO 8601) ou `false` si le capteur n'a pas encore transmis de valeur
+: tampered (boolean): Disponible uniquement sur les capteurs dotés d'une détection de manipulation ; `true` si le capteur a été manipulé
+: 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 `contact`)
+: softwareVersion (string): Le micrologiciel actuel du capteur
+: battery (float | boolean): Le niveau de batterie actuel du capteur, `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
+: 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-contact.json

@@ -0,0 +1,35 @@
+{
+	"hue-contact": {
+		"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 capteurs de contact…",
+			"none-found": "Aucun capteur de contact 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 Contact",
+			"contact": "contact",
+			"no-contact": "pas de contact",
+			"input": "activer / désactiver / statut",
+			"output": "contact",
+			"tampered": "manipulé",
+			"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."
+		}
+	}
+}

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

@@ -0,0 +1,87 @@
+<script type="text/markdown" data-help-name="hue-group">
+Le nœud « Hue Groupe » peut commander simultanément plusieurs lumières regroupées sur le bridge.
+
+### Configuration
+
+Sélectionnez le Hue Bridge préconfiguré et cliquez sur le bouton de recherche pour trouver tous les groupes disponibles. Si vous connaissez déjà l'ID d'un groupe, vous pouvez également le saisir ici manuellement. Vous pouvez attribuer en interne un nouveau nom au groupe 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. 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 groupe 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 groupe 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 groupe précis en transmettant l'ID du groupe correspondant sous forme de chaîne dans `msg.topic` avec vos réglages.
+
+### Interroger le statut
+
+Émet le statut actuel du groupe 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 groupe
+
+### Allumer / éteindre (mode simple)
+
+Pour allumer ou éteindre rapidement tout un groupe en mode simple, transmettez au nœud un objet ayant le contenu suivant.
+
+: payload (boolean): `true` allume tout le groupe, `false` l'éteint
+
+### Commandes de groupe (étendu)
+
+Outre le simple allumage et extinction, de nombreuses autres options sont disponibles pour commander le groupe. 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 le groupe :
+
+: on (boolean): `true` allume l'ensemble du groupe, `false` l'éteint
+: toggle (boolean | any): Bascule entre allumage et extinction, selon le statut précédent du groupe
+: 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): Valeur en pourcentage d'une variation relative de luminosité. La plage valide va de -100 % à +100 %. Les valeurs positives augmentent la luminosité. La valeur par défaut est +10 %
+: decrementBrightness (int): Valeur en pourcentage d'une variation relative de luminosité. La plage valide va de -100 % à +100 %. Les valeurs positives diminuent la luminosité. La valeur par défaut est +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
+: image (string): Chemin d'une image (locale ou sur le web) pour régler la couleur actuelle du groupe sur la couleur moyenne de l'image
+: colorTemp (int | string): Valeur comprise entre 153 et 500 pour régler la température de couleur du groupe, ou les valeurs `cold`, `normal`, `warm`, `hot` et `auto` — `auto` correspondant à la température de couleur basée sur l'heure actuelle
+: transitionTime (float): Temps de transition du réglage actuel en secondes. Si `0` est transmis, le groupe passe immédiatement au réglage souhaité. Si vous transmettez `3`, le groupe 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 du groupe
+: alert (float): Joue une animation « alert » pendant la durée choisie en secondes, puis rétablit l'état d'origine du groupe
+
+### Messages de statut du nœud
+
+Lorsqu'un changement est détecté dans le groupe, le nœud renvoie le message de statut suivant.
+
+> [!NOTE]
+> Le groupe n'émet des messages de statut que lorsque la dernière lumière est éteinte ou lorsque la première est allumée (si toutes étaient éteintes auparavant).
+
+Contrairement au nœud « Hue Lumière », vous disposez ici de beaucoup moins d'informations de statut, car un groupe peut contenir de nombreux types d'appareils différents avec des valeurs qui ne peuvent pas être combinées.
+
+#### Objet de statut dans `msg.payload`
+
+: on (boolean): État du groupe, où `true` signifie allumé et `false` éteint
+: brightness (float | boolean): Luminosité du groupe en pourcentage ou `false` si le groupe ne peut pas être variée
+: brightnessLevel (int | boolean): Luminosité du groupe sous forme de valeur numérique (0-254) ou `false` si le groupe ne peut pas être variée
+: rgb (array [0,0,0]): Couleur actuelle du groupe au format RGB (uniquement si disponible)
+: hex (string): Couleur actuelle du groupe au format hexadécimal (uniquement si disponible)
+: xyColor (object {x [float], y [float]}): Couleur actuelle du groupe au format XY (uniquement si disponible)
+: colorTemp (int): Température de couleur actuellement définie pour le groupe (uniquement si disponible)
+: updated (string): Heure de la dernière mise à jour de la ressource par HueMagic (ISO 8601)
+
+#### Informations sur le groupe dans `msg.info`
+
+: id (string): Indique le nouvel ID du groupe
+: idV1 (string | boolean): Indique l'ancien ID du groupe
+: name (string): Le nom actuellement attribué au groupe
+: resources (object) : Contient tous les appareils et ressources rattachés au groupe
+: type (string): Le type du groupe (toujours `group`)
+
+#### Changements d'état dans `msg.updated`
+
+Énumère sous forme d'objet les paramètres qui ont changé par rapport au dernier état du groupe. 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-group.json

@@ -0,0 +1,46 @@
+{
+	"hue-group": {
+		"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 du groupe",
+			"searching": "Recherche de groupes…",
+			"none-found": "Aucun groupe trouvé !",
+			"group": "Groupe",
+			"all": "Tous les groupes / lumières"
+		},
+		"node": {
+			"not-configured": "non configuré",
+			"init": "initialisation…",
+			"universal": "mode universel",
+			"command": "exécution de la commande…",
+			"statusmsg": "Statut interrogé avec succès…",
+			"title": "Hue Groupe",
+			"brightness": " (__percent__ %)",
+			"all-on": "toutes les lumières allumées",
+			"all-off": "toutes les lumières éteintes",
+			"some-on": "certaines lumières allumées",
+			"turned-on": "allumé",
+			"error-input": "erreur de saisie",
+			"error-no-id": "Aucun ID de groupe indiqué.",
+			"error-invalid-sat": "Réglage de saturation non valide. Seules les valeurs de 0 à 254 sont autorisées.",
+			"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": "Le groupe 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-increment": "Réglage incrementBrightness non valide. Seules les valeurs de -100 % à 100 % sont autorisées.",
+			"error-invalid-decrement": "Réglage decrementBrightness non valide. Seules les valeurs de -100 % à 100 % sont autorisées.",
+			"error-no-colorloop": "L'effet colorloop n'est pas disponible pour ce groupe."
+		}
+	}
+}

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__"
+		}
+	}
+}