node-red-contrib-huemagic 4.2.2 → 5.0.1

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

@@ -0,0 +1,97 @@
+<script type="text/markdown" data-help-name="hue-light">
+O nó «Hue Luz» pode controlar as luzes ligadas ao bridge e receber as respetivas mensagens de estado.
+
+### Configuração
+
+Selecione o Hue Bridge pré-configurado e clique no botão de pesquisa para encontrar todas as luzes disponíveis. Se já souber o ID de uma luz, também o pode introduzir aqui manualmente. Pode atribuir internamente um novo nome à luz ou manter o nome predefinido. Opcionalmente, pode desativar todas as mensagens de estado automáticas deste nó através da definição «Ignorar as mensagens do nó». O nó deixará de emitir atualizações do dispositivo. Em alternativa, pode escolher que a mensagem de inicialização do nó não seja suprimida no arranque do Node-RED. Se ativar esta definição, receberá uma mensagem de estado da luz selecionada após cada implementação. Se preferir que o nó permaneça em silêncio até lhe enviar algo, ative «Comunicar apenas após um comando». Nesse caso, ignora as alterações feitas na aplicação ou num interruptor e responde apenas aos seus próprios comandos.
+
+Se ativar a definição «Ativar a denominação das cores», o nó tentará descrever a cor de luz definida em cada mensagem de estado. Receberá então na saída um parâmetro adicional com a descrição em inglês da cor atual.
+
+Se não selecionar nenhuma luz e utilizar assim a configuração do nó, o nó funciona no chamado «modo universal». Neste modo, o nó recebe e emite todas as mensagens de estado do mesmo tipo. Também pode aplicar definições no modo universal a uma luz específica, transmitindo o respetivo ID como cadeia de carateres em `msg.topic` juntamente com as suas definições.
+
+### Consultar o estado
+
+Emite o estado atual da luz assim que for transmitido ao nó um objeto `msg.payload` com o seguinte conteúdo. Em alternativa, também pode premir o botão na interface do Node-RED sem ter de enviar previamente uma mensagem ao nó.
+
+: status (boolean): Devolve o estado atual da luz
+
+### Ligar / desligar a luz (modo simples)
+
+Para ligar ou desligar rapidamente uma luz no modo simples, transmita ao nó um objeto com o seguinte conteúdo:
+
+: payload (boolean): `true` liga a luz, `false` desliga-a
+
+### Comandos de luz (avançado)
+
+Para além de simplesmente ligar e desligar, existem muitas outras opções para controlar a luz. Todos os nós do HueMagic podem ser controlados com comandos aditivos. Isto significa que pode transmitir primeiro uma definição e depois outra num comando posterior sem descartar a definição anterior. Transmita os seguintes parâmetros num objeto `msg.payload` para efetuar definições mais amplas na luz:
+
+: on (boolean): `true` liga a luz, `false` desliga-a
+: toggle (boolean | any): Alterna entre ligar e desligar, consoante o estado anterior da luz
+: brightness (int | string): Valor percentual do brilho da luz (0-100) ou uma cadeia de carateres com o valor `auto` para definir automaticamente o brilho com base na hora atual
+: brightnessLevel (int): Valor numérico do brilho da luz (0-254)
+: incrementBrightness (int | boolean): Indica em quantos pontos percentuais a luz deve ficar mais clara, ou `true` para a aumentar em passos de 10 %
+: decrementBrightness (int | boolean): Indica em quantos pontos percentuais a luz deve ficar mais escura, ou `true` para a diminuir em passos de 10 %
+: color (string): `random` para definir uma cor aleatória ou um nome de cor em inglês (p. ex. `red`)
+: hex (string): Valor de cor em hexadecimal sob a forma de cadeia de carateres
+: rgb (array [0,0,0]): Valor de cor em formato RGB sob a forma de matriz
+: xyColor (object {x [float], y [float]}): Valor de cor no formato de cor XY sob a forma de objeto
+: gradient (object {hex […]}): Um objeto com um objeto de cor suportado (p. ex. `hex`, `rgb`, …) e várias cores para aplicar um gradiente às luzes compatíveis
+: mixColor (object): Uma cor a misturar com a cor de luz atual. Aceita objetos `color`, `hex`, `rgb` ou `xyColor` e, opcionalmente, `amount` (int) para indicar a proporção de mistura em percentagem
+: image (string): Caminho de uma imagem (local ou na web) para definir a cor atual da luz como a cor média da imagem
+: saturation (int): Percentagem da saturação da cor atual (beta)
+: colorTemp (int | string): Valor entre 153 e 500 para definir a temperatura de cor da luz, ou os valores `cold`, `normal`, `warm`, `hot` e `auto`, sendo que `auto` define a temperatura de cor com base na hora atual
+: incrementColorTemp (int | boolean): Valor que indica quanto a temperatura de cor deve ficar mais quente, ou `true` para a tornar mais quente em passos de 50
+: decrementColorTemp (int | boolean): Valor que indica quanto a temperatura de cor deve ficar mais fria, ou `true` para a tornar mais fria em passos de 50
+: transitionTime (float): Tempo de transição da definição atual em segundos. Se for indicado `0`, a luz muda de imediato para a definição pretendida. Se for indicado `3`, a luz muda para a definição pretendida com uma ligeira transição nos 3 segundos seguintes
+: colorloop (float): Reproduz uma animação «colorloop» durante os segundos indicados e volta depois ao estado original da luz
+: alert (float): Reproduz uma animação «alert» durante os segundos indicados e volta depois ao estado original da luz
+
+### Mensagens de estado do nó
+
+Assim que é detetada uma alteração nas definições da luz (quer através do Node-RED, quer externamente), o nó devolve a seguinte mensagem de estado:
+
+#### Objeto de estado em `msg.payload`
+
+: on (boolean): Estado da luz, em que `true` significa acesa e `false` apagada
+: brightness (int | boolean): Brilho atual em percentagem ou `false` se a luz não suportar definição de brilho
+: brightnessLevel (int | boolean): Brilho atual de 0 a 254 ou `false` se a luz não suportar definição de brilho
+: reachable (boolean | string): `true` se a luz estiver ligada ao bridge, `unknown` se o estado da ligação divergir
+: connectionStatus (string): O estado atual da ligação com o bridge sob a forma de uma cadeia de carateres. Pode conter `connected`, `disconnected`, `connectivity_issue` ou `unidirectional_incoming` como valor
+: rgb (array [int, int, int] | optional): Cor de luz atual sob a forma de valor RGB, se a luz conseguir apresentar cores
+: hex (string | optional): Cor de luz atual sob a forma de valor hexadecimal, se a luz conseguir apresentar cores
+: xyColor (object {x [float], y [float]} | optional): Cor de luz atual sob a forma de valor XY, se a luz conseguir apresentar cores
+: color (string | optional): Nome atual da cor em inglês, se a luz conseguir apresentar cores e a definição correspondente do nó estiver ativada
+: gradient (object | optional): Definição de gradiente atual com todas as unidades de cor disponíveis sob a forma de matriz, se a luz suportar gradientes, em que `colors` devolve as cores, `numColors` o número de cores definidas no gradiente e `totalColors` o número máximo de cores que o recurso consegue suportar no gradiente
+: colorTemp (int | boolean | optional): Temperatura de cor atual da luz, se a luz conseguir apresentar temperaturas de cor e tiver sido definida uma
+: colorTempName (string | optional): Temperatura de cor atual da luz sob a forma de cadeia descritiva com os valores `cold`, `normal`, `warm` ou `hot`, se a luz conseguir apresentar temperaturas de cor e tiver sido definida uma. Caso contrário, é emitido `unknown`
+: updated (string): Momento da última atualização do recurso pelo HueMagic (ISO 8601)
+
+#### Informações sobre a luz em `msg.info`
+
+: id (string): Indica o novo ID da luz
+: idV1 (string | boolean): Indica o ID antigo da luz
+: uniqueId (string): O ID único da luz
+: deviceId (string): O ID único do dispositivo
+: name (string): O nome atualmente atribuído à luz
+: type (string): O tipo da luz (sempre `light`)
+: softwareVersion (string): O firmware atual da luz
+: model (object): Contém as informações de modelo da luz em `id`, `manufacturer`, `name`, `type`, `certified`, `friendsOfHue`, `colorGamut` e `colorGamutType`
+
+#### Alterações de estado em `msg.updated`
+
+Enumera sob a forma de um objeto os parâmetros que foram alterados em relação ao último estado da luz. Se não tiverem sido registadas alterações, este objeto está vazio.
+
+#### Último estado da luz em `msg.lastState`
+
+Contém o objeto de estado completo (ver os valores de saída acima) do último estado antes da última alteração. Se o HueMagic ainda não tiver registado o último estado, é emitido `false`.
+
+#### Último comando em `msg.command` (opcional)
+
+Se o estado do nó tiver sido alterado através de um determinado comando, é também emitido o comando completo que foi executado. Caso contrário, o nó não emite este objeto.
+
+### Exemplos do HueMagic
+
+O HueMagic disponibiliza algumas configurações de exemplo para este nó. Para importar um exemplo completo na sua interface Node-RED, clique no ícone de menu do Node-RED, selecione «Importar» e navegue até «Exemplos» na barra lateral da janela. Em seguida, selecione a pasta HueMagic e o nó pretendido para importar um fluxo de exemplo.
+
+![examples](hue/assets/huemagic-examples.gif)
+</script>

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

@@ -0,0 +1,44 @@
+{
+	"hue-light": {
+		"config": {
+			"name": "Nome",
+			"skipevents-node": "Ignorar as mensagens do nó",
+			"sendinitevents-node": "Não suprimir o evento de inicialização",
+			"onlycommands-node": "Comunicar apenas após um comando",
+			"unknown-error": "Algo correu mal. Tente novamente.",
+			"bridge": "Bridge",
+			"universalevents": "Eventos universais",
+			"universalevents-node": "Recebe todas as mensagens de outros nós do mesmo tipo (apenas no modo universal)",
+			"colornamer": "Colornamer",
+			"colornamer-info": "Ativar a denominação das cores",
+			"input-name": "Nome da luz",
+			"searching": "A procurar luzes…",
+			"none-found": "Nenhuma luz encontrada!",
+			"light": "Luz"
+		},
+		"node": {
+			"not-configured": "não configurado",
+			"init": "a inicializar…",
+			"not-reachable": "inacessível",
+			"universal": "modo universal",
+			"command": "a executar comando…",
+			"statusmsg": "Estado consultado com sucesso…",
+			"title": "Hue Luz",
+			"turned-on": "acesa",
+			"turned-on-percent": "acesa (__percent__ %)",
+			"turned-off": "apagada",
+			"error-no-id": "Nenhum ID de luz definido. Consulte a documentação.",
+			"error-input": "erro de entrada",
+			"error-invalid-temp": "Temperatura de cor inválida. Apenas são permitidos valores de 153 a 500.",
+			"input": "ligar / desligar",
+			"output": "estado",
+			"error-not-available": "A luz ainda não está disponível. Aguarde até que o HueMagic tenha estabelecido a ligação com o bridge ou verifique se o ID do recurso indicado na configuração é válido.",
+			"error-invalid-brightness": "Definição de brilho inválida. Apenas são permitidos valores de 0 a 100 por cento.",
+			"error-invalid-brightness-level": "Definição de brilho inválida. Apenas são permitidos valores de 0 a 254.",
+			"error-invalid-sat": "Definição de saturação inválida. Apenas são permitidos valores de 0 a 100.",
+			"error-no-colorloop": "O efeito colorloop não está disponível para esta luz.",
+			"error-invalid-effect": "Efeito inválido. Esta luz suporta: __effects__",
+			"error-invalid-powerup": "Definição de arranque inválida. As predefinições permitidas são: __presets__"
+		}
+	}
+}

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

@@ -0,0 +1,68 @@
+<script type="text/markdown" data-help-name="hue-magic">
+O nó «Hue Magic» pode aplicar animações complexas e personalizadas a luzes e grupos.
+
+### Configuração
+
+Comece por dar um nome ao nó para poder identificar claramente a sua animação na interface do Node-RED. Depois pode escolher entre as opções «Repetição» e «Restaurar». Selecione a opção de repetição se quiser que a sua animação seja executada indefinidamente numa luz ou grupo até a parar manualmente. Se quiser restaurar o estado anterior do recurso de destino (luz / grupo) após o fim da animação, assinale a opção «Restaurar». Caso contrário, o último fotograma da animação permanece no respetivo recurso.
+
+Mais abaixo pode escolher entre as animações já preparadas do HueMagic. Clique na animação pretendida para a definir.
+
+### Iniciar / parar a animação
+
+Para reproduzir ou parar uma animação, transmita ao nó um objeto com o seguinte conteúdo:
+
+: payload (boolean): `true` inicia a animação, `false` para-a
+
+### Animações personalizadas
+
+Se transmitir a sua própria animação ao nó, a animação predefinida selecionada (se existir) é temporariamente substituída pela sua. As animações próprias do HueMagic são uma sequência de comandos agrupados numa matriz. Cada elemento da matriz constitui um passo, sendo que um passo também pode ser composto por vários fotogramas (efeitos de transição).
+
+Crie um `array` com os vários passos da animação sob a forma de objeto e transmita-o ao nó HueMagic em `msg.payload.steps`.
+
+: delay (int): Número de milissegundos a aguardar até este passo ser executado
+: animation (object): O objeto contém a ação ou ações a executar neste passo. Parâmetros idênticos aos dos nós «Hue Luz» e «Hue Grupo»
+
+### Exemplo de uma animação personalizada
+
+Este exemplo mostra o aspeto que uma animação simples pode ter. No primeiro passo aguarda-se o atraso de 500 milissegundos. Em seguida, a cor da luz muda lentamente para vermelho ao longo de um segundo. Assim que a luz fica completamente vermelha, é executado o segundo passo, que tem igualmente um atraso de 500 milissegundos. Por fim, a cor muda para azul.
+
+Se tiver definido a animação em repetição, este processo repete-se indefinidamente até parar a animação manualmente ou voltar a implementar o nó.
+
+Transmita o objeto seguinte em `msg.payload` para reproduzir a animação de exemplo.
+
+    {
+        "animate": true,
+        "steps": [
+            {
+                "delay": 500,
+                "animation": {
+                    "hex": "#FF0000",
+                    "transitionTime": 1
+                }
+            },
+            {
+                "delay": 500,
+                "animation": {
+                    "hex": "#0000FF",
+                    "transitionTime": 1
+                }
+            }
+        ]
+    }
+
+### Comandos especiais
+
+Por vezes faz sentido reproduzir uma animação de forma desordenada, p. ex. para imitar o fogo de maneira mais realista. Para reproduzir os vários passos aleatoriamente, pode transmitir o seguinte comando em `msg.payload.specials`:
+
+: randomOrder (boolean | any): `true` ativa a reprodução aleatória dos vários passos da animação
+
+### Dicas e indicações
+
+Este nó não emite mensagens de estado. Ligue a saída do nó a um grupo em vez de a luzes individuais se quiser animar várias luzes ao mesmo tempo com a mesma animação. As pré-visualizações das animações já preparadas são simulações e podem diferir ligeiramente (tempos, cores) da animação real num recurso.
+
+### Exemplos do HueMagic
+
+O HueMagic disponibiliza algumas configurações de exemplo para este nó. Para importar um exemplo completo na sua interface Node-RED, clique no ícone de menu do Node-RED, selecione «Importar» e navegue até «Exemplos» na barra lateral da janela. Em seguida, selecione a pasta HueMagic e o nó pretendido para importar um fluxo de exemplo.
+
+![examples](hue/assets/huemagic-examples.gif)
+</script>

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

@@ -0,0 +1,26 @@
+{
+	"hue-magic": {
+		"config": {
+			"name": "Nome",
+			"input-name": "Nome da animação",
+			"loop": "Repetição",
+			"loop-endless": "Repetir indefinidamente",
+			"restore": "Restaurar",
+			"restore-state": "Restaurar o estado anterior após parar",
+			"animation": "Animação",
+			"unknown-error": "Algo correu mal. Tente novamente.",
+			"seconds": "s",
+			"minutes": "min"
+		},
+		"node": {
+			"title": "Hue Magic",
+			"no-animation": "nenhuma animação indicada",
+			"animating": "a animar…",
+			"stopped": "parada",
+			"input": "iniciar / parar a animação",
+			"output": "luz ou grupo",
+			"command": "a executar comando…",
+			"playmsg": "Animação iniciada…"
+		}
+	}
+}

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

@@ -0,0 +1,64 @@
+<script type="text/markdown" data-help-name="hue-motion">
+O nó «Hue Movimento» pode registar e comunicar os movimentos detetados por um sensor adequado ligado ao bridge.
+
+### Configuração
+
+Selecione o Hue Bridge pré-configurado e clique no botão de pesquisa para encontrar todos os sensores disponíveis. Se já souber o ID do sensor, também o pode introduzir aqui manualmente. Pode atribuir internamente um novo nome ao sensor ou manter o nome predefinido. Opcionalmente, pode desativar todas as mensagens de estado automáticas deste nó através da definição «Ignorar as mensagens do nó». O nó deixará de emitir atualizações do dispositivo. Em alternativa, pode escolher que a mensagem de inicialização do nó não seja suprimida no arranque do Node-RED. Se ativar esta definição, receberá uma mensagem de estado do sensor selecionado após cada implementação. Se preferir que o nó permaneça em silêncio até lhe enviar algo, ative «Comunicar apenas após um comando». Nesse caso, ignora as alterações feitas na aplicação ou num interruptor e responde apenas aos seus próprios comandos.
+
+Se não selecionar nenhum sensor e utilizar assim a configuração do nó, o nó funciona no chamado «modo universal». Neste modo, o nó recebe e emite todas as mensagens de estado do mesmo tipo. Também pode aplicar definições no modo universal a um sensor específico, transmitindo o respetivo ID do sensor como cadeia de carateres em `msg.topic` juntamente com as suas definições.
+
+### Consultar o estado
+
+Emite o estado atual do sensor assim que for transmitido ao nó um objeto `msg.payload` com o seguinte conteúdo. Em alternativa, também pode premir o botão na interface do Node-RED sem ter de enviar previamente uma mensagem ao nó.
+
+: status (boolean): Devolve o estado atual do sensor
+
+### Ligar / desligar o sensor
+
+Se necessário, o sensor pode ser ligado e desligado remotamente. Se o sensor estiver desligado, deixa de registar movimentos e, por conseguinte, deixa de os emitir. Para tal, transmita um objeto com o seguinte conteúdo:
+
+: payload (boolean): `true` liga o sensor, `false` desliga-o
+
+### Mensagens de estado do nó
+
+Assim que o sensor regista um movimento, o nó devolve a seguinte mensagem de estado:
+
+#### Objeto de estado em `msg.payload`
+
+: active (boolean): Indica se o sensor está ligado ou desligado
+: reachable (boolean | string): `true` se o sensor estiver ligado ao bridge, `unknown` se o estado da ligação divergir
+: connectionStatus (string): O estado atual da ligação com o bridge sob a forma de uma cadeia de carateres. Pode conter `connected`, `disconnected`, `connectivity_issue` ou `unidirectional_incoming` como valor
+: motion (boolean): Indica se foi registado movimento
+: updated (string): Momento da última atualização do recurso pelo HueMagic (ISO 8601)
+
+#### Informações sobre o sensor em `msg.info`
+
+: id (string): Indica o novo ID do sensor
+: idV1 (string | boolean): Indica o ID antigo do sensor
+: uniqueId (string): O ID único do sensor
+: deviceId (string): O ID único do dispositivo
+: name (string): O nome atualmente atribuído ao sensor
+: type (string): O tipo do sensor (sempre `motion`)
+: softwareVersion (string): O firmware atual do sensor
+: battery (float): O nível atual da bateria do sensor
+: batteryState (string): O estado atual do nível da bateria. Pode conter `normal`, `low` ou `critical` como valor
+: model (object): Contém as informações de modelo do sensor em `id`, `manufacturer`, `name`, `type` e `certified`
+
+#### Alterações de estado em `msg.updated`
+
+Enumera sob a forma de um objeto os parâmetros que foram alterados em relação ao último estado do sensor. Se não tiverem sido registadas alterações, este objeto está vazio.
+
+#### Último estado do sensor em `msg.lastState`
+
+Contém o objeto de estado completo (ver os valores de saída acima) do último estado antes da última alteração registada. Se o HueMagic ainda não tiver registado o último estado, é emitido `false`.
+
+#### Último comando em `msg.command` (opcional)
+
+Se o estado do nó tiver sido alterado através de um determinado comando, é também emitido o comando completo que foi executado. Caso contrário, o nó não emite este objeto.
+
+### Exemplos do HueMagic
+
+O HueMagic disponibiliza algumas configurações de exemplo para este nó. Para importar um exemplo completo na sua interface Node-RED, clique no ícone de menu do Node-RED, selecione «Importar» e navegue até «Exemplos» na barra lateral da janela. Em seguida, selecione a pasta HueMagic e o nó pretendido para importar um fluxo de exemplo.
+
+![examples](hue/assets/huemagic-examples.gif)
+</script>

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

@@ -0,0 +1,36 @@
+{
+	"hue-motion": {
+		"config": {
+			"name": "Nome",
+			"skipevents-node": "Ignorar as mensagens do nó",
+			"sendinitevents-node": "Não suprimir o evento de inicialização",
+			"onlycommands-node": "Comunicar apenas após um comando",
+			"unknown-error": "Algo correu mal. Tente novamente.",
+			"bridge": "Bridge",
+			"universalevents": "Eventos universais",
+			"universalevents-node": "Recebe todas as mensagens de outros nós do mesmo tipo (apenas no modo universal)",
+			"input-name": "Nome do sensor",
+			"searching": "A procurar sensores de movimento…",
+			"none-found": "Nenhum sensor de movimento encontrado!",
+			"sensor": "Sensor"
+		},
+		"node": {
+			"not-configured": "não configurado",
+			"not-reachable": "inacessível",
+			"activated": "ativado",
+			"deactivated": "desativado",
+			"universal": "modo universal",
+			"command": "a executar comando…",
+			"statusmsg": "Estado consultado com sucesso…",
+			"title": "Hue Movimento",
+			"motion": "movimento detetado",
+			"no-motion": "sem movimento",
+			"input": "ativar / desativar / estado",
+			"output": "movimento detetado",
+			"error-no-id": "Indique um ID de sensor válido.",
+			"error-not-available": "O sensor ainda não está disponível. Aguarde até que o HueMagic tenha estabelecido a ligação com o bridge ou verifique se o ID do recurso indicado na configuração é válido.",
+			"error-no-sensitivity": "Esta fonte de movimento não tem sensibilidade ajustável.",
+			"error-invalid-sensitivity": "Sensibilidade inválida. Apenas são permitidos valores de 0 a __max__."
+		}
+	}
+}

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

@@ -0,0 +1,69 @@
+<script type="text/markdown" data-help-name="hue-rules">
+O nó «Hue Regra» pode ativar ou desativar as regras guardadas no bridge e consultar as respetivas definições.
+
+### Configuração
+
+Selecione o Hue Bridge pré-configurado e clique no botão de pesquisa para encontrar todas as regras disponíveis. Se já souber o ID da regra, também o pode introduzir aqui manualmente. Em alternativa, pode atribuir um novo nome ou manter o nome predefinido da regra. Opcionalmente, pode desativar todas as mensagens de estado automáticas deste nó através da definição «Ignorar as mensagens do nó». O nó deixará de emitir atualizações. Em alternativa, pode escolher que a mensagem de inicialização do nó não seja suprimida no arranque do Node-RED. Se preferir que o nó permaneça em silêncio até lhe enviar algo, ative «Comunicar apenas após um comando». Nesse caso, ignora as alterações feitas na aplicação ou num interruptor e responde apenas aos seus próprios comandos.
+
+Se não selecionar nenhuma regra e utilizar assim a configuração do nó, o nó funciona no chamado «modo universal». Neste modo, o nó recebe e emite todas as mensagens de estado do mesmo tipo. Também pode aplicar definições no modo universal a uma regra específica, transmitindo o respetivo ID como cadeia de carateres em `msg.topic` juntamente com as suas definições.
+
+### Consultar propriedades e definições
+
+Emite as propriedades atuais da regra assim que for transmitido ao nó um objeto `msg.payload` com o seguinte conteúdo. Em alternativa, também pode premir o botão na interface do Node-RED sem ter de enviar previamente uma mensagem ao nó.
+
+: status (boolean): Devolve o estado atual da regra
+
+### Ativar / desativar a regra
+
+A regra pode ser ativada e desativada sempre que necessário. Se a regra estiver desativada, deixa de ser executada no bridge até a reativar. Para tal, transmita um objeto com o seguinte conteúdo:
+
+: payload (boolean): `true` ativa a regra, `false` desativa-a
+
+### Mensagens de estado do nó
+
+Assim que o estado (ativada / desativada) de uma regra muda, o nó devolve a seguinte mensagem de estado:
+
+#### Objeto de estado em `msg.payload`
+
+: enabled (boolean): Indica se a regra está ativada ou desativada
+: triggered (string): Momento da última execução (ISO 8601)
+
+#### Informações sobre a regra em `msg.info`
+
+: id (string): O ID único da regra
+: created (string): Data de criação da regra (ISO 8601)
+: name (string): Nome da regra no bridge
+: timesTriggered (int): Número de vezes que a regra foi executada no bridge
+: owner (string): ID do proprietário desta regra
+: status (string): Estado da regra sob a forma de cadeia de carateres
+
+#### Condições da regra em `msg.conditions` (matriz)
+
+: address (string): Caminho para um atributo de um sensor
+: operator (string): Operador
+: value (string): O valor a verificar
+
+#### Ações da regra em `msg.actions` (matriz)
+
+: address (string): O endereço de destino do recurso
+: method (string): O método do pedido
+: body (object): A ação a executar
+
+#### Alterações de estado em `msg.updated`
+
+Enumera sob a forma de um objeto os parâmetros que foram alterados em relação ao último estado da regra. Se não tiverem sido registadas alterações, este objeto está vazio.
+
+#### Último estado da regra em `msg.lastState`
+
+Contém o objeto completo (ver os valores de saída acima) do último estado antes da última alteração registada da regra. Se o HueMagic ainda não tiver registado o último estado, é emitido `false`.
+
+#### Último comando em `msg.command` (opcional)
+
+Se o estado do nó tiver sido alterado através de um determinado comando, é também emitido o comando completo que foi executado. Caso contrário, o nó não emite este objeto.
+
+### Exemplos do HueMagic
+
+O HueMagic disponibiliza algumas configurações de exemplo para este nó. Para importar um exemplo completo na sua interface Node-RED, clique no ícone de menu do Node-RED, selecione «Importar» e navegue até «Exemplos» na barra lateral da janela. Em seguida, selecione a pasta HueMagic e o nó pretendido para importar um fluxo de exemplo.
+
+![examples](hue/assets/huemagic-examples.gif)
+</script>

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

@@ -0,0 +1,30 @@
+{
+	"hue-rules": {
+		"config": {
+			"name": "Nome",
+			"skipevents-node": "Ignorar as mensagens do nó",
+			"sendinitevents-node": "Não suprimir o evento de inicialização",
+			"onlycommands-node": "Comunicar apenas após um comando",
+			"unknown-error": "Algo correu mal. Tente novamente.",
+			"bridge": "Bridge",
+			"input-name": "Nome da regra",
+			"searching": "A procurar regras…",
+			"none-found": "Nenhuma regra encontrada!",
+			"rule": "Regra"
+		},
+		"node": {
+			"init": "a inicializar…",
+			"universal": "modo universal",
+			"command": "a executar comando…",
+			"statusmsg": "Estado consultado com sucesso…",
+			"title": "Hue Regra",
+			"no-rule": "nenhuma regra selecionada",
+			"enabled": "ativada",
+			"disabled": "desativada",
+			"output": "regra (executada)",
+			"input": "ativar / desativar",
+			"error-no-id": "Indique um ID de regra válido.",
+			"error-not-available": "A regra ainda não está disponível. Aguarde até que o HueMagic tenha estabelecido a ligação com o bridge ou verifique se o ID do recurso indicado na configuração é válido."
+		}
+	}
+}

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

@@ -0,0 +1,43 @@
+<script type="text/markdown" data-help-name="hue-scene">
+O nó «Hue Cena» pode retomar cenas guardadas no bridge e aplicá-las a determinados grupos.
+
+### Configuração
+
+Selecione o Hue Bridge pré-configurado e clique no botão de pesquisa para encontrar todas as cenas disponíveis. As cenas são ordenadas primeiro por divisão ou zona e depois pelo nome, para que as cenas da mesma divisão fiquem sempre juntas na lista. Se já souber o ID da cena, também o pode introduzir aqui manualmente. Em alternativa, pode atribuir internamente um nome à cena ou manter o nome predefinido.
+
+### Ativar uma cena
+
+Pode ativar uma cena predefinida transmitindo um objeto com o seguinte conteúdo:
+
+: payload (boolean): Ativa uma cena pré-configurada
+: transitionTime (float): Tempo de transição da cena em segundos. Se for transmitido `0`, a cena é aplicada de imediato. Se transmitir `3`, as luzes fazem a transição para a cena nos 3 segundos seguintes. O bridge aceita até 6000 segundos
+: brightness (float): Brilho de toda a cena em percentagem (`0` – `100`), para poder ativar a mesma cena mais clara ou mais suave consoante a hora do dia
+
+> [!NOTE]
+> Ambas as definições só estão disponíveis para cenas normais. Uma cena inteligente segue os horários que definiu para ela na aplicação Philips Hue.
+
+### Ativar uma cena no modo universal
+
+Se utilizar este nó no chamado «modo universal» e não tiver definido nenhuma cena na configuração do nó, também pode transmitir ao nó a cena pretendida como comando. Para tal, transmita um objeto `msg.payload` com o seguinte conteúdo:
+
+: scene (string): ID da cena a ativar no bridge
+
+### Ativar uma cena em determinados grupos
+
+Ligue a saída deste nó a um ou mais grupos para aplicar uma cena a grupos específicos. Em alternativa, pode fazê-lo «dinamicamente», transmitindo ao nó um objeto `msg.payload` com o seguinte conteúdo:
+
+: group (string | array [string,…]): ID do grupo ou uma matriz com os ID de vários grupos para limitar a cena a esses grupos
+
+### Mais informações sobre o nó
+
+Este nó não emite mensagens de estado.
+
+> [!IMPORTANT]
+> Só pode aplicar cenas a grupos se estes já estiverem associados à respetiva cena no bridge. Caso contrário, não será aplicado nada.
+
+### Exemplos do HueMagic
+
+O HueMagic disponibiliza algumas configurações de exemplo para este nó. Para importar um exemplo completo na sua interface Node-RED, clique no ícone de menu do Node-RED, selecione «Importar» e navegue até «Exemplos» na barra lateral da janela. Em seguida, selecione a pasta HueMagic e o nó pretendido para importar um fluxo de exemplo.
+
+![examples](hue/assets/huemagic-examples.gif)
+</script>

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

@@ -0,0 +1,32 @@
+{
+	"hue-scene": {
+		"config": {
+			"name": "Nome",
+			"input-name": "Nome da cena",
+			"skipevents-node": "Ignorar as mensagens do nó",
+			"sendinitevents-node": "Não suprimir o evento de inicialização",
+			"searching": "A procurar cenas…",
+			"none-found": "Nenhuma cena encontrada!",
+			"unknown-error": "Algo correu mal. Tente novamente.",
+			"scene": "Cena",
+			"group": "Grupo",
+			"group-none-found": "Nenhum grupo encontrado!",
+			"group-searching": "A procurar grupos…",
+			"groups-all": "Todos os grupos / luzes",
+			"bridge": "Bridge"
+		},
+		"node": {
+			"title": "Hue Cena",
+			"not-configured": "não configurado",
+			"recalled": "cena ativada",
+			"recalled-on-group": "cena ativada no grupo",
+			"no-id": "Sem ID de cena.",
+			"input": "ativar cena",
+			"output": "grupo(s) de destino",
+			"command": "a executar comando…",
+			"statusmsg": "A ativar a cena…",
+			"error-not-available": "A cena ainda não está disponível. Aguarde até que o HueMagic tenha estabelecido a ligação com o bridge ou verifique se o ID do recurso indicado na configuração é válido.",
+			"error-invalid-brightness": "Definição de brilho inválida. Apenas são permitidos valores de 0 a 100 por cento."
+		}
+	}
+}

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

@@ -0,0 +1,80 @@
+<script type="text/markdown" data-help-name="hue-speaker">
+O nó «Hue Altifalante» pode reproduzir os sons de uma campainha Hue Secure e utilizá-la como sirene de interior.
+
+### Configuração
+
+Selecione o Hue Bridge pré-configurado e clique no botão de pesquisa para encontrar todos os altifalantes disponíveis. Se já souber o ID do altifalante, também o pode introduzir aqui manualmente. Pode atribuir internamente um novo nome ao altifalante ou manter o nome predefinido. Opcionalmente, pode desativar todas as mensagens de estado automáticas deste nó através da definição «Ignorar as mensagens do nó». O nó deixará de emitir atualizações do dispositivo. Em alternativa, pode escolher que a mensagem de inicialização do nó não seja suprimida no arranque do Node-RED. Se ativar esta definição, receberá uma mensagem de estado do altifalante selecionado após cada implementação. Se preferir que o nó permaneça em silêncio até lhe enviar algo, ative «Comunicar apenas após um comando». Nesse caso, ignora as alterações feitas na aplicação ou num interruptor e responde apenas aos seus próprios comandos.
+
+Se não selecionar nenhum altifalante e utilizar assim a configuração do nó, o nó funciona no chamado «modo universal». Neste modo, o nó recebe e emite todas as mensagens de estado do mesmo tipo. Também pode aplicar definições no modo universal a um altifalante específico, transmitindo o respetivo ID como cadeia de carateres em `msg.topic` juntamente com as suas definições.
+
+### Consultar o estado
+
+Emite o estado atual do altifalante assim que for transmitido ao nó um objeto `msg.payload` com o seguinte conteúdo. Em alternativa, também pode premir o botão na interface do Node-RED sem ter de enviar previamente uma mensagem ao nó.
+
+: status (boolean): Devolve o estado atual do altifalante
+
+### Reproduzir um som
+
+Um altifalante conhece três canais distintos. `chime` é o som da campainha, `alarm` é a sirene e `alert` é uma notificação curta. Os sons que um aparelho conhece efetivamente são listados em `msg.info.sounds`. Transmita os seguintes parâmetros num objeto `msg.payload`:
+
+: chime (string | object | boolean): Nome do som da campainha; `false` para-o novamente
+: alarm (string | object | boolean): Nome do som da sirene; `false` para-o novamente
+: alert (string | object | boolean): Nome do som de notificação; `false` para-o novamente
+: mute (boolean): `true` silencia o altifalante, `false` volta a ativar o som
+
+Em vez de um simples nome de som, também pode transmitir um objeto para controlar o volume e a duração:
+
+: sound (string): Nome do som, p. ex. `ding_dong_classic` ou `siren`
+: volume (int): Volume em percentagem (0-100)
+: duration (float): Tempo de reprodução em segundos
+
+### Mensagens de estado do nó
+
+Assim que o altifalante começa ou deixa de reproduzir, o nó devolve a seguinte mensagem de estado.
+
+> [!NOTE]
+> O bridge comunica o último som reproduzido e só o repõe bastante depois de terminada a reprodução, pelo que estes valores ficam ligeiramente atrasados em relação ao áudio.
+
+#### Objeto de estado em `msg.payload`
+
+: reachable (boolean | string): `true` se o altifalante estiver ligado ao bridge, `unknown` se o estado da ligação divergir
+: connectionStatus (string): O estado atual da ligação com o bridge sob a forma de uma cadeia de carateres. Pode conter `connected`, `disconnected`, `connectivity_issue` ou `unidirectional_incoming` como valor
+: playing (boolean): `true` enquanto o altifalante estiver a reproduzir algum som
+: chime (string | boolean): Nome do som de campainha em reprodução ou `false`
+: alarm (string | boolean): Nome do som de sirene em reprodução ou `false`
+: alert (string | boolean): Nome do som de notificação em reprodução ou `false`
+: muted (boolean): Indica se o altifalante está silenciado
+: updated (string): Momento da última atualização do recurso pelo HueMagic (ISO 8601)
+
+#### Informações sobre o altifalante em `msg.info`
+
+: id (string): Indica o novo ID do altifalante
+: idV1 (string | boolean): Indica o ID antigo do altifalante
+: uniqueId (string): O ID único do altifalante
+: deviceId (string): O ID único do dispositivo
+: name (string): O nome atualmente atribuído ao altifalante
+: type (string): O tipo do dispositivo (sempre `speaker`)
+: softwareVersion (string): O firmware atual do altifalante
+: battery (float | boolean): O nível atual da bateria do altifalante, `false` quando não existe bateria
+: batteryState (string | boolean): O estado atual do nível da bateria. Pode conter `normal`, `low` ou `critical` como valor, ou `false` quando não existe bateria
+: sounds (object): Contém os sons que este aparelho conhece em `chime`, `alarm` e `alert`
+: model (object): Contém as informações de modelo do altifalante em `id`, `manufacturer`, `name`, `type` e `certified`
+
+#### Alterações de estado em `msg.updated`
+
+Enumera sob a forma de um objeto os parâmetros que foram alterados em relação ao último estado do altifalante. Se não tiverem sido registadas alterações, este objeto está vazio.
+
+#### Último estado do altifalante em `msg.lastState`
+
+Contém o objeto de estado completo (ver os valores de saída acima) do último estado antes da última alteração registada. Se o HueMagic ainda não tiver registado o último estado, é emitido `false`.
+
+#### Último comando em `msg.command` (opcional)
+
+Se o estado do nó tiver sido alterado através de um determinado comando, é também emitido o comando completo que foi executado. Caso contrário, o nó não emite este objeto.
+
+### Exemplos do HueMagic
+
+O HueMagic disponibiliza algumas configurações de exemplo para este nó. Para importar um exemplo completo na sua interface Node-RED, clique no ícone de menu do Node-RED, selecione «Importar» e navegue até «Exemplos» na barra lateral da janela. Em seguida, selecione a pasta HueMagic e o nó pretendido para importar um fluxo de exemplo.
+
+![examples](hue/assets/huemagic-examples.gif)
+</script>

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

@@ -0,0 +1,38 @@
+{
+	"hue-speaker": {
+		"config": {
+			"name": "Nome",
+			"skipevents-node": "Ignorar as mensagens do nó",
+			"sendinitevents-node": "Não suprimir o evento de inicialização",
+			"onlycommands-node": "Comunicar apenas após um comando",
+			"unknown-error": "Algo correu mal. Tente novamente.",
+			"bridge": "Bridge",
+			"universalevents": "Eventos universais",
+			"universalevents-node": "Recebe todas as mensagens de outros nós do mesmo tipo (apenas no modo universal)",
+			"input-name": "Nome do altifalante",
+			"searching": "A procurar altifalantes…",
+			"none-found": "Nenhum altifalante encontrado!",
+			"speaker": "Altifalante"
+		},
+		"node": {
+			"not-configured": "não configurado",
+			"not-reachable": "inacessível",
+			"universal": "modo universal",
+			"command": "a executar comando…",
+			"statusmsg": "Estado consultado com sucesso…",
+			"title": "Hue Altifalante",
+			"silent": "silencioso",
+			"muted": "sem som",
+			"playing-alarm": "alarme (__sound__)",
+			"playing-chime": "campainha (__sound__)",
+			"playing-alert": "aviso (__sound__)",
+			"input": "reproduzir som / estado",
+			"output": "altifalante",
+			"error-no-id": "Indique um ID de altifalante válido.",
+			"error-not-available": "O altifalante ainda não está disponível. Aguarde até que o HueMagic tenha estabelecido a ligação com o bridge ou verifique se o ID do recurso indicado na configuração é válido.",
+			"error-no-channel": "Este altifalante não tem qualquer som do tipo __channel__.",
+			"error-invalid-sound": "Som de __channel__ inválido. São permitidos: __sounds__",
+			"error-invalid-volume": "Definição de volume inválida. Apenas são permitidos valores de 0 a 100."
+		}
+	}
+}