node-red-contrib-huemagic 4.2.2 → 5.0.0

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

@@ -0,0 +1,97 @@
+<script type="text/markdown" data-help-name="hue-light">
+El nodo «Hue Luz» puede controlar las luces conectadas al bridge y recibir sus mensajes de estado.
+
+### Configuración
+
+Seleccione el Hue Bridge preconfigurado y haga clic en el botón de búsqueda para encontrar todas las luces disponibles. Si ya conoce el ID de una luz, también puede introducirlo aquí manualmente. Puede asignar internamente un nombre nuevo a la luz o utilizar el nombre predefinido. De forma opcional, puede desactivar todos los mensajes de estado automáticos de este nodo mediante el ajuste «Omitir los mensajes del nodo». El nodo dejará entonces de emitir actualizaciones del dispositivo. También puede elegir que el mensaje de inicialización del nodo no se suprima al iniciar Node-RED. Si activa este ajuste, recibirá un mensaje de estado de la luz seleccionada después de cada despliegue. Si prefiere que el nodo permanezca en silencio hasta que usted le envíe algo, active «Informar solo tras un comando». En ese caso ignorará los cambios realizados desde la app o desde un interruptor y solo responderá a sus propios comandos.
+
+Si activa el ajuste «Activar los nombres de color», el nodo intentará describir el color de luz configurado en cada mensaje de estado. En ese caso recibirá en la salida un parámetro adicional con la descripción en inglés del color actual.
+
+Si no selecciona ninguna luz y utiliza así la configuración del nodo, el nodo funciona en el llamado «modo universal». En este modo, el nodo recibe y emite todos los mensajes de estado del mismo tipo. También puede aplicar ajustes en modo universal a una luz concreta pasando el ID de la luz correspondiente como cadena en `msg.topic` junto con sus ajustes.
+
+### Consultar el estado
+
+Emite el estado actual de la luz en cuanto se transfiere al nodo un objeto `msg.payload` con el siguiente contenido. Como alternativa, también puede pulsar el botón en la interfaz de Node-RED sin tener que enviar antes ningún mensaje al nodo.
+
+: status (boolean): Devuelve el estado actual de la luz
+
+### Encender / apagar la luz (modo sencillo)
+
+Para encender o apagar rápidamente una luz en el modo sencillo, pase al nodo un objeto con el siguiente contenido:
+
+: payload (boolean): `true` enciende la luz, `false` la apaga
+
+### Comandos de luz (ampliado)
+
+Además de encender y apagar sin más, hay muchas otras opciones disponibles para controlar la luz. Todos los nodos de HueMagic se pueden controlar con comandos aditivos. Esto significa que puede pasar primero un ajuste y después otro en un comando posterior sin descartar el ajuste anterior. Transfiera los siguientes parámetros en un objeto `msg.payload` para realizar ajustes más amplios en la luz:
+
+: on (boolean): `true` enciende la luz, `false` la apaga
+: toggle (boolean | any): Alterna entre encendido y apagado, según el estado anterior de la luz
+: brightness (int | string): Valor porcentual del brillo de la luz (0-100) o una cadena con el valor `auto` para ajustar el brillo automáticamente en función de la hora actual
+: brightnessLevel (int): Valor numérico del brillo de la luz (0-254)
+: incrementBrightness (int | boolean): Indica en cuántos puntos porcentuales debe aumentarse el brillo de la luz, o `true` para aclararla en pasos del 10 %
+: decrementBrightness (int | boolean): Indica en cuántos puntos porcentuales debe reducirse el brillo de la luz, o `true` para oscurecerla en pasos del 10 %
+: color (string): `random` para establecer un color aleatorio o un nombre de color en inglés (p. ej. `red`)
+: hex (string): Valor de color en hexadecimal en forma de cadena
+: rgb (array [0,0,0]): Valor de color en formato RGB en forma de array
+: xyColor (object {x [float], y [float]}): Valor de color en el formato de color XY en forma de objeto
+: gradient (object {hex […]}): Un objeto con un objeto de color admitido (p. ej. `hex`, `rgb`, …) y varios colores para aplicar un degradado a las luces compatibles
+: mixColor (object): Un color que se mezcla con el color de luz actual. Admite objetos `color`, `hex`, `rgb` o `xyColor` y, opcionalmente, `amount` (int) para indicar la proporción de mezcla en porcentaje
+: image (string): Ruta de una imagen (local o en la web) para ajustar el color actual de la luz al color medio de la imagen
+: saturation (int): Porcentaje de saturación del color actual (beta)
+: colorTemp (int | string): Valor entre 153 y 500 para ajustar la temperatura de color de la luz, o los valores `cold`, `normal`, `warm`, `hot` y `auto`, donde `auto` fija la temperatura de color en función de la hora actual
+: incrementColorTemp (int | boolean): Valor que indica cuánto debe subir la temperatura de color hacia el cálido, o `true` para hacerla más cálida en pasos de 50
+: decrementColorTemp (int | boolean): Valor que indica cuánto debe bajar la temperatura de color hacia el frío, o `true` para hacerla más fría en pasos de 50
+: transitionTime (float): Tiempo de transición del ajuste actual en segundos. Si se indica `0`, la luz cambia de inmediato al ajuste deseado. Si se indica `3`, la luz pasa al ajuste deseado con una ligera transición en los 3 segundos siguientes
+: colorloop (float): Reproduce una animación «colorloop» durante los segundos indicados y después vuelve al estado original de la luz
+: alert (float): Reproduce una animación «alert» durante los segundos indicados y después vuelve al estado original de la luz
+
+### Mensajes de estado del nodo
+
+En cuanto se detecta un cambio en los ajustes de la luz (ya sea a través de Node-RED o de forma externa), el nodo devuelve el siguiente mensaje de estado:
+
+#### Objeto de estado en `msg.payload`
+
+: on (boolean): Estado de la luz, donde `true` significa encendida y `false` apagada
+: brightness (int | boolean): Brillo actual en porcentaje o `false` si la luz no admite ajuste de brillo
+: brightnessLevel (int | boolean): Brillo actual de 0 a 254 o `false` si la luz no admite ajuste de brillo
+: reachable (boolean | string): `true` si la luz está conectada al bridge, `unknown` si el estado de la conexión difiere
+: connectionStatus (string): El estado actual de la conexión con el bridge en forma de cadena. Puede contener `connected`, `disconnected`, `connectivity_issue` o `unidirectional_incoming` como valor
+: rgb (array [int, int, int] | optional): Color de luz actual en forma de valor RGB, si la luz puede mostrar colores
+: hex (string | optional): Color de luz actual en forma de valor hexadecimal, si la luz puede mostrar colores
+: xyColor (object {x [float], y [float]} | optional): Color de luz actual en forma de valor XY, si la luz puede mostrar colores
+: color (string | optional): Nombre actual del color en inglés, si la luz puede mostrar colores y se ha activado el ajuste correspondiente del nodo
+: gradient (object | optional): Ajuste de degradado actual con todas las unidades de color disponibles en forma de array, si la luz admite degradados, donde `colors` devuelve los colores, `numColors` el número de colores definidos en el degradado y `totalColors` el número máximo de colores que el recurso puede admitir en el degradado
+: colorTemp (int | boolean | optional): Temperatura de color actual de la luz, si la luz puede mostrar temperaturas de color y se ha definido una
+: colorTempName (string | optional): Temperatura de color actual de la luz en forma de cadena descriptiva con los valores `cold`, `normal`, `warm` o `hot`, si la luz puede mostrar temperaturas de color y se ha definido una. En caso contrario se emite `unknown`
+: updated (string): Momento de la última actualización del recurso por parte de HueMagic (ISO 8601)
+
+#### Información sobre la luz en `msg.info`
+
+: id (string): Indica el nuevo ID de la luz
+: idV1 (string | boolean): Indica el ID antiguo de la luz
+: uniqueId (string): El ID único de la luz
+: deviceId (string): El ID único del dispositivo
+: name (string): El nombre asignado actualmente a la luz
+: type (string): El tipo de luz (siempre `light`)
+: softwareVersion (string): El firmware actual de la luz
+: model (object): Contiene la información de modelo de la luz en `id`, `manufacturer`, `name`, `type`, `certified`, `friendsOfHue`, `colorGamut` y `colorGamutType`
+
+#### Cambios de estado en `msg.updated`
+
+Enumera en forma de objeto los parámetros concretos que han cambiado con respecto al último estado de la luz. Si no se ha registrado ningún cambio, este objeto está vacío.
+
+#### Último estado de la luz en `msg.lastState`
+
+Contiene el objeto de estado completo (véanse los valores de salida anteriores) del último estado antes del último cambio. Si HueMagic aún no ha registrado el último estado, se emite `false`.
+
+#### Último comando en `msg.command` (opcional)
+
+Si el estado del nodo ha cambiado mediante un comando concreto, también se emite el comando completo que se ha ejecutado. De lo contrario, el nodo no emite este objeto.
+
+### Ejemplos de HueMagic
+
+HueMagic pone a su disposición algunas configuraciones de ejemplo para este nodo. Para importar un ejemplo completo en su interfaz de Node-RED, haga clic en el icono de menú de Node-RED, seleccione «Importar» y navegue hasta «Ejemplos» en la barra lateral de la ventana emergente. A continuación, seleccione la carpeta HueMagic y el nodo que desee para importar un flujo de ejemplo.
+
+![examples](hue/assets/huemagic-examples.gif)
+</script>

package/huemagic/locales/es/hue-light.json

@@ -0,0 +1,44 @@
+{
+	"hue-light": {
+		"config": {
+			"name": "Nombre",
+			"skipevents-node": "Omitir los mensajes del nodo",
+			"sendinitevents-node": "No suprimir el evento de inicialización",
+			"onlycommands-node": "Informar solo tras un comando",
+			"unknown-error": "Algo ha salido mal. Inténtelo de nuevo.",
+			"bridge": "Bridge",
+			"universalevents": "Eventos universales",
+			"universalevents-node": "Recibe todos los mensajes de otros nodos del mismo tipo (solo en modo universal)",
+			"colornamer": "Colornamer",
+			"colornamer-info": "Activar los nombres de color",
+			"input-name": "Nombre de la luz",
+			"searching": "Buscando luces…",
+			"none-found": "¡No se ha encontrado ninguna luz!",
+			"light": "Luz"
+		},
+		"node": {
+			"not-configured": "sin configurar",
+			"init": "inicializando…",
+			"not-reachable": "no accesible",
+			"universal": "modo universal",
+			"command": "ejecutando comando…",
+			"statusmsg": "Estado consultado correctamente…",
+			"title": "Hue Luz",
+			"turned-on": "encendida",
+			"turned-on-percent": "encendida (__percent__ %)",
+			"turned-off": "apagada",
+			"error-no-id": "No se ha definido ningún ID de luz. Consulte la documentación.",
+			"error-input": "error de entrada",
+			"error-invalid-temp": "Temperatura de color no válida. Solo se permite de 153 a 500.",
+			"input": "encender / apagar",
+			"output": "estado",
+			"error-not-available": "La luz aún no está disponible. Espere hasta que HueMagic haya establecido la conexión con el bridge o compruebe si el ID del recurso indicado en la configuración es válido.",
+			"error-invalid-brightness": "Ajuste de brillo no válido. Solo se permite de 0 a 100 por ciento.",
+			"error-invalid-brightness-level": "Ajuste de brillo no válido. Solo se permite de 0 a 254.",
+			"error-invalid-sat": "Ajuste de saturación no válido. Solo se permite de 0 a 100.",
+			"error-no-colorloop": "El efecto colorloop no está disponible para esta luz.",
+			"error-invalid-effect": "Efecto no válido. Esta luz admite: __effects__",
+			"error-invalid-powerup": "Ajuste de encendido no válido. Los preajustes permitidos son: __presets__"
+		}
+	}
+}

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

@@ -0,0 +1,68 @@
+<script type="text/markdown" data-help-name="hue-magic">
+El nodo «Hue Magic» puede aplicar animaciones complejas y personalizadas a luces y grupos.
+
+### Configuración
+
+Asigne primero un nombre al nodo para poder identificar claramente su animación en la interfaz de Node-RED. A continuación puede elegir entre las opciones «Bucle» y «Restaurar». Seleccione la opción de bucle si desea que su animación se ejecute indefinidamente en una luz o un grupo hasta que la detenga manualmente. Si desea restaurar el estado anterior del recurso de destino (luz o grupo) una vez finalizada la animación, marque la opción «Restaurar». De lo contrario, el último fotograma de la animación permanecerá en el recurso correspondiente.
+
+Más abajo puede elegir entre las animaciones ya preparadas de HueMagic. Haga clic en la animación que desee para aplicarla.
+
+### Iniciar / detener la animación
+
+Para reproducir o detener una animación, pase al nodo un objeto con el siguiente contenido:
+
+: payload (boolean): `true` inicia la animación, `false` la detiene
+
+### Animaciones personalizadas
+
+Si pasa su propia animación al nodo, la animación predefinida seleccionada (si la hay) se sustituye temporalmente por la suya. Las animaciones propias de HueMagic son una secuencia de comandos agrupados en un array. Cada elemento del array constituye un paso, y un paso puede constar a su vez de varios fotogramas (efectos de transición).
+
+Cree un `array` con los distintos pasos de la animación en forma de objeto y transfiéralo al nodo HueMagic en `msg.payload.steps`.
+
+: delay (int): Número de milisegundos que se espera hasta ejecutar este paso
+: animation (object): El objeto contiene la acción o acciones que se deben ejecutar en este paso. Los parámetros son idénticos a los de los nodos «Hue Luz» y «Hue Grupo»
+
+### Ejemplo de una animación personalizada
+
+Este ejemplo muestra el aspecto que podría tener una animación sencilla. En el primer paso se espera el retardo de 500 milisegundos. Después, el color de la luz cambia lentamente a rojo a lo largo de un segundo. En cuanto la luz ha pasado completamente a rojo, se ejecuta el segundo paso, que también tiene un retardo de 500 milisegundos. Por último, el color cambia a azul.
+
+Si ha configurado la animación en bucle, este proceso se repite indefinidamente hasta que detenga la animación manualmente o vuelva a desplegar el nodo.
+
+Pase el siguiente objeto en `msg.payload` para reproducir la animación de ejemplo.
+
+    {
+        "animate": true,
+        "steps": [
+            {
+                "delay": 500,
+                "animation": {
+                    "hex": "#FF0000",
+                    "transitionTime": 1
+                }
+            },
+            {
+                "delay": 500,
+                "animation": {
+                    "hex": "#0000FF",
+                    "transitionTime": 1
+                }
+            }
+        ]
+    }
+
+### Comandos especiales
+
+A veces tiene sentido reproducir una animación de forma desordenada, p. ej. si se quiere imitar el fuego de manera más realista. Para reproducir los pasos individuales de forma aleatoria, puede pasar el siguiente comando en `msg.payload.specials`:
+
+: randomOrder (boolean | any): `true` activa la reproducción aleatoria de los distintos pasos de la animación
+
+### Consejos e indicaciones
+
+Este nodo no emite mensajes de estado. Conecte la salida del nodo a un grupo en lugar de a luces individuales si desea animar varias luces a la vez con la misma animación. Las vistas previas de las animaciones predefinidas son simulaciones y pueden diferir ligeramente (tiempos, colores) de la animación real sobre un recurso.
+
+### Ejemplos de HueMagic
+
+HueMagic pone a su disposición algunas configuraciones de ejemplo para este nodo. Para importar un ejemplo completo en su interfaz de Node-RED, haga clic en el icono de menú de Node-RED, seleccione «Importar» y navegue hasta «Ejemplos» en la barra lateral de la ventana emergente. A continuación, seleccione la carpeta HueMagic y el nodo que desee para importar un flujo de ejemplo.
+
+![examples](hue/assets/huemagic-examples.gif)
+</script>

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

@@ -0,0 +1,26 @@
+{
+	"hue-magic": {
+		"config": {
+			"name": "Nombre",
+			"input-name": "Nombre de la animación",
+			"loop": "Bucle",
+			"loop-endless": "Repetir indefinidamente",
+			"restore": "Restaurar",
+			"restore-state": "Restaurar el estado anterior al detener",
+			"animation": "Animación",
+			"unknown-error": "Algo ha salido mal. Inténtelo de nuevo.",
+			"seconds": "s",
+			"minutes": "min"
+		},
+		"node": {
+			"title": "Hue Magic",
+			"no-animation": "ninguna animación indicada",
+			"animating": "animando…",
+			"stopped": "detenida",
+			"input": "iniciar / detener animación",
+			"output": "luz o grupo",
+			"command": "ejecutando comando…",
+			"playmsg": "Animación iniciada…"
+		}
+	}
+}

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

@@ -0,0 +1,64 @@
+<script type="text/markdown" data-help-name="hue-motion">
+El nodo «Hue Movimiento» puede registrar y comunicar los movimientos detectados por un sensor adecuado conectado al bridge.
+
+### Configuración
+
+Seleccione el Hue Bridge preconfigurado y haga clic en el botón de búsqueda para encontrar todos los sensores disponibles. Si ya conoce el ID del sensor, también puede introducirlo aquí manualmente. Puede asignar internamente un nombre nuevo al sensor o utilizar el nombre predefinido. De forma opcional, puede desactivar todos los mensajes de estado automáticos de este nodo mediante el ajuste «Omitir los mensajes del nodo». El nodo dejará entonces de emitir actualizaciones del dispositivo. También puede elegir que el mensaje de inicialización del nodo no se suprima al iniciar Node-RED. Si activa este ajuste, recibirá un mensaje de estado del sensor seleccionado después de cada despliegue. Si prefiere que el nodo permanezca en silencio hasta que usted le envíe algo, active «Informar solo tras un comando». En ese caso ignorará los cambios realizados desde la app o desde un interruptor y solo responderá a sus propios comandos.
+
+Si no selecciona ningún sensor y utiliza así la configuración del nodo, el nodo funciona en el llamado «modo universal». En este modo, el nodo recibe y emite todos los mensajes de estado del mismo tipo. También puede aplicar ajustes en modo universal a un sensor concreto pasando el ID del sensor correspondiente como cadena en `msg.topic` junto con sus ajustes.
+
+### Consultar el estado
+
+Emite el estado actual del sensor en cuanto se transfiere al nodo un objeto `msg.payload` con el siguiente contenido. Como alternativa, también puede pulsar el botón en la interfaz de Node-RED sin tener que enviar antes ningún mensaje al nodo.
+
+: status (boolean): Devuelve el estado actual del sensor
+
+### Encender / apagar el sensor
+
+Si es necesario, el sensor puede encenderse y apagarse de forma remota. Si el sensor está apagado, deja de registrar movimientos y, por tanto, ya no los emite. Para ello, pase un objeto con el siguiente contenido:
+
+: payload (boolean): `true` enciende el sensor, `false` lo apaga
+
+### Mensajes de estado del nodo
+
+En cuanto el sensor registra un movimiento, el nodo devuelve el siguiente mensaje de estado:
+
+#### Objeto de estado en `msg.payload`
+
+: active (boolean): Indica si el sensor está encendido o apagado
+: reachable (boolean | string): `true` si el sensor está conectado al bridge, `unknown` si el estado de la conexión difiere
+: connectionStatus (string): El estado actual de la conexión con el bridge en forma de cadena. Puede contener `connected`, `disconnected`, `connectivity_issue` o `unidirectional_incoming` como valor
+: motion (boolean): Indica si se ha registrado movimiento
+: updated (string): Momento de la última actualización del recurso por parte de HueMagic (ISO 8601)
+
+#### Información sobre el sensor en `msg.info`
+
+: id (string): Indica el nuevo ID del sensor
+: idV1 (string | boolean): Indica el ID antiguo del sensor
+: uniqueId (string): El ID único del sensor
+: deviceId (string): El ID único del dispositivo
+: name (string): El nombre asignado actualmente al sensor
+: type (string): El tipo de sensor (siempre `motion`)
+: softwareVersion (string): El firmware actual del sensor
+: battery (float): El nivel de batería actual del sensor
+: batteryState (string): El estado actual del nivel de batería. Puede contener `normal`, `low` o `critical` como valor
+: model (object): Contiene la información de modelo del sensor en `id`, `manufacturer`, `name`, `type` y `certified`
+
+#### Cambios de estado en `msg.updated`
+
+Enumera en forma de objeto los parámetros concretos que han cambiado con respecto al último estado del sensor. Si no se ha registrado ningún cambio, este objeto está vacío.
+
+#### Último estado del sensor en `msg.lastState`
+
+Contiene el objeto de estado completo (véanse los valores de salida anteriores) del último estado antes del último cambio registrado. Si HueMagic aún no ha registrado el último estado, se emite `false`.
+
+#### Último comando en `msg.command` (opcional)
+
+Si el estado del nodo ha cambiado mediante un comando concreto, también se emite el comando completo que se ha ejecutado. De lo contrario, el nodo no emite este objeto.
+
+### Ejemplos de HueMagic
+
+HueMagic pone a su disposición algunas configuraciones de ejemplo para este nodo. Para importar un ejemplo completo en su interfaz de Node-RED, haga clic en el icono de menú de Node-RED, seleccione «Importar» y navegue hasta «Ejemplos» en la barra lateral de la ventana emergente. A continuación, seleccione la carpeta HueMagic y el nodo que desee para importar un flujo de ejemplo.
+
+![examples](hue/assets/huemagic-examples.gif)
+</script>

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

@@ -0,0 +1,36 @@
+{
+	"hue-motion": {
+		"config": {
+			"name": "Nombre",
+			"skipevents-node": "Omitir los mensajes del nodo",
+			"sendinitevents-node": "No suprimir el evento de inicialización",
+			"onlycommands-node": "Informar solo tras un comando",
+			"unknown-error": "Algo ha salido mal. Inténtelo de nuevo.",
+			"bridge": "Bridge",
+			"universalevents": "Eventos universales",
+			"universalevents-node": "Recibe todos los mensajes de otros nodos del mismo tipo (solo en modo universal)",
+			"input-name": "Nombre del sensor",
+			"searching": "Buscando sensores de movimiento…",
+			"none-found": "¡No se ha encontrado ningún sensor de movimiento!",
+			"sensor": "Sensor"
+		},
+		"node": {
+			"not-configured": "sin configurar",
+			"not-reachable": "no accesible",
+			"activated": "activado",
+			"deactivated": "desactivado",
+			"universal": "modo universal",
+			"command": "ejecutando comando…",
+			"statusmsg": "Estado consultado correctamente…",
+			"title": "Hue Movimiento",
+			"motion": "movimiento detectado",
+			"no-motion": "sin movimiento",
+			"input": "activar / desactivar / estado",
+			"output": "movimiento detectado",
+			"error-no-id": "Indique un ID de sensor válido.",
+			"error-not-available": "El sensor aún no está disponible. Espere hasta que HueMagic haya establecido la conexión con el bridge o compruebe si el ID del recurso indicado en la configuración es válido.",
+			"error-no-sensitivity": "Esta fuente de movimiento no tiene una sensibilidad ajustable.",
+			"error-invalid-sensitivity": "Sensibilidad no válida. Solo se permite de 0 a __max__."
+		}
+	}
+}

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

@@ -0,0 +1,69 @@
+<script type="text/markdown" data-help-name="hue-rules">
+El nodo «Hue Regla» puede activar o desactivar las reglas guardadas en el bridge y consultar sus ajustes.
+
+### Configuración
+
+Seleccione el Hue Bridge preconfigurado y haga clic en el botón de búsqueda para encontrar todas las reglas disponibles. Si ya conoce el ID de la regla, también puede introducirlo aquí manualmente. Como alternativa, puede asignar un nombre nuevo o utilizar el nombre predefinido de la regla. De forma opcional, puede desactivar todos los mensajes de estado automáticos de este nodo mediante el ajuste «Omitir los mensajes del nodo». El nodo dejará entonces de emitir actualizaciones. También puede elegir que el mensaje de inicialización del nodo no se suprima al iniciar Node-RED. Si prefiere que el nodo permanezca en silencio hasta que usted le envíe algo, active «Informar solo tras un comando». En ese caso ignorará los cambios realizados desde la app o desde un interruptor y solo responderá a sus propios comandos.
+
+Si no selecciona ninguna regla y utiliza así la configuración del nodo, el nodo funciona en el llamado «modo universal». En este modo, el nodo recibe y emite todos los mensajes de estado del mismo tipo. También puede aplicar ajustes en modo universal a una regla concreta pasando el ID de la regla correspondiente como cadena en `msg.topic` junto con sus ajustes.
+
+### Consultar propiedades y ajustes
+
+Emite las propiedades actuales de la regla en cuanto se transfiere al nodo un objeto `msg.payload` con el siguiente contenido. Como alternativa, también puede pulsar el botón en la interfaz de Node-RED sin tener que enviar antes ningún mensaje al nodo.
+
+: status (boolean): Devuelve el estado actual de la regla
+
+### Activar / desactivar la regla
+
+La regla puede activarse y desactivarse cuando sea necesario. Si la regla está desactivada, dejará de ejecutarse en el bridge hasta que la vuelva a activar. Para ello, pase un objeto con el siguiente contenido:
+
+: payload (boolean): `true` activa la regla, `false` la desactiva
+
+### Mensajes de estado del nodo
+
+En cuanto cambia el estado (activada / desactivada) de una regla, el nodo devuelve el siguiente mensaje de estado:
+
+#### Objeto de estado en `msg.payload`
+
+: enabled (boolean): Indica si la regla está activada o desactivada
+: triggered (string): Momento de la última ejecución (ISO 8601)
+
+#### Información sobre la regla en `msg.info`
+
+: id (string): El ID único de la regla
+: created (string): Fecha de creación de la regla (ISO 8601)
+: name (string): Nombre de la regla en el bridge
+: timesTriggered (int): Número de veces que se ha ejecutado la regla en el bridge
+: owner (string): ID del propietario de esta regla
+: status (string): Estado de la regla en forma de cadena
+
+#### Condiciones de la regla en `msg.conditions` (array)
+
+: address (string): Ruta a un atributo de un sensor
+: operator (string): Operador
+: value (string): El valor que se debe comprobar
+
+#### Acciones de la regla en `msg.actions` (array)
+
+: address (string): La dirección de destino del recurso
+: method (string): El método de la petición
+: body (object): La acción que se debe ejecutar
+
+#### Cambios de estado en `msg.updated`
+
+Enumera en forma de objeto los parámetros concretos que han cambiado con respecto al último estado de la regla. Si no se ha registrado ningún cambio, este objeto está vacío.
+
+#### Último estado de la regla en `msg.lastState`
+
+Contiene el objeto completo (véanse los valores de salida anteriores) del último estado antes del último cambio registrado de la regla. Si HueMagic aún no ha registrado el último estado, se emite `false`.
+
+#### Último comando en `msg.command` (opcional)
+
+Si el estado del nodo ha cambiado mediante un comando concreto, también se emite el comando completo que se ha ejecutado. De lo contrario, el nodo no emite este objeto.
+
+### Ejemplos de HueMagic
+
+HueMagic pone a su disposición algunas configuraciones de ejemplo para este nodo. Para importar un ejemplo completo en su interfaz de Node-RED, haga clic en el icono de menú de Node-RED, seleccione «Importar» y navegue hasta «Ejemplos» en la barra lateral de la ventana emergente. A continuación, seleccione la carpeta HueMagic y el nodo que desee para importar un flujo de ejemplo.
+
+![examples](hue/assets/huemagic-examples.gif)
+</script>

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

@@ -0,0 +1,30 @@
+{
+	"hue-rules": {
+		"config": {
+			"name": "Nombre",
+			"skipevents-node": "Omitir los mensajes del nodo",
+			"sendinitevents-node": "No suprimir el evento de inicialización",
+			"onlycommands-node": "Informar solo tras un comando",
+			"unknown-error": "Algo ha salido mal. Inténtelo de nuevo.",
+			"bridge": "Bridge",
+			"input-name": "Nombre de la regla",
+			"searching": "Buscando reglas…",
+			"none-found": "¡No se ha encontrado ninguna regla!",
+			"rule": "Regla"
+		},
+		"node": {
+			"init": "inicializando…",
+			"universal": "modo universal",
+			"command": "ejecutando comando…",
+			"statusmsg": "Estado consultado correctamente…",
+			"title": "Hue Regla",
+			"no-rule": "ninguna regla seleccionada",
+			"enabled": "activada",
+			"disabled": "desactivada",
+			"output": "regla (ejecutada)",
+			"input": "activar / desactivar",
+			"error-no-id": "Indique un ID de regla válido.",
+			"error-not-available": "La regla aún no está disponible. Espere hasta que HueMagic haya establecido la conexión con el bridge o compruebe si el ID del recurso indicado en la configuración es válido."
+		}
+	}
+}

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

@@ -0,0 +1,43 @@
+<script type="text/markdown" data-help-name="hue-scene">
+El nodo «Hue Escena» puede reanudar escenas guardadas en el bridge y aplicarlas a determinados grupos.
+
+### Configuración
+
+Seleccione el Hue Bridge preconfigurado y haga clic en el botón de búsqueda para encontrar todas las escenas disponibles. Las escenas se ordenan primero por habitación o zona y después por su nombre, de modo que las escenas de una misma habitación siempre quedan juntas en la lista. Si ya conoce el ID de la escena, también puede introducirlo aquí manualmente. Como alternativa, puede asignar internamente un nombre a la escena o utilizar su nombre predefinido.
+
+### Activar una escena
+
+Puede activar una escena predefinida pasando un objeto con el siguiente contenido:
+
+: payload (boolean): Activa una escena preconfigurada
+: transitionTime (float): Tiempo de transición de la escena en segundos. Si se pasa `0`, la escena se aplica de inmediato. Si pasa `3`, las luces se funden hacia la escena en los siguientes 3 segundos. El bridge acepta hasta 6000 segundos
+: brightness (float): Brillo de toda la escena en porcentaje (`0` – `100`), de modo que puede activar una misma escena más clara o más tenue según la hora del día
+
+> [!NOTE]
+> Ambos ajustes solo están disponibles para escenas normales. Una escena inteligente se rige por los horarios que haya definido para ella en la app de Philips Hue.
+
+### Activar una escena en modo universal
+
+Si utiliza este nodo en el llamado «modo universal» y no ha configurado ninguna escena en el nodo, también puede transferir al nodo la escena que desee como comando. Para ello, pase un objeto `msg.payload` con el siguiente contenido:
+
+: scene (string): ID de la escena que se debe activar en el bridge
+
+### Activar una escena en determinados grupos
+
+Conecte la salida de este nodo a uno o varios grupos para aplicar una escena a grupos concretos. Como alternativa, puede hacerlo de forma «dinámica» pasando al nodo un objeto `msg.payload` con el siguiente contenido:
+
+: group (string | array [string,…]): ID del grupo o un array con los ID de varios grupos para limitar la escena a esos grupos
+
+### Más información sobre el nodo
+
+Este nodo no emite mensajes de estado.
+
+> [!IMPORTANT]
+> Solo puede aplicar escenas a grupos si estos ya están vinculados a la escena correspondiente en el bridge. De lo contrario no se aplicará nada.
+
+### Ejemplos de HueMagic
+
+HueMagic pone a su disposición algunas configuraciones de ejemplo para este nodo. Para importar un ejemplo completo en su interfaz de Node-RED, haga clic en el icono de menú de Node-RED, seleccione «Importar» y navegue hasta «Ejemplos» en la barra lateral de la ventana emergente. A continuación, seleccione la carpeta HueMagic y el nodo que desee para importar un flujo de ejemplo.
+
+![examples](hue/assets/huemagic-examples.gif)
+</script>

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

@@ -0,0 +1,32 @@
+{
+	"hue-scene": {
+		"config": {
+			"name": "Nombre",
+			"input-name": "Nombre de la escena",
+			"skipevents-node": "Omitir los mensajes del nodo",
+			"sendinitevents-node": "No suprimir el evento de inicialización",
+			"searching": "Buscando escenas…",
+			"none-found": "¡No se ha encontrado ninguna escena!",
+			"unknown-error": "Algo ha salido mal. Inténtelo de nuevo.",
+			"scene": "Escena",
+			"group": "Grupo",
+			"group-none-found": "¡No se ha encontrado ningún grupo!",
+			"group-searching": "Buscando grupos…",
+			"groups-all": "Todos los grupos / luces",
+			"bridge": "Bridge"
+		},
+		"node": {
+			"title": "Hue Escena",
+			"not-configured": "sin configurar",
+			"recalled": "escena activada",
+			"recalled-on-group": "escena activada en el grupo",
+			"no-id": "Sin ID de escena.",
+			"input": "activar escena",
+			"output": "grupo(s) de destino",
+			"command": "ejecutando comando…",
+			"statusmsg": "Activando la escena…",
+			"error-not-available": "La escena aún no está disponible. Espere hasta que HueMagic haya establecido la conexión con el bridge o compruebe si el ID del recurso indicado en la configuración es válido.",
+			"error-invalid-brightness": "Ajuste de brillo no válido. Solo se permite de 0 a 100 por ciento."
+		}
+	}
+}

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

@@ -0,0 +1,80 @@
+<script type="text/markdown" data-help-name="hue-speaker">
+El nodo «Hue Altavoz» puede reproducir los sonidos de un timbre Hue Secure y utilizarlo como sirena interior.
+
+### Configuración
+
+Seleccione el Hue Bridge preconfigurado y haga clic en el botón de búsqueda para encontrar todos los altavoces disponibles. Si ya conoce el ID del altavoz, también puede introducirlo aquí manualmente. Puede asignar internamente un nombre nuevo al altavoz o utilizar el nombre predefinido. De forma opcional, puede desactivar todos los mensajes de estado automáticos de este nodo mediante el ajuste «Omitir los mensajes del nodo». El nodo dejará entonces de emitir actualizaciones del dispositivo. También puede elegir que el mensaje de inicialización del nodo no se suprima al iniciar Node-RED. Si activa este ajuste, recibirá un mensaje de estado del altavoz seleccionado después de cada despliegue. Si prefiere que el nodo permanezca en silencio hasta que usted le envíe algo, active «Informar solo tras un comando». En ese caso ignorará los cambios realizados desde la app o desde un interruptor y solo responderá a sus propios comandos.
+
+Si no selecciona ningún altavoz y utiliza así la configuración del nodo, el nodo funciona en el llamado «modo universal». En este modo, el nodo recibe y emite todos los mensajes de estado del mismo tipo. También puede aplicar ajustes en modo universal a un altavoz concreto pasando el ID del altavoz correspondiente como cadena en `msg.topic` junto con sus ajustes.
+
+### Consultar el estado
+
+Emite el estado actual del altavoz en cuanto se transfiere al nodo un objeto `msg.payload` con el siguiente contenido. Como alternativa, también puede pulsar el botón en la interfaz de Node-RED sin tener que enviar antes ningún mensaje al nodo.
+
+: status (boolean): Devuelve el estado actual del altavoz
+
+### Reproducir un sonido
+
+Un altavoz conoce tres canales independientes. `chime` es el sonido del timbre, `alarm` es la sirena y `alert` es una notificación breve. Los sonidos que conoce realmente un dispositivo se enumeran en `msg.info.sounds`. Transfiera los siguientes parámetros en un objeto `msg.payload`:
+
+: chime (string | object | boolean): Nombre del sonido del timbre; `false` lo detiene de nuevo
+: alarm (string | object | boolean): Nombre del sonido de la sirena; `false` lo detiene de nuevo
+: alert (string | object | boolean): Nombre del sonido de notificación; `false` lo detiene de nuevo
+: mute (boolean): `true` silencia el altavoz, `false` vuelve a activar el sonido
+
+En lugar de un simple nombre de sonido, también puede pasar un objeto para controlar el volumen y la duración:
+
+: sound (string): Nombre del sonido, p. ej. `ding_dong_classic` o `siren`
+: volume (int): Volumen en porcentaje (0-100)
+: duration (float): Tiempo de reproducción en segundos
+
+### Mensajes de estado del nodo
+
+En cuanto el altavoz empieza o deja de reproducir, el nodo devuelve el siguiente mensaje de estado.
+
+> [!NOTE]
+> El bridge informa del último sonido reproducido y no lo restablece hasta bastante después de finalizar la reproducción, por lo que estos valores van algo por detrás del audio.
+
+#### Objeto de estado en `msg.payload`
+
+: reachable (boolean | string): `true` si el altavoz está conectado al bridge, `unknown` si el estado de la conexión difiere
+: connectionStatus (string): El estado actual de la conexión con el bridge en forma de cadena. Puede contener `connected`, `disconnected`, `connectivity_issue` o `unidirectional_incoming` como valor
+: playing (boolean): `true` mientras el altavoz reproduce cualquier sonido
+: chime (string | boolean): Nombre del sonido de timbre que se está reproduciendo o `false`
+: alarm (string | boolean): Nombre del sonido de sirena que se está reproduciendo o `false`
+: alert (string | boolean): Nombre del sonido de notificación que se está reproduciendo o `false`
+: muted (boolean): Indica si el altavoz está silenciado
+: updated (string): Momento de la última actualización del recurso por parte de HueMagic (ISO 8601)
+
+#### Información sobre el altavoz en `msg.info`
+
+: id (string): Indica el nuevo ID del altavoz
+: idV1 (string | boolean): Indica el ID antiguo del altavoz
+: uniqueId (string): El ID único del altavoz
+: deviceId (string): El ID único del dispositivo
+: name (string): El nombre asignado actualmente al altavoz
+: type (string): El tipo de dispositivo (siempre `speaker`)
+: softwareVersion (string): El firmware actual del altavoz
+: battery (float | boolean): El nivel de batería actual del altavoz, `false` si no hay batería
+: batteryState (string | boolean): El estado actual del nivel de batería. Puede contener `normal`, `low` o `critical` como valor, o `false` si no hay batería
+: sounds (object): Contiene los sonidos que conoce este dispositivo en `chime`, `alarm` y `alert`
+: model (object): Contiene la información de modelo del altavoz en `id`, `manufacturer`, `name`, `type` y `certified`
+
+#### Cambios de estado en `msg.updated`
+
+Enumera en forma de objeto los parámetros concretos que han cambiado con respecto al último estado del altavoz. Si no se ha registrado ningún cambio, este objeto está vacío.
+
+#### Último estado del altavoz en `msg.lastState`
+
+Contiene el objeto de estado completo (véanse los valores de salida anteriores) del último estado antes del último cambio registrado. Si HueMagic aún no ha registrado el último estado, se emite `false`.
+
+#### Último comando en `msg.command` (opcional)
+
+Si el estado del nodo ha cambiado mediante un comando concreto, también se emite el comando completo que se ha ejecutado. De lo contrario, el nodo no emite este objeto.
+
+### Ejemplos de HueMagic
+
+HueMagic pone a su disposición algunas configuraciones de ejemplo para este nodo. Para importar un ejemplo completo en su interfaz de Node-RED, haga clic en el icono de menú de Node-RED, seleccione «Importar» y navegue hasta «Ejemplos» en la barra lateral de la ventana emergente. A continuación, seleccione la carpeta HueMagic y el nodo que desee para importar un flujo de ejemplo.
+
+![examples](hue/assets/huemagic-examples.gif)
+</script>