node-red-contrib-huemagic 4.2.2 → 5.0.1

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

@@ -0,0 +1,68 @@
+<script type="text/markdown" data-help-name="hue-magic">
+Il nodo «Hue Magic» può applicare animazioni complesse e personalizzate a luci e gruppi.
+
+### Configurazione
+
+Assegni prima un nome al nodo per poter identificare chiaramente la sua animazione nell'interfaccia di Node-RED. Può poi scegliere tra le opzioni «Ciclo» e «Ripristina». Selezioni l'opzione ciclo se desidera che l'animazione venga eseguita all'infinito su una luce o un gruppo finché non la interrompe manualmente. Se desidera ripristinare lo stato precedente della risorsa di destinazione (luce / gruppo) al termine dell'animazione, spunti l'opzione «Ripristina». In caso contrario, l'ultimo fotogramma dell'animazione rimane sulla rispettiva risorsa.
+
+Più sotto può scegliere tra le animazioni già pronte di HueMagic. Faccia clic sull'animazione desiderata per impostarla.
+
+### Avviare / arrestare l'animazione
+
+Per riprodurre o arrestare un'animazione, trasmetta al nodo un oggetto con il seguente contenuto:
+
+: payload (boolean): `true` avvia l'animazione, `false` la arresta
+
+### Animazioni personalizzate
+
+Se trasmette al nodo una propria animazione, l'animazione predefinita selezionata (se impostata) viene temporaneamente sostituita dalla sua. Le animazioni personalizzate di HueMagic sono una sequenza di comandi raggruppati in un array. Ogni elemento dell'array costituisce un passo, e un passo può essere a sua volta composto da più fotogrammi (effetti di transizione).
+
+Crei un `array` con i singoli passi dell'animazione sotto forma di oggetto e lo trasmetta al nodo HueMagic in `msg.payload.steps`.
+
+: delay (int): Numero di millisecondi da attendere prima dell'esecuzione di questo passo
+: animation (object): L'oggetto contiene l'azione o le azioni da eseguire in questo passo. Parametri identici a quelli dei nodi «Hue Luce» e «Hue Gruppo»
+
+### Esempio di animazione personalizzata
+
+Questo esempio mostra come potrebbe essere una semplice animazione. Nel primo passo viene atteso il ritardo di 500 millisecondi. Il colore della luce passa poi lentamente al rosso nell'arco di un secondo. Non appena la luce è completamente rossa, viene eseguito il secondo passo, anch'esso con un ritardo di 500 millisecondi. Infine il colore passa al blu.
+
+Se ha impostato l'animazione in ciclo, questo processo si ripete all'infinito finché non arresta manualmente l'animazione o non esegue di nuovo il deploy del nodo.
+
+Trasmetta il seguente oggetto in `msg.payload` per riprodurre l'animazione di esempio.
+
+    {
+        "animate": true,
+        "steps": [
+            {
+                "delay": 500,
+                "animation": {
+                    "hex": "#FF0000",
+                    "transitionTime": 1
+                }
+            },
+            {
+                "delay": 500,
+                "animation": {
+                    "hex": "#0000FF",
+                    "transitionTime": 1
+                }
+            }
+        ]
+    }
+
+### Comandi speciali
+
+A volte ha senso riprodurre un'animazione in modo disordinato, ad es. per imitare il fuoco in maniera più realistica. Per riprodurre i singoli passi in ordine casuale, può trasmettere il seguente comando in `msg.payload.specials`:
+
+: randomOrder (boolean | any): `true` attiva la riproduzione casuale dei singoli passi dell'animazione
+
+### Consigli e note
+
+Questo nodo non emette messaggi di stato. Colleghi l'uscita del nodo a un gruppo anziché a singole luci se desidera animare più luci contemporaneamente con la stessa animazione. Le anteprime delle animazioni già pronte sono simulazioni e possono differire leggermente (tempi, colori) dall'animazione reale su una risorsa.
+
+### Esempi di HueMagic
+
+HueMagic mette a disposizione alcune configurazioni di esempio per questo nodo. Per importare un esempio completo nella sua interfaccia Node-RED, faccia clic sull'icona del menu di Node-RED, selezioni «Importa» e navighi fino a «Esempi» nella barra laterale della finestra. Selezioni quindi la cartella HueMagic e il nodo desiderato per importare un flusso di esempio.
+
+![examples](hue/assets/huemagic-examples.gif)
+</script>

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

@@ -0,0 +1,26 @@
+{
+	"hue-magic": {
+		"config": {
+			"name": "Nome",
+			"input-name": "Nome dell'animazione",
+			"loop": "Ciclo",
+			"loop-endless": "Ripeti all'infinito",
+			"restore": "Ripristina",
+			"restore-state": "Ripristina lo stato precedente dopo l'arresto",
+			"animation": "Animazione",
+			"unknown-error": "Qualcosa è andato storto. Riprovi.",
+			"seconds": "s",
+			"minutes": "min"
+		},
+		"node": {
+			"title": "Hue Magic",
+			"no-animation": "nessuna animazione indicata",
+			"animating": "animazione in corso…",
+			"stopped": "arrestata",
+			"input": "avvia / arresta animazione",
+			"output": "luce o gruppo",
+			"command": "esecuzione del comando…",
+			"playmsg": "Animazione avviata…"
+		}
+	}
+}

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

@@ -0,0 +1,64 @@
+<script type="text/markdown" data-help-name="hue-motion">
+Il nodo «Hue Movimento» può registrare e comunicare i movimenti rilevati da un sensore adatto collegato al bridge.
+
+### Configurazione
+
+Selezioni il Hue Bridge preconfigurato e faccia clic sul pulsante di ricerca per trovare tutti i sensori disponibili. Se conosce già l'ID del sensore, può anche inserirlo qui manualmente. Può assegnare internamente un nuovo nome al sensore oppure mantenere quello predefinito. Facoltativamente può disattivare tutti i messaggi di stato automatici di questo nodo tramite l'impostazione «Ignora i messaggi del nodo». Il nodo non emetterà più aggiornamenti del dispositivo. In alternativa può scegliere che il messaggio di inizializzazione del nodo non venga soppresso all'avvio di Node-RED. Attivando questa impostazione riceverà un messaggio di stato del sensore selezionato dopo ogni deploy. Se preferisce che il nodo resti in silenzio finché non gli invia qualcosa, attivi «Segnala solo dopo un comando». In tal caso ignorerà le modifiche provenienti dall'app o da un interruttore e risponderà solo ai suoi comandi.
+
+Se non seleziona alcun sensore e utilizza così la configurazione del nodo, il nodo funziona nella cosiddetta «modalità universale». In questa modalità il nodo riceve ed emette tutti i messaggi di stato dello stesso tipo. Può anche applicare impostazioni in modalità universale a un sensore specifico trasmettendo il relativo ID sensore come stringa in `msg.topic` insieme alle sue impostazioni.
+
+### Richiedere lo stato
+
+Emette lo stato attuale del sensore non appena al nodo viene trasmesso un oggetto `msg.payload` con il seguente contenuto. In alternativa può anche premere il pulsante nell'interfaccia di Node-RED senza dover inviare prima un messaggio al nodo.
+
+: status (boolean): Restituisce lo stato attuale del sensore
+
+### Accendere / spegnere il sensore
+
+Se necessario, il sensore può essere acceso e spento da remoto. Se il sensore è spento, non registra più alcun movimento e di conseguenza non lo emette. A tal fine, trasmetta un oggetto con il seguente contenuto:
+
+: payload (boolean): `true` accende il sensore, `false` lo spegne
+
+### Messaggi di stato del nodo
+
+Non appena il sensore registra un movimento, il nodo restituisce il seguente messaggio di stato:
+
+#### Oggetto di stato in `msg.payload`
+
+: active (boolean): Indica se il sensore è acceso o spento
+: reachable (boolean | string): `true` se il sensore è collegato al bridge, `unknown` se lo stato della connessione è diverso
+: connectionStatus (string): Lo stato attuale della connessione con il bridge sotto forma di stringa. Può contenere `connected`, `disconnected`, `connectivity_issue` o `unidirectional_incoming` come valore
+: motion (boolean): Indica se è stato registrato un movimento
+: updated (string): Momento dell'ultimo aggiornamento della risorsa da parte di HueMagic (ISO 8601)
+
+#### Informazioni sul sensore in `msg.info`
+
+: id (string): Indica il nuovo ID del sensore
+: idV1 (string | boolean): Indica il vecchio ID del sensore
+: uniqueId (string): L'ID univoco del sensore
+: deviceId (string): L'ID univoco del dispositivo
+: name (string): Il nome attualmente assegnato al sensore
+: type (string): Il tipo di sensore (sempre `motion`)
+: softwareVersion (string): Il firmware attuale del sensore
+: battery (float): Il livello attuale della batteria del sensore
+: batteryState (string): Lo stato attuale del livello della batteria. Può contenere `normal`, `low` o `critical` come valore
+: model (object): Contiene le informazioni sul modello del sensore in `id`, `manufacturer`, `name`, `type` e `certified`
+
+#### Variazioni di stato in `msg.updated`
+
+Elenca sotto forma di oggetto i singoli parametri modificati rispetto all'ultimo stato del sensore. Se non è stata registrata alcuna modifica, questo oggetto è vuoto.
+
+#### Ultimo stato del sensore in `msg.lastState`
+
+Contiene l'oggetto di stato completo (vedi i valori di uscita sopra) dell'ultimo stato prima dell'ultima modifica registrata. Se HueMagic non ha ancora registrato l'ultimo stato, viene emesso `false`.
+
+#### Ultimo comando in `msg.command` (facoltativo)
+
+Se lo stato del nodo è cambiato a seguito di un determinato comando, viene emesso anche l'intero comando eseguito. In caso contrario, il nodo non emette questo oggetto.
+
+### Esempi di HueMagic
+
+HueMagic mette a disposizione alcune configurazioni di esempio per questo nodo. Per importare un esempio completo nella sua interfaccia Node-RED, faccia clic sull'icona del menu di Node-RED, selezioni «Importa» e navighi fino a «Esempi» nella barra laterale della finestra. Selezioni quindi la cartella HueMagic e il nodo desiderato per importare un flusso di esempio.
+
+![examples](hue/assets/huemagic-examples.gif)
+</script>

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

@@ -0,0 +1,36 @@
+{
+	"hue-motion": {
+		"config": {
+			"name": "Nome",
+			"skipevents-node": "Ignora i messaggi del nodo",
+			"sendinitevents-node": "Non sopprimere l'evento di inizializzazione",
+			"onlycommands-node": "Segnala solo dopo un comando",
+			"unknown-error": "Qualcosa è andato storto. Riprovi.",
+			"bridge": "Bridge",
+			"universalevents": "Eventi universali",
+			"universalevents-node": "Riceve tutti i messaggi dagli altri nodi dello stesso tipo (solo in modalità universale)",
+			"input-name": "Nome del sensore",
+			"searching": "Ricerca di sensori di movimento…",
+			"none-found": "Nessun sensore di movimento trovato!",
+			"sensor": "Sensore"
+		},
+		"node": {
+			"not-configured": "non configurato",
+			"not-reachable": "non raggiungibile",
+			"activated": "attivato",
+			"deactivated": "disattivato",
+			"universal": "modalità universale",
+			"command": "esecuzione del comando…",
+			"statusmsg": "Stato interrogato correttamente…",
+			"title": "Hue Movimento",
+			"motion": "movimento rilevato",
+			"no-motion": "nessun movimento",
+			"input": "attiva / disattiva / stato",
+			"output": "movimento rilevato",
+			"error-no-id": "Indichi un ID sensore valido.",
+			"error-not-available": "Il sensore non è ancora disponibile. Attenda che HueMagic abbia stabilito la connessione con il bridge oppure verifichi se l'ID della risorsa indicato nella configurazione è valido.",
+			"error-no-sensitivity": "Questa sorgente di movimento non ha una sensibilità regolabile.",
+			"error-invalid-sensitivity": "Sensibilità non valida. Sono consentiti solo valori da 0 a __max__."
+		}
+	}
+}

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

@@ -0,0 +1,69 @@
+<script type="text/markdown" data-help-name="hue-rules">
+Il nodo «Hue Regola» può attivare o disattivare le regole salvate nel bridge e richiamarne le impostazioni.
+
+### Configurazione
+
+Selezioni il Hue Bridge preconfigurato e faccia clic sul pulsante di ricerca per trovare tutte le regole disponibili. Se conosce già l'ID della regola, può anche inserirlo qui manualmente. In alternativa può assegnare un nuovo nome oppure mantenere quello predefinito della regola. Facoltativamente può disattivare tutti i messaggi di stato automatici di questo nodo tramite l'impostazione «Ignora i messaggi del nodo». Il nodo non emetterà più aggiornamenti. In alternativa può scegliere che il messaggio di inizializzazione del nodo non venga soppresso all'avvio di Node-RED. Se preferisce che il nodo resti in silenzio finché non gli invia qualcosa, attivi «Segnala solo dopo un comando». In tal caso ignorerà le modifiche provenienti dall'app o da un interruttore e risponderà solo ai suoi comandi.
+
+Se non seleziona alcuna regola e utilizza così la configurazione del nodo, il nodo funziona nella cosiddetta «modalità universale». In questa modalità il nodo riceve ed emette tutti i messaggi di stato dello stesso tipo. Può anche applicare impostazioni in modalità universale a una regola specifica trasmettendo il relativo ID come stringa in `msg.topic` insieme alle sue impostazioni.
+
+### Richiedere proprietà e impostazioni
+
+Emette le proprietà attuali della regola non appena al nodo viene trasmesso un oggetto `msg.payload` con il seguente contenuto. In alternativa può anche premere il pulsante nell'interfaccia di Node-RED senza dover inviare prima un messaggio al nodo.
+
+: status (boolean): Restituisce lo stato attuale della regola
+
+### Attivare / disattivare la regola
+
+La regola può essere attivata e disattivata all'occorrenza. Se la regola è disattivata, non verrà più eseguita nel bridge finché non la riattiverà. A tal fine, trasmetta un oggetto con il seguente contenuto:
+
+: payload (boolean): `true` attiva la regola, `false` la disattiva
+
+### Messaggi di stato del nodo
+
+Non appena lo stato (attivata / disattivata) di una regola cambia, il nodo restituisce il seguente messaggio di stato:
+
+#### Oggetto di stato in `msg.payload`
+
+: enabled (boolean): Indica se la regola è attivata o disattivata
+: triggered (string): Momento dell'ultima esecuzione (ISO 8601)
+
+#### Informazioni sulla regola in `msg.info`
+
+: id (string): L'ID univoco della regola
+: created (string): Data di creazione della regola (ISO 8601)
+: name (string): Nome della regola sul bridge
+: timesTriggered (int): Numero di volte in cui la regola è stata eseguita sul bridge
+: owner (string): ID del proprietario di questa regola
+: status (string): Stato della regola sotto forma di stringa
+
+#### Condizioni della regola in `msg.conditions` (array)
+
+: address (string): Percorso verso un attributo di un sensore
+: operator (string): Operatore
+: value (string): Il valore da verificare
+
+#### Azioni della regola in `msg.actions` (array)
+
+: address (string): L'indirizzo di destinazione della risorsa
+: method (string): Il metodo della richiesta
+: body (object): L'azione da eseguire
+
+#### Variazioni di stato in `msg.updated`
+
+Elenca sotto forma di oggetto i singoli parametri modificati rispetto all'ultimo stato della regola. Se non è stata registrata alcuna modifica, questo oggetto è vuoto.
+
+#### Ultimo stato della regola in `msg.lastState`
+
+Contiene l'oggetto completo (vedi i valori di uscita sopra) dell'ultimo stato prima dell'ultima modifica registrata della regola. Se HueMagic non ha ancora registrato l'ultimo stato, viene emesso `false`.
+
+#### Ultimo comando in `msg.command` (facoltativo)
+
+Se lo stato del nodo è cambiato a seguito di un determinato comando, viene emesso anche l'intero comando eseguito. In caso contrario, il nodo non emette questo oggetto.
+
+### Esempi di HueMagic
+
+HueMagic mette a disposizione alcune configurazioni di esempio per questo nodo. Per importare un esempio completo nella sua interfaccia Node-RED, faccia clic sull'icona del menu di Node-RED, selezioni «Importa» e navighi fino a «Esempi» nella barra laterale della finestra. Selezioni quindi la cartella HueMagic e il nodo desiderato per importare un flusso di esempio.
+
+![examples](hue/assets/huemagic-examples.gif)
+</script>

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

@@ -0,0 +1,30 @@
+{
+	"hue-rules": {
+		"config": {
+			"name": "Nome",
+			"skipevents-node": "Ignora i messaggi del nodo",
+			"sendinitevents-node": "Non sopprimere l'evento di inizializzazione",
+			"onlycommands-node": "Segnala solo dopo un comando",
+			"unknown-error": "Qualcosa è andato storto. Riprovi.",
+			"bridge": "Bridge",
+			"input-name": "Nome della regola",
+			"searching": "Ricerca di regole…",
+			"none-found": "Nessuna regola trovata!",
+			"rule": "Regola"
+		},
+		"node": {
+			"init": "inizializzazione…",
+			"universal": "modalità universale",
+			"command": "esecuzione del comando…",
+			"statusmsg": "Stato interrogato correttamente…",
+			"title": "Hue Regola",
+			"no-rule": "nessuna regola selezionata",
+			"enabled": "attivata",
+			"disabled": "disattivata",
+			"output": "regola (eseguita)",
+			"input": "attiva / disattiva",
+			"error-no-id": "Indichi un ID regola valido.",
+			"error-not-available": "La regola non è ancora disponibile. Attenda che HueMagic abbia stabilito la connessione con il bridge oppure verifichi se l'ID della risorsa indicato nella configurazione è valido."
+		}
+	}
+}

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

@@ -0,0 +1,43 @@
+<script type="text/markdown" data-help-name="hue-scene">
+Il nodo «Hue Scena» può richiamare scene salvate nel bridge e applicarle a determinati gruppi.
+
+### Configurazione
+
+Selezioni il Hue Bridge preconfigurato e faccia clic sul pulsante di ricerca per trovare tutte le scene disponibili. Le scene vengono ordinate prima per stanza o zona e poi per nome, così le scene di una stessa stanza restano sempre vicine nell'elenco. Se conosce già l'ID della scena, può anche inserirlo qui manualmente. In alternativa può assegnare internamente un nome alla scena oppure mantenere quello predefinito.
+
+### Attivare una scena
+
+Può attivare una scena predefinita trasmettendo un oggetto con il seguente contenuto:
+
+: payload (boolean): Attiva una scena preconfigurata
+: transitionTime (float): Tempo di transizione della scena in secondi. Se viene trasmesso `0`, la scena viene applicata immediatamente. Se trasmette `3`, le luci passano alla scena in dissolvenza nei 3 secondi successivi. Il bridge accetta fino a 6000 secondi
+: brightness (float): Luminosità dell'intera scena in percentuale (`0` – `100`), così può richiamare una stessa scena più chiara o più soffusa a seconda dell'ora del giorno
+
+> [!NOTE]
+> Entrambe le impostazioni sono disponibili solo per le scene normali. Una scena smart segue gli orari che ha definito per essa nell'app Philips Hue.
+
+### Attivare una scena in modalità universale
+
+Se utilizza questo nodo nella cosiddetta «modalità universale» e non ha impostato alcuna scena nella configurazione del nodo, può anche trasmettere al nodo la scena desiderata come comando. A tal fine, trasmetta un oggetto `msg.payload` con il seguente contenuto:
+
+: scene (string): ID della scena da attivare sul bridge
+
+### Attivare una scena su determinati gruppi
+
+Colleghi l'uscita di questo nodo a uno o più gruppi per applicare una scena a gruppi specifici. In alternativa può farlo «dinamicamente» trasmettendo al nodo un oggetto `msg.payload` con il seguente contenuto:
+
+: group (string | array [string,…]): ID del gruppo o un array con gli ID di più gruppi per limitare la scena a tali gruppi
+
+### Ulteriori informazioni sul nodo
+
+Questo nodo non emette messaggi di stato.
+
+> [!IMPORTANT]
+> Può applicare le scene ai gruppi solo se questi sono già collegati alla rispettiva scena sul bridge. In caso contrario non verrà applicato nulla.
+
+### Esempi di HueMagic
+
+HueMagic mette a disposizione alcune configurazioni di esempio per questo nodo. Per importare un esempio completo nella sua interfaccia Node-RED, faccia clic sull'icona del menu di Node-RED, selezioni «Importa» e navighi fino a «Esempi» nella barra laterale della finestra. Selezioni quindi la cartella HueMagic e il nodo desiderato per importare un flusso di esempio.
+
+![examples](hue/assets/huemagic-examples.gif)
+</script>

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

@@ -0,0 +1,32 @@
+{
+	"hue-scene": {
+		"config": {
+			"name": "Nome",
+			"input-name": "Nome della scena",
+			"skipevents-node": "Ignora i messaggi del nodo",
+			"sendinitevents-node": "Non sopprimere l'evento di inizializzazione",
+			"searching": "Ricerca di scene…",
+			"none-found": "Nessuna scena trovata!",
+			"unknown-error": "Qualcosa è andato storto. Riprovi.",
+			"scene": "Scena",
+			"group": "Gruppo",
+			"group-none-found": "Nessun gruppo trovato!",
+			"group-searching": "Ricerca di gruppi…",
+			"groups-all": "Tutti i gruppi / le luci",
+			"bridge": "Bridge"
+		},
+		"node": {
+			"title": "Hue Scena",
+			"not-configured": "non configurato",
+			"recalled": "scena attivata",
+			"recalled-on-group": "scena attivata sul gruppo",
+			"no-id": "Nessun ID scena.",
+			"input": "attiva la scena",
+			"output": "gruppo/i di destinazione",
+			"command": "esecuzione del comando…",
+			"statusmsg": "Attivazione della scena…",
+			"error-not-available": "La scena non è ancora disponibile. Attenda che HueMagic abbia stabilito la connessione con il bridge oppure verifichi se l'ID della risorsa indicato nella configurazione è valido.",
+			"error-invalid-brightness": "Impostazione di luminosità non valida. Sono consentiti solo valori da 0 a 100 percento."
+		}
+	}
+}

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

@@ -0,0 +1,80 @@
+<script type="text/markdown" data-help-name="hue-speaker">
+Il nodo «Hue Altoparlante» può riprodurre i suoni di un campanello Hue Secure e utilizzarlo come sirena da interni.
+
+### Configurazione
+
+Selezioni il Hue Bridge preconfigurato e faccia clic sul pulsante di ricerca per trovare tutti gli altoparlanti disponibili. Se conosce già l'ID dell'altoparlante, può anche inserirlo qui manualmente. Può assegnare internamente un nuovo nome all'altoparlante oppure mantenere quello predefinito. Facoltativamente può disattivare tutti i messaggi di stato automatici di questo nodo tramite l'impostazione «Ignora i messaggi del nodo». Il nodo non emetterà più aggiornamenti del dispositivo. In alternativa può scegliere che il messaggio di inizializzazione del nodo non venga soppresso all'avvio di Node-RED. Attivando questa impostazione riceverà un messaggio di stato dell'altoparlante selezionato dopo ogni deploy. Se preferisce che il nodo resti in silenzio finché non gli invia qualcosa, attivi «Segnala solo dopo un comando». In tal caso ignorerà le modifiche provenienti dall'app o da un interruttore e risponderà solo ai suoi comandi.
+
+Se non seleziona alcun altoparlante e utilizza così la configurazione del nodo, il nodo funziona nella cosiddetta «modalità universale». In questa modalità il nodo riceve ed emette tutti i messaggi di stato dello stesso tipo. Può anche applicare impostazioni in modalità universale a un altoparlante specifico trasmettendo il relativo ID come stringa in `msg.topic` insieme alle sue impostazioni.
+
+### Richiedere lo stato
+
+Emette lo stato attuale dell'altoparlante non appena al nodo viene trasmesso un oggetto `msg.payload` con il seguente contenuto. In alternativa può anche premere il pulsante nell'interfaccia di Node-RED senza dover inviare prima un messaggio al nodo.
+
+: status (boolean): Restituisce lo stato attuale dell'altoparlante
+
+### Riprodurre un suono
+
+Un altoparlante conosce tre canali separati. `chime` è il suono del campanello, `alarm` è la sirena e `alert` è una breve notifica. I suoni effettivamente conosciuti da un dispositivo sono elencati in `msg.info.sounds`. Trasmetta i seguenti parametri in un oggetto `msg.payload`:
+
+: chime (string | object | boolean): Nome del suono del campanello; `false` lo interrompe di nuovo
+: alarm (string | object | boolean): Nome del suono della sirena; `false` lo interrompe di nuovo
+: alert (string | object | boolean): Nome del suono di notifica; `false` lo interrompe di nuovo
+: mute (boolean): `true` disattiva l'audio dell'altoparlante, `false` lo riattiva
+
+Al posto del semplice nome del suono può anche trasmettere un oggetto per controllare volume e durata:
+
+: sound (string): Nome del suono, ad es. `ding_dong_classic` o `siren`
+: volume (int): Volume in percentuale (0-100)
+: duration (float): Durata di riproduzione in secondi
+
+### Messaggi di stato del nodo
+
+Non appena l'altoparlante inizia o smette di riprodurre, il nodo restituisce il seguente messaggio di stato.
+
+> [!NOTE]
+> Il bridge segnala l'ultimo suono riprodotto e lo azzera solo molto dopo la fine della riproduzione, quindi questi valori sono leggermente in ritardo rispetto all'audio.
+
+#### Oggetto di stato in `msg.payload`
+
+: reachable (boolean | string): `true` se l'altoparlante è collegato al bridge, `unknown` se lo stato della connessione è diverso
+: connectionStatus (string): Lo stato attuale della connessione con il bridge sotto forma di stringa. Può contenere `connected`, `disconnected`, `connectivity_issue` o `unidirectional_incoming` come valore
+: playing (boolean): `true` mentre l'altoparlante riproduce un suono qualsiasi
+: chime (string | boolean): Nome del suono del campanello in riproduzione o `false`
+: alarm (string | boolean): Nome del suono della sirena in riproduzione o `false`
+: alert (string | boolean): Nome del suono di notifica in riproduzione o `false`
+: muted (boolean): Indica se l'audio dell'altoparlante è disattivato
+: updated (string): Momento dell'ultimo aggiornamento della risorsa da parte di HueMagic (ISO 8601)
+
+#### Informazioni sull'altoparlante in `msg.info`
+
+: id (string): Indica il nuovo ID dell'altoparlante
+: idV1 (string | boolean): Indica il vecchio ID dell'altoparlante
+: uniqueId (string): L'ID univoco dell'altoparlante
+: deviceId (string): L'ID univoco del dispositivo
+: name (string): Il nome attualmente assegnato all'altoparlante
+: type (string): Il tipo di dispositivo (sempre `speaker`)
+: softwareVersion (string): Il firmware attuale dell'altoparlante
+: battery (float | boolean): Il livello attuale della batteria dell'altoparlante, `false` se non è presente alcuna batteria
+: batteryState (string | boolean): Lo stato attuale del livello della batteria. Può contenere `normal`, `low` o `critical` come valore, `false` se non è presente alcuna batteria
+: sounds (object): Contiene i suoni conosciuti da questo dispositivo in `chime`, `alarm` e `alert`
+: model (object): Contiene le informazioni sul modello dell'altoparlante in `id`, `manufacturer`, `name`, `type` e `certified`
+
+#### Variazioni di stato in `msg.updated`
+
+Elenca sotto forma di oggetto i singoli parametri modificati rispetto all'ultimo stato dell'altoparlante. Se non è stata registrata alcuna modifica, questo oggetto è vuoto.
+
+#### Ultimo stato dell'altoparlante in `msg.lastState`
+
+Contiene l'oggetto di stato completo (vedi i valori di uscita sopra) dell'ultimo stato prima dell'ultima modifica registrata. Se HueMagic non ha ancora registrato l'ultimo stato, viene emesso `false`.
+
+#### Ultimo comando in `msg.command` (facoltativo)
+
+Se lo stato del nodo è cambiato a seguito di un determinato comando, viene emesso anche l'intero comando eseguito. In caso contrario, il nodo non emette questo oggetto.
+
+### Esempi di HueMagic
+
+HueMagic mette a disposizione alcune configurazioni di esempio per questo nodo. Per importare un esempio completo nella sua interfaccia Node-RED, faccia clic sull'icona del menu di Node-RED, selezioni «Importa» e navighi fino a «Esempi» nella barra laterale della finestra. Selezioni quindi la cartella HueMagic e il nodo desiderato per importare un flusso di esempio.
+
+![examples](hue/assets/huemagic-examples.gif)
+</script>

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

@@ -0,0 +1,38 @@
+{
+	"hue-speaker": {
+		"config": {
+			"name": "Nome",
+			"skipevents-node": "Ignora i messaggi del nodo",
+			"sendinitevents-node": "Non sopprimere l'evento di inizializzazione",
+			"onlycommands-node": "Segnala solo dopo un comando",
+			"unknown-error": "Qualcosa è andato storto. Riprovi.",
+			"bridge": "Bridge",
+			"universalevents": "Eventi universali",
+			"universalevents-node": "Riceve tutti i messaggi dagli altri nodi dello stesso tipo (solo in modalità universale)",
+			"input-name": "Nome dell'altoparlante",
+			"searching": "Ricerca di altoparlanti…",
+			"none-found": "Nessun altoparlante trovato!",
+			"speaker": "Altoparlante"
+		},
+		"node": {
+			"not-configured": "non configurato",
+			"not-reachable": "non raggiungibile",
+			"universal": "modalità universale",
+			"command": "esecuzione del comando…",
+			"statusmsg": "Stato interrogato correttamente…",
+			"title": "Hue Altoparlante",
+			"silent": "silenzioso",
+			"muted": "disattivato",
+			"playing-alarm": "allarme (__sound__)",
+			"playing-chime": "campanello (__sound__)",
+			"playing-alert": "avviso (__sound__)",
+			"input": "riproduci suono / stato",
+			"output": "altoparlante",
+			"error-no-id": "Indichi un ID altoparlante valido.",
+			"error-not-available": "L'altoparlante non è ancora disponibile. Attenda che HueMagic abbia stabilito la connessione con il bridge oppure verifichi se l'ID della risorsa indicato nella configurazione è valido.",
+			"error-no-channel": "Questo altoparlante non ha alcun suono di tipo __channel__.",
+			"error-invalid-sound": "Suono __channel__ non valido. Sono consentiti: __sounds__",
+			"error-invalid-volume": "Impostazione del volume non valida. Sono consentiti solo valori da 0 a 100."
+		}
+	}
+}

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

@@ -0,0 +1,19 @@
+<script type="text/markdown" data-help-name="hue-syncbox-config">
+Si collega a una Philips Hue Play HDMI Sync Box.
+
+### Nome
+
+Può assegnare alla sync box un nome interno alternativo oppure mantenere quello predefinito.
+
+### IP della Sync Box
+
+L'indirizzo IP della sua sync box nella rete locale. Appena lo inserisce, HueMagic prova a leggere il nome del dispositivo e lo compila al posto suo.
+
+### Token di accesso
+
+La sync box non fa parte del suo Hue Bridge e necessita di un proprio token. Faccia clic sul pulsante accanto al campo e tenga poi premuto il pulsante sulla sync box finché il LED non lampeggia in verde. HueMagic continua a interrogare il dispositivo per un minuto e memorizza il token non appena risponde.
+
+### Aggiornamento
+
+La sync box non invia da sola il proprio stato, quindi HueMagic lo richiede regolarmente. Questa impostazione definisce quanti secondi intercorrono tra due richieste. Il valore predefinito di 10 secondi è un buon compromesso tra reattività dello stato e traffico di rete: non lo riduca più del necessario.
+</script>

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

@@ -0,0 +1,25 @@
+{
+	"hue-syncbox-config": {
+		"config": {
+			"name": "Nome",
+			"syncbox-ip": "IP della Sync Box",
+			"token": "Token di accesso",
+			"pollinterval": "Aggiornamento (s)",
+			"missing-ip": "IP della Hue Sync Box mancante…",
+			"connecting": "Connessione alla sync box…",
+			"invalid": "Spiacenti. La Hue Sync Box selezionata non è valida: ",
+			"error-select-first": "Inserisca l'IP della sua Hue Sync Box prima di creare un nuovo token!",
+			"waiting": "in attesa della pressione del pulsante…",
+			"new-user-press": "Tenga premuto il pulsante della sua Hue Sync Box finché il LED non lampeggia in verde!",
+			"retry": "Nessuna pressione rilevata. Riprovi…",
+			"success": "Token di accesso creato correttamente!"
+		},
+		"node": {
+			"title": "Hue Sync Box",
+			"initializing": "Inizializzazione della sync box (__syncbox__)…",
+			"connected": "Connesso alla sync box",
+			"request-error": "Errore durante la richiesta di informazioni alla sync box (__error__)",
+			"statusmsg": "Stato interrogato correttamente…"
+		}
+	}
+}

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

@@ -0,0 +1,86 @@
+<script type="text/markdown" data-help-name="hue-syncbox">
+Il nodo «Hue Sync Box» controlla una Philips Hue Play HDMI Sync Box e comunica ciò che sta facendo in quel momento.
+
+### Configurazione
+
+La sync box non è collegata al suo Hue Bridge ma parla una propria API locale, quindi necessita di una configurazione a sé. Inserisca l'indirizzo IP della sua sync box e faccia clic sul pulsante accanto al campo del token di accesso. Tenga poi premuto il pulsante sulla sync box finché il LED non lampeggia in verde: HueMagic continua a interrogare il dispositivo per un minuto e memorizza il token non appena risponde.
+
+Poiché la sync box non invia da sola il proprio stato, HueMagic lo richiede regolarmente. Può impostare la frequenza nella configurazione; il valore predefinito è ogni 10 secondi. Facoltativamente può disattivare tutti i messaggi di stato automatici di questo nodo tramite l'impostazione «Ignora i messaggi del nodo». In alternativa può scegliere che il messaggio di inizializzazione del nodo non venga soppresso all'avvio di Node-RED. Se preferisce che il nodo resti in silenzio finché non gli invia qualcosa, attivi «Segnala solo dopo un comando». In tal caso ignorerà le modifiche provenienti dall'app o da un interruttore e risponderà solo ai suoi comandi.
+
+### Richiedere lo stato
+
+Emette lo stato attuale della sync box non appena al nodo viene trasmesso un oggetto `msg.payload` con il seguente contenuto. In alternativa può anche premere il pulsante nell'interfaccia di Node-RED senza dover inviare prima un messaggio al nodo.
+
+: status (boolean): Restituisce lo stato attuale della sync box
+
+### Accendere / spegnere (modalità semplice)
+
+Per accendere o spegnere rapidamente la sync box, trasmetta al nodo un oggetto con il seguente contenuto. All'accensione viene ripristinata l'ultima modalità di sincronizzazione utilizzata.
+
+: payload (boolean): `true` avvia la sincronizzazione, `false` mette il dispositivo in risparmio energetico
+
+### Comandi della sync box (esteso)
+
+Trasmetta i seguenti parametri in un oggetto `msg.payload` per controllare la sync box in modo più dettagliato:
+
+: mode (string): Uno tra `powersave`, `passthrough`, `video`, `game`, `music` o `ambient`
+: sync (boolean): `true` avvia la sincronizzazione, `false` la arresta
+: toggle (boolean | any): Alterna la sincronizzazione a seconda dello stato precedente
+: passthrough (boolean): `true` passa l'immagine al suo televisore senza sincronizzare
+: intensity (string): Con quale intensità le luci seguono l'immagine. Uno tra `subtle`, `moderate`, `high` o `intense`
+: brightness (int): Valore percentuale della luminosità (0-100)
+: brightnessLevel (int): Valore numerico della luminosità come lo conta il dispositivo (0-200, dove 100 è il valore di riferimento)
+: incrementBrightness (int | boolean): Indica di quanti punti percentuali aumentare la luminosità della sync box, oppure `true` per passi del 10 %
+: decrementBrightness (int | boolean): Indica di quanti punti percentuali ridurre la luminosità della sync box, oppure `true` per passi del 10 %
+: input (string | int): L'ingresso HDMI da mostrare, da `input1` a `input4` oppure semplicemente da `1` a `4`
+: entertainmentArea (string): L'area entertainment che il dispositivo deve pilotare, ad es. `groups/13`
+
+### Messaggi di stato del nodo
+
+Ogni volta che lo stato della sync box cambia, il nodo restituisce il seguente messaggio di stato:
+
+#### Oggetto di stato in `msg.payload`
+
+: on (boolean): `false` mentre il dispositivo è in risparmio energetico
+: syncing (boolean): `true` mentre le luci seguono l'immagine
+: passthrough (boolean): `true` mentre il dispositivo passa l'immagine senza sincronizzare
+: mode (string): La modalità attualmente attiva
+: lastSyncMode (string): L'ultima modalità di sincronizzazione utilizzata
+: intensity (string | boolean): Intensità della modalità attualmente attiva
+: brightness (int | boolean): Luminosità in percentuale
+: brightnessLevel (int | boolean): Luminosità come la conta il dispositivo (0-200)
+: input (string | boolean): L'ingresso HDMI attualmente mostrato
+: inputs (object): Tutti e quattro gli ingressi HDMI con `name`, `type`, `status` (`unplugged`, `plugged`, `linked` o `unknown`) e se sono `active`
+: entertainmentArea (string | boolean): L'area entertainment pilotata dal dispositivo
+: updated (string): Momento dell'ultimo aggiornamento della risorsa da parte di HueMagic (ISO 8601)
+
+#### Informazioni sulla sync box in `msg.info`
+
+: id (string | boolean): L'ID univoco della sync box
+: name (string | boolean): Il nome attualmente assegnato alla sync box
+: type (string): Il tipo di dispositivo (sempre `syncbox`)
+: ipAddress (string | boolean): L'indirizzo IP che il dispositivo indica per sé stesso
+: softwareVersion (string | boolean): Il firmware attuale della sync box
+: apiLevel (int | boolean): Il livello API della sync box
+: ledMode (int | boolean): La modalità LED attualmente impostata
+: wifi (object | boolean): Contiene `ssid` e `strength` della connessione wireless
+: model (object): Contiene le informazioni sul modello della sync box in `id`, `manufacturer` e `name`
+
+#### Variazioni di stato in `msg.updated`
+
+Elenca sotto forma di oggetto i singoli parametri modificati rispetto all'ultimo stato della sync box. Se non è stata registrata alcuna modifica, questo oggetto è vuoto.
+
+#### Ultimo stato della sync box in `msg.lastState`
+
+Contiene l'oggetto di stato completo (vedi i valori di uscita sopra) dell'ultimo stato prima dell'ultima modifica registrata. Se HueMagic non ha ancora registrato l'ultimo stato, viene emesso `false`.
+
+#### Ultimo comando in `msg.command` (facoltativo)
+
+Se lo stato del nodo è cambiato a seguito di un determinato comando, viene emesso anche l'intero comando eseguito. In caso contrario, il nodo non emette questo oggetto.
+
+### Esempi di HueMagic
+
+HueMagic mette a disposizione alcune configurazioni di esempio per questo nodo. Per importare un esempio completo nella sua interfaccia Node-RED, faccia clic sull'icona del menu di Node-RED, selezioni «Importa» e navighi fino a «Esempi» nella barra laterale della finestra. Selezioni quindi la cartella HueMagic e il nodo desiderato per importare un flusso di esempio.
+
+![examples](hue/assets/huemagic-examples.gif)
+</script>