node-red-contrib-huemagic 2.8.2 → 4.0.0

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

@@ -1,151 +1,75 @@
-<script type="text/x-red" data-help-name="hue-group">
-    <p>Hue Gruppe zur Steuerung ganzer Gruppen mit Lichtern und zum Empfang von Gruppenereignissen.</p>
+<script type="text/markdown" data-help-name="hue-group">
+Der „Hue Gruppe“-Node kann mehrere Lichter hinter einer Gruppe auf der Bridge gleichzeitig steuern.
 
-    <h3>Einrichtung</h3>
-    <p>Wählen Sie die vorkonfigurierte Hue Bridge aus und klicken Sie auf die Suchschaltfläche, um alle verfügbaren vorkonfigurierten Gruppen zu finden. Geben Sie den Namen der Gruppe manuell ein oder behalten Sie den Standardnamen bei. Beachten Sie, dass Ereignisse nur gesendet werden, wenn der Gruppenstatus geändert wird. Bei Bedarf können alle Statusaktualisierungen dieses Knotens durch Aktivieren der Option "Mitteilungen ignorieren" ignoriert werden.</p>
+### Einrichtung
 
-    <h3>Ein- / Ausschalten (einfach)</h3>
-    <p>Ändert den Ein- / Aus-Status der Gruppe basierend auf den übergebenen <b>msg.payload</b>-Werten von:</p>
-    <dl class="message-properties">
-        <dt>msg.payload<span class="property-type">boolean</span></dt>
-        <dd>Schaltet alle Lichter in der Gruppe mit ihrer vorherigen Konfiguration (Farbe und Helligkeit) ein oder aus</dd>
-    </dl>
+Wählen Sie die vorkonfigurierte Hue Bridge und klicken Sie auf die Suchschaltfläche, um alle verfügbaren Gruppen zu finden. Wenn Sie die ID von einer Gruppe bereits kennen, können Sie sie auch manuell an dieser Stelle eintragen. Sie können intern entweder einen neuen Namen für die Gruppe vergeben oder den vordefinierten Namen wählen. Optional können Sie auch alle automatischen Statusmeldungen dieses Nodes deaktivieren, indem Sie die Einstellung „Ignoriere die Mitteilungen des Nodes“ anklicken. Der Node wird anschließend keine Updates mehr ausgeben. Alternativ können Sie auch auswählen, ob die Initialisierungsnachricht des Nodes beim Start von Node-RED nicht unterdrückt werden soll. Wenn Sie diese Einstellung aktivieren, erhalten Sie nach jedem Deploy eine Statusmeldung der aktuell ausgewählten Gruppe.
 
-    <h3>Ein- / Ausschalten (erweitert)</h3>
-    <p>Ändert den Gruppenstatus, den Effekt, die Farbe und die Helligkeit basierend auf den übergebenen <b>msg.payload</b>-Werten von:</p>
-    <dl class="message-properties">
-        <dt class="optional">on<span class="property-type">boolean</span></dt>
-        <dd>True, um alle Lichter in der Gruppe einzuschalten, false, um sie auszuschalten</dd>
+Wenn Sie keine Gruppe auswählen und die Node-Konfiguration so anwenden, arbeitet der Node im sogenannten „Universalmodus“. In diesem Modus empfängt der Node alle Statusmitteilungen desselben Typs und gibt diese aus. Sie können aber auch Einstellungen im Universalmodus auf eine bestimmte Gruppe anwenden, indem Sie die entsprechende Gruppen-ID als String in `msg.topic` zusammen mit Ihren Einstellungen übergeben.
 
-        <dt class="optional">brightness<span class="property-type">int</span></dt>
-        <dd>Optional konfigurierbare Helligkeit der Lichter in Prozent (0-100)</dd>
+### Status abrufen
 
-        <dt class="optional">brightnessLevel<span class="property-type">int</span></dt>
-        <dd>Optional konfigurierbare Helligkeit der Lichter (0-254)</dd>
+Gibt den aktuellen Status der Gruppe aus, sobald ein `msg.payload`-Objekt mit folgendem Inhalt an den Node übergeben wurde. Sie können alternativ auch den Button in der Node-RED-Oberfläche betätigen, ohne vorher eine Nachricht an den Node übergeben zu müssen.
 
-        <dt class="optional">incrementBrightness<span class="property-type">int</span></dt>
-        <dd>Erhöht die Helligkeit um einen bestimmten Prozentwert</dd>
+: status (boolean) : Gibt den aktuellen Status der Gruppe zurück
 
-        <dt class="optional">decrementBrightness<span class="property-type">int</span></dt>
-        <dd>Verringert die Helligkeit um einen bestimmten Prozentwert</dd>
+### Gruppe ein- / ausschalten (einfach)
 
-        <dt class="optional">ignoreOffLights<span class="property-type">boolean</span></dt>
-        <dd>Ignoriert ausgeschaltete Lichter in der Gruppe, wenn "incrementBrightness / decrementBrightness" übergeben wird</dd>
+Um eine gesamte Gruppe im einfachen Modus schnell ein- oder auszuschalten, übergeben Sie ein Objekt mit folgendem Inhalt an den Node. Bitte beachten Sie, dass der Befehl nur dann ausgeführt wird, wenn der aktuelle Status der Gruppe nicht mit Ihrem gewünschten Status übereinstimmt. Das heißt, dass alle Lichter vorher ausgeschaltet sein müssen, bevor Sie sie mit dem `true`-Befehl einschalten können.
 
-        <dt class="optional">rgb<span class="property-type">array[int,int,int]</span></dt>
-        <dd>Optional konfigurierbarer RGB-Farbwert aller Leuchten innerhalb der Gruppe. Sie müssen den RGB-Wert nicht übergeben, wenn Sie bereits einen HEX-Wert übergeben haben</dd>
+: payload (boolean) : `true` schaltet die gesamte Gruppe ein, `false` schaltet sie aus
 
-        <dt class="optional">hex<span class="property-type">string</span></dt>
-        <dd>Optional konfigurierbarer HEX-Farbwert aller Leuchten innerhalb der Gruppe. Sie müssen den HEX-Wert nicht übergeben, wenn Sie bereits einen RGB-Wert übergeben haben</dd>
+### Gruppensteuerung (erweitert)
 
-        <dt class="optional">color<span class="property-type">string</span></dt>
-        <dd>Optional konfigurierbarer, von Menschen lesbarer Farbname in Englisch wie "red" oder "random" für eine zufällige Farbe</dd>
+Neben dem einfachen Ein- und Ausschalten, stehen Ihnen auch viele weitere Optionen zur Steuerung der Gruppe zur Verfügung. Alle Nodes in HueMagic können mit additiven Befehlen gesteuert werden. Das heißt, dass Sie zunächst eine Einstellung übergeben können und in einem späteren Befehl eine weitere Einstellung, ohne, dass die vorherige Einstellung damit verworfen wird. Übergeben Sie folgende Parameter in ein `msg.payload`-Objekt, um umfangreichere Einstellungen an der Gruppe vorzunehmen:
 
-        <dt class="optional">image<span class="property-type">string</span></dt>
-        <dd>Optional konfigurierbarer Bildpfad (Internet oder lokal), um der Gruppe die dominanteste Farbe zuzuweisen</dd>
+: on (boolean) : `true` schaltet die gesamte Gruppe ein, `false` schaltet sie aus (bitte Hinweis oben beachten)
+: toggle (boolean | any) : Wechselt zwischen Ein- und Ausschalten, je nachdem, wie der vorherige Zustand der Gruppe war
+: brightness (int | string) : Prozentualer Wert der Lichthelligkeit (0-100) oder ein String mit dem Wert `auto`, um die Lichthelligkeit automatisch auf Basis der aktuellen Uhrzeit einzustellen
+: brightnessLevel (int) : Nummerischer Wert der Lichthelligkeit (0-254)
+: color (string) : `random`, um eine zufällige Farbe einzustellen oder einen englischen Farbnamen (z. B. `red`)
+: hex (string) : Farbwert in Hexadezimal in Form eines Strings
+: rgb (array[0,0,0]) : Farbwert im RGB-Format in Form eines Arrays
+: xyColor (object{x[float], y[float]}) : Farbwert im XY-Farbformat in Form eines Objekts
+: image (string) : Pfad eines Bildes (lokal oder im Web), um die aktuelle Farbe der Gruppe auf die Durschschnittsfarbe des Bildes einzustellen
+: colorTemp (int | string) : Wert zwischen 153 und 500, um die Farbtemperatur der Gruppe einzustellen oder die Werte `cold`, `normal`, `warm`, `hot` und `auto` – wobei `auto` die Farbtemperatur auf Basis der aktuellen Uhrzeit ausmacht
+: transitionTime (float) : Übergangszeit der aktuellen Einstellung in Sekunden. Wenn `0` eingegeben wird, wechselt die Gruppe in die gewünschte Einstellung sofort. Wenn `3` eingegeben wird, wechselt die Gruppe mit einem leichten Übergang in den nächsten 3 Sekunden auf die gewünschte Einstellung
+: colorloop (float) : Spielt eine „colorloop“-Animation für die gewählte Dauer in Sekunden ab und wechselt anschließend wieder zurück auf den ursprünglichen Zustand der Gruppe
+: alert (float) : Spielt eine „alert“-Animation für die gewählte Dauer in Sekunden ab und wechselt anschließend wieder zurück auf den ursprünglichen Zustand der Gruppe
 
-        <dt class="optional">transitionTime<span class="property-type">float</span></dt>
-        <dd>Optional konfigurierbarer temporärer Wert, der den Übergang eines Effekts definiert (Wert in Sekunden, 0 für sofort, 5 für fünf Sekunden)</dd>
+### Statusnachrichten des Nodes
 
-        <dt class="optional">colorloop<span class="property-type">float / boolean</span></dt>
-        <dd>Optional konfigurierbarer Farbschleifeneffekt. Float = deaktiviert den Effekt nach x Sekunden oder Boolean um den Effekt zu aktivieren / deaktivieren</dd>
+Wenn eine Änderung in der Gruppe festgestellt wurde, wird folgende Statusnachricht vom Node zurückgegeben. Bitte beachten Sie, dass die Gruppe nur dann Statusmeldungen ausgibt, wenn entweder das letzte Licht ausgeschaltet wird oder wenn das erste Licht eingeschaltet wird (wenn alle vorher ausgeschaltet waren).
 
-        <dt class="optional">colorTemp<span class="property-type">int</span></dt>
-        <dd>Optional konfigurierbare Farbtemperatur der Gruppenlichter von 153 bis 500</dd>
+Anders als beim „Hue Licht“-Node, stehen Ihnen hier viel weniger Statusinformationen zur Verfügung, da eine Gruppe viele unterschiedliche Gerätetypen mit unterschiedlichen Werten beinhalten kann, die nicht zusammengefasst werden können.
 
-        <dt class="optional">incrementColorTemp<span class="property-type">int</span></dt>
-        <dd>Erhöht / verringert die Farbtemperatur um einen bestimmten Wert</dd>
+#### Statusobjekt unter `msg.payload`
 
-        <dt class="optional">saturation<span class="property-type">int</span></dt>
-        <dd>Optional konfigurierbare Farbsättigung der Gruppe in Prozent (von 0 bis 100)</dd>
+: on (boolean) : Zustand der Gruppe, wobei `true` für an steht und `false` für aus
+: updated (string) : Zeitpunkt der letzten Aktualisierung der Ressource von HueMagic (ISO 8601)
 
-        <dt class="optional">status<span class="property-type">any</span></dt>
-        <dd>Gibt den aktuellen Status des Nodes zurück, ohne eine Aktion durchzuführen</dd>
-    </dl>
+#### Informationen der Gruppe unter `msg.info`
 
-    <h3>Ein- / Ausschalten (automatisch)</h3>
-    <p>Schaltet die Lichter abhängig vom aktuellen Status basierend auf dem übergebenen Wert von <b>msg.payload</b> ein oder aus:</p>
-    <dl class="message-properties">
-        <dt>toggle<span class="property-type">any</span></dt>
-        <dd>Schaltet alle Lichter in der Gruppe mit ihrer vorherigen Konfiguration (Farbe und Helligkeit) ein oder aus</dd>
-    </dl>
+: id (string) : Gibt die neue ID der Gruppe an
+: idV1 (string | boolean) : Gibt die alte ID der Gruppe an
+: name (string) : Der aktuell eingestellte Name des Gruppe
+: type (string) : Der Typ des Gruppe (immer `group`)
 
-    <h3>Alarmeffekt</h3>
-    <p>Spielt einen Alarmeffekt basierend auf den übergebenen <b>msg.payload</b>-Werten von:</p>
-    <dl class="message-properties">
-        <dt>alert<span class="property-type">int</span></dt>
-        <dd>Konfigurierbare Anzahl von Sekunden, um den Alarmeffekt abzuspielen (max. 30)</dd>
+#### Zustandsänderungen unter `msg.updated`
 
-        <dt class="optional">rgb<span class="property-type">array[int,int,int]</span></dt>
-        <dd>Optional konfigurierbarer RGB-Farbwert des Alarmeffekt. Sie müssen den RGB-Wert nicht übergeben, wenn Sie bereits einen HEX-Wert übergeben haben</dd>
+Listet einzelne Parameter in Form eines Objekts auf, die sich im Vergleich zum letzten Zustand der Gruppe geändert haben. Wenn keine Änderungen registriert wurden, ist dieses Objekt leer.
 
-        <dt class="optional">hex<span class="property-type">string</span></dt>
-        <dd>Optional konfigurierbarer HEX-Farbwert des Alert-Effekts. Sie müssen den HEX-Wert nicht übergeben, wenn Sie bereits einen RGB-Wert übergeben haben</dd>
+#### Letzter Stand des Lichts unter `msg.lastState`
 
-        <dt class="optional">color<span class="property-type">string</span></dt>
-        <dd>Optional konfigurierbarer, von Menschen lesbarer Farbname in Englisch wie "red" oder "random" für eine zufällige Farbe</dd>
-    </dl>
+Beinhaltet das komplette Statusobjekt (siehe Ausgabewerte oben) des letzten Zustands vor der letzten Änderung. Wenn der letzte Zustand von HueMagic noch nicht registriert wurde, wird `false` ausgegeben.
 
-    <h3>Gruppen-Ereignisse</h3>
-    <p>Die von der Gruppe gesendete Ereignismeldung enthält die folgenden Daten im Objekt <b>msg.payload</b>:</p>
-    <dl class="message-properties">
-        <dt>on<span class="property-type">boolean</span></dt>
-        <dd>True für an, false, für aus</dd>
+#### Letzter Befehl unter `msg.command` (optional)
 
-        <dt>allOn<span class="property-type">boolean</span></dt>
-        <dd>True wenn alle Lichter in der Gruppe an sind, false wenn alle aus sind</dd>
+Sofern der Status des Nodes sich über einen bestimmten Befehl geändert hat, wird der gesamte Befehl der ausgeführt wurde mit ausgegeben. Andernfalls wird dieses Objekt vom Node nicht ausgegeben.
 
-        <dt>anyOn<span class="property-type">boolean</span></dt>
-        <dd>True wenn manche Lichter in der Gruppe an sind, false wenn alle aus sind</dd>
+### Beispiele von HueMagic
 
-        <dt>brightness<span class="property-type">int</span></dt>
-        <dd>Aktuelle Helligkeit aller Lichter in der gesamten Gruppe in Prozent</dd>
+HueMagic stellt einige Beispielkonfigurationen zu diesem Node zur Verfügung. Um ein fertiges Beispiel in Ihrer Node-RED-Oberfläche zu importieren, klicken Sie auf das Menü-Icon von Node-RED, wählen Sie dann „Import“ und navigieren Sie in der Sidebar des Popups auf „Beispiele“. Wählen Sie anschließend den HueMagic-Ordner aus und Ihren gewünschten Node, um einen Beispielflow zu importieren.
 
-        <dt>brightnessLevel<span class="property-type">int</span></dt>
-        <dd>Aktuelle Helligkeit aller Lichter in der gesamten Gruppe (0-254)</dd>
-
-        <dt class="optional">rgb<span class="property-type">array[int,int,int]</span></dt>
-        <dd>Aktueller RGB-Farbwert aller Lichter in der Gruppe (falls unterstützt)</dd>
-
-        <dt class="optional">hex<span class="property-type">string</span></dt>
-        <dd>Aktueller HEX-Farbwert aller Lichter in der Gruppe (falls unterstützt)</dd>
-
-        <dt class="optional">color<span class="property-type">string</span></dt>
-        <dd>Aktueller Farbname aller Lichter in der Gruppe (falls unterstützt)</dd>
-
-        <dt class="optional">colorTemp<span class="property-type">int</span></dt>
-        <dd>Aktuelle Farbtemperatur aller Lichter der Gruppe im Durchschnitt (falls unterstützt)</dd>
-
-        <dt>updated<span class="property-type">ISO 8601 date string</span></dt>
-        <dd>ISO 8601 Datum der letzten Aktualisierung des Gruppenstatus</dd>
-    </dl>
-
-    <h3>Zusätzliche Gruppeninformationen</h3>
-    <p>Zusätzliche Informationen zu der Gruppe werden an das Objekt <b>msg.info</b> gesendet:</p>
-    <dl class="message-properties">
-        <dt>id<span class="property-type">int</span></dt>
-        <dd>Gruppen-ID, die automatisch von der Bridge generiert wird</dd>
-
-        <dt>lightIds<span class="property-type">array[int…]</span></dt>
-        <dd>Ein Array von Lichter-IDs, die der Gruppe zugeordnet sind</dd>
-
-        <dt>name<span class="property-type">string</span></dt>
-        <dd>Name der Gruppe</dd>
-
-        <dt>type<span class="property-type">string</span></dt>
-        <dd>Gruppentyp (z.B. LightGroup, Luminaire, LightSource, Room)</dd>
-
-        <dt class="optional">model<span class="property-type">object</span></dt>
-        <dd>Huejay (die API hinter HueMagic) führt eine Liste der von Philips Hue unterstützten Leuchtenmodelle. Das Group Model-Attribut gibt optional ein GroupModel-Objekt zurück. Dieses Objekt enthält weitere Informationen zum Modell, z.B. model.id, model.manufacturer, model.name, model.type, model.colorGamut und model.friendsOfHue</dd>
-    </dl>
-
-    <h3>Universalmodus (optional)</h3>
-    <p>Definiert die Gruppen-ID auf der Hue Bridge manuell, wenn sie nicht in den Node-Eigenschaften konfiguriert ist (deaktiviert Gruppenaktualisierungsmitteilungen):</p>
-    <dl class="message-properties">
-        <dt>msg.topic<span class="property-type">int</span></dt>
-        <dd>Manuelle Definition der Gruppen-ID</dd>
-    </dl>
-
-    <h3>Letzte Zustandsinformationen</h3>
-    <p>Dieser Node schickt auch die gesamten letzten Zustandsinformationen (vor dem Update) in das <b>msg.lastState</b>-Objekt. Dieses kann entweder false (Boolean) or die Objekte payload (msg.lastState.payload) und info (msg.lastState.info) beinhalten. Der Rückgabewert "false" wird nur dann gesendet, wenn es keinen letzten Zustand gab oder der Node neu erstellt oder gestartet wurde.</p>
+![examples](https://user-images.githubusercontent.com/5302050/148681840-2275c15a-7c0c-4a37-b817-199608e571d2.gif)
 </script>

package/huemagic/locales/de/hue-group.json

@@ -5,8 +5,8 @@
 		{
 			"name": "Name",
 			"input-name": "Name der Gruppe",
-			"skipevents": "Mitteilungen ignorieren",
 			"skipevents-node": "Ignoriere die Mitteilungen des Nodes",
+			"sendinitevents-node": "Initialisierungsnachricht nicht unterdrücken",
 			"searching": "Suche nach Gruppen…",
 			"none-found": "Keine Gruppen gefunden!",
 			"unknown-error": "Etwas ist schief gelaufen. Bitte versuchen Sie es erneut.",
@@ -31,7 +31,9 @@
 			"error-invalid-sat": "Ungültige Sättigungseinstellung. Erlaubt sind Werte zwischen 0 - 254.",
 			"error-invalid-temp": "Ungültige Farbtemperatur. Erlaubt sind Werte zwischen 153 - 500.",
 			"input": "Ein- / Ausschalten",
-			"output": "Status"
+			"output": "Status",
+			"command": "führt Befehl aus…",
+			"statusmsg": "Status erfolgreich abgefragt…"
 		}
 	}
 }

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

@@ -1,145 +1,97 @@
-<script type="text/x-red" data-help-name="hue-light">
-    <p>Hue Licht zum Steuern der Lichter und Empfangen von Glühbirnenereignissen.</p>
+<script type="text/markdown" data-help-name="hue-light">
+Der „Hue Licht“-Node kann mit der Bridge verbundene Lichter steuern und ihre Statusmitteilungen empfangen.
 
-    <h3>Einrichtung</h3>
-    <p>Wählen Sie die vorkonfigurierte Hue Bridge und klicken Sie auf die Suchschaltfläche, um alle verfügbaren Lichter zu finden. Geben Sie den Namen des Lichts manuell ein oder behalten Sie den Standardgerätenamen bei. Beachten Sie, dass Ereignisse nur gesendet werden, wenn sich der Status der Glühbirne ändert. Bei Bedarf können alle Statusaktualisierungen dieses Nodes durch Aktivieren der Option "Mitteilungen ignorieren" ignoriert werden.</p>
+### Einrichtung
 
-    <h3>Ein- / Ausschalten (einfach)</h3>
-    <p>Ändert den Licht-Ein / Aus-Status basierend auf den übergebenen <b>msg.payload</b>-Werten von:</p>
-    <dl class="message-properties">
-        <dt>msg.payload<span class="property-type">boolean</span></dt>
-        <dd>Schaltet das Licht mit der vorherigen Konfiguration (Farbe und Helligkeit) ein oder aus</dd>
-    </dl>
+Wählen Sie die vorkonfigurierte Hue Bridge und klicken Sie auf die Suchschaltfläche, um alle verfügbaren Lichter zu finden. Wenn Sie die ID von einem Licht bereits kennen, können Sie sie auch manuell an dieser Stelle eintragen. Sie können intern entweder einen neuen Namen für das Licht vergeben oder den vordefinierten Namen wählen. Optional können Sie auch alle automatischen Statusmeldungen dieses Nodes deaktivieren, indem Sie die Einstellung „Ignoriere die Mitteilungen des Nodes“ anklicken. Der Node wird anschließend keine Geräteupdates mehr ausgeben. Alternativ können Sie auch auswählen, ob die Initialisierungsnachricht des Nodes beim Start von Node-RED nicht unterdrückt werden soll. Wenn Sie diese Einstellung aktivieren, erhalten Sie nach jedem Deploy eine Statusmeldung des aktuell ausgewählten Lichts.
 
-    <h3>Ein- / Ausschalten (erweitert)</h3>
-    <p>Ändert den Lichtzustand, den Effekt, die Farbe und die Helligkeit basierend auf den übergebenen <b>msg.payload</b>-Werten von:</p>
-    <dl class="message-properties">
-        <dt class="optional">on<span class="property-type">boolean</span></dt>
-        <dd>True, um die Glühbirne einzuschalten, false, um sie auszuschalten</dd>
+Wenn Sie die Einstellung „Aktiviere Farbnamen“ aktivieren, wird der Node bei jeder Statusmeldung versuchen, die aktuell eingerichtete Lichtfarbe zu beschreiben. Sie erhalten dann also einen zusätzlichen Parameter mit der englischen Beschreibung der aktuell eingestellten Farbe in der Ausgabe.
 
-        <dt class="optional">brightness<span class="property-type">int</span></dt>
-        <dd>Optional konfigurierbare Helligkeit des Lichts in Prozent (0-100)</dd>
+Wenn Sie kein Licht auswählen und die Node-Konfiguration so anwenden, arbeitet der Node im sogenannten „Universalmodus“. In diesem Modus empfängt der Node alle Statusmitteilungen desselben Typs und gibt diese aus. Sie können aber auch Einstellungen im Universalmodus auf ein bestimmtes Licht anwenden, indem Sie die entsprechende Licht-ID als String in `msg.topic` zusammen mit Ihren Einstellungen übergeben.
 
-        <dt class="optional">brightnessLevel<span class="property-type">int</span></dt>
-        <dd>Optional konfigurierbare Helligkeitsstufe des Lichts (0-254)</dd>
+### Status abrufen
 
-        <dt class="optional">incrementBrightness<span class="property-type">int</span></dt>
-        <dd>Erhöht die Helligkeit um einen bestimmten Prozentwert</dd>
+Gibt den aktuellen Status des Lichts aus, sobald ein `msg.payload`-Objekt mit folgendem Inhalt an den Node übergeben wurde. Sie können alternativ auch den Button in der Node-RED-Oberfläche betätigen, ohne vorher eine Nachricht an den Node übergeben zu müssen.
 
-        <dt class="optional">decrementBrightness<span class="property-type">int</span></dt>
-        <dd>Verringert die Helligkeit um einen bestimmten Prozentwert</dd>
+: status (boolean) : Gibt den aktuellen Status des Lichts zurück
 
-        <dt class="optional">rgb<span class="property-type">array[int,int,int]</span></dt>
-        <dd>Optional konfigurierbarer RGB-Farbwert der Glühlampe. Sie müssen den RGB-Wert nicht übergeben, wenn Sie bereits einen HEX-Wert übergeben haben</dd>
+### Licht ein- / ausschalten (einfach)
 
-        <dt class="optional">hex<span class="property-type">string</span></dt>
-        <dd>Optional konfigurierbarer HEX-Farbwert der Glühlampe. Sie müssen den HEX-Wert nicht übergeben, wenn Sie bereits einen RGB-Wert übergeben haben</dd>
+Um ein Licht im einfachen Modus schnell ein- oder auszuschalten, übergeben Sie ein Objekt mit folgendem Inhalt an den Node:
 
-        <dt class="optional">color<span class="property-type">string</span></dt>
-        <dd>Optional konfigurierbarer, von Menschen lesbarer Farbname in Englisch wie "red" oder "random" für eine zufällige Farbe</dd>
+: payload (boolean) : `true` schaltet das Licht ein, `false` schaltet es aus
 
-        <dt class="optional">image<span class="property-type">string</span></dt>
-        <dd>Optional konfigurierbarer Bildpfad (Internet oder lokal), um die dominanteste Farbe auf das Licht anzuwenden</dd>
+### Lichtsteuerung (erweitert)
 
-        <dt class="optional">transitionTime<span class="property-type">float</span></dt>
-        <dd>Optional konfigurierbarer temporärer Wert, der den Übergang eines Effekts definiert (Wert in Sekunden, 0 für sofort, 5 für fünf Sekunden)</dd>
+Neben dem einfachen Ein- und Ausschalten, stehen Ihnen auch viele weitere Optionen zur Steuerung des Lichts zur Verfügung. Alle Nodes in HueMagic können mit additiven Befehlen gesteuert werden. Das heißt, dass Sie zunächst eine Einstellung übergeben können und in einem späteren Befehl eine weitere Einstellung, ohne, dass die vorherige Einstellung damit verworfen wird. Übergeben Sie folgende Parameter in ein `msg.payload`-Objekt, um umfangreichere Einstellungen am Licht vorzunehmen:
 
-        <dt class="optional">colorloop<span class="property-type">float / boolean</span></dt>
-        <dd>Optional konfigurierbarer Farbschleifeneffekt. Float = deaktiviert den Effekt nach x Sekunden oder Boolean um den Effekt zu aktivieren / deaktivieren</dd>
+: on (boolean) : `true` schaltet das Licht ein, `false` schaltet es aus
+: toggle (boolean | any) : Wechselt zwischen Ain- und Ausschalten, je nachdem, wie der vorherige Zustand der Lichts war
+: brightness (int | string) : Prozentualer Wert der Lichthelligkeit (0-100) oder ein String mit dem Wert `auto`, um die Helligkeit automatisch auf Basis der aktuellen Uhrzeit einzustellen
+: brightnessLevel (int) : Nummerischer Wert der Lichthelligkeit (0-254)
+: incrementBrightness (int | boolean) : Gibt an, um wie viel Prozent das Licht heller gemacht werden soll oder `true`, um das Licht in 10%-Schritten heller zu machen
+: decrementBrightness (int | boolean) : Gibt an, um wie viel Prozent das Licht dunkler gemacht werden soll oder `true`, um das Licht in 10%-Schritten dunkler zu machen
+: color (string) : `random`, um eine zufällige Farbe einzustellen oder einen englischen Farbnamen (z. B. `red`)
+: hex (string) : Farbwert in Hexadezimal in Form eines Strings
+: rgb (array[0,0,0]) : Farbwert im RGB-Format in Form eines Arrays
+: xyColor (object{x[float], y[float]}) : Farbwert im XY-Farbformat in Form eines Objekts
+: gradient (object{hex[…]}) : Ein Objekt mit einem unterstützem Farbobjekt (z. B. `hex`, `rgb`, …) und mehreren Farben, um einen Gradienten auf unterstützte Lichter einzustellen
+: mixColor (object) : Eine Farbe, die mit der aktuellen Lichtfarbe gemischt werden soll. Kann `color`, `hex`, `rgb` oder `xyColor` Objekte annehmen und optional `amount` (int), um das Mischverhältnis in Prozent anzugeben
+: image (string) : Pfad eines Bildes (lokal oder im Web) um die aktuelle Farbe des Lichts auf die Durschschnittsfarbe des Bildes einzustellen
+: saturation (int) : Prozentualer Wert der Sättigung der aktuellen Farbe (beta)
+: colorTemp (int | string) : Wert zwischen 153 und 500, um die Farbtemperatur des Lichts einzustellen oder die Werte `cold`, `normal`, `warm`, `hot` und `auto` – wobei `auto` die Farbtemperatur auf Basis der aktuellen Uhrzeit ausmacht
+: incrementColorTemp (int | boolean) : Wert um wie viel die Farbtemperatur wärmer werden soll oder `true`, um in 50er-Schritten die Farbtemperatur wärmer zu machen
+: decrementColorTemp (int | boolean) : Wert um wie viel die Farbtemperatur kälter werden soll oder `true`, um in 50er-Schritten die Farbtemperatur kälter zu machen
+: transitionTime (float) : Übergangszeit der aktuellen Einstellung in Sekunden. Wenn 0 eingegeben wird, wechselt das Licht in die gewünschte Einstellung sofort. Wenn 3 eingegeben wird, wechselt das Licht mit einem leichten Übergang in den nächsten 3 Sekunden auf die gewünschte Einstellung
+: colorloop (float) : Spielt eine „colorloop“-Animation für die gewählte Dauer in Sekunden ab und wechselt anschließend wieder zurück auf den ursprünglichen Zustand des Lichts
+: alert (float) : Spielt eine „alert“-Animation für die gewählte Dauer in Sekunden ab und wechselt anschließend wieder zurück auf den ursprünglichen Zustand des Lichts
 
-        <dt class="optional">colorTemp<span class="property-type">int</span></dt>
-        <dd>Optional konfigurierbare Farbtemperatur der Leuchte von 153 bis 500</dd>
+### Statusnachrichten des Nodes
 
-        <dt class="optional">incrementColorTemp<span class="property-type">int</span></dt>
-        <dd>Erhöht / verringert die Farbtemperatur um einen bestimmten Wert</dd>
+Sobald eine Änderung an den Lichteinstellungen festgestellt wurde (egal ob über Node-RED oder extern), wird folgende Statusnachricht vom Node zurückgegeben:
 
-        <dt class="optional">saturation<span class="property-type">int</span></dt>
-        <dd>Optional konfigurierbare Farbsättigung des Lichts in Prozent (von 0 bis 100)</dd>
+#### Statusobjekt unter `msg.payload`
 
-        <dt class="optional">status<span class="property-type">any</span></dt>
-        <dd>Gibt den aktuellen Status des Nodes zurück, ohne eine Aktion durchzuführen</dd>
-    </dl>
+: on (boolean) : Zustand des Lichts, wobei `true` für an steht und `false` für aus
+: brightness (int | boolean) : Aktuelle Helligkeit in Prozent oder `false`, wenn das Licht keine Helligkeitseinstellung unterstützt
+: brightnessLevel (int | boolean) : Aktuelle Helligkeit von 0-254 oder `false`, wenn das Licht keine Helligkeitseinstellung unterstützt
+: reachable (boolean | string) : `true` wenn das Licht mit der Bridge verbunden ist, `unknown` wenn der Verbindungsstatus abweicht
+: connectionStatus (string) : Der aktuelle Verbindugsstatus mit der Bridge in Form eines Strings. Kann `connected`, `disconnected`, `connectivity_issue` oder `unidirectional_incoming` als Wert beinhalten
+: rgb (array[int,int,int] | optional) : Aktuelle Lichtfarbe in Form eines RGB-Wertes, wenn das Licht Farben darstellen kann
+: hex (string | optional) : Aktuelle Lichtfarbe in Form eines Hexadezimal-Wertes, wenn das Licht Farben darstellen kann
+: xyColor (object{x[float], y[float]} | optional) : Aktuelle Lichtfarbe in Form eines XY-Wertes, wenn das Licht Farben darstellen kann
+: color (string | optional) : Aktueller Lichtname auf Englisch, wenn das Licht Farben darstellen kann und die entsprechende Einstellung des Nodes aktiviert wurde
+: gradient (object | optional) : Aktuelle Gradienteneinstellung mit allen verfügbaren Farbeinheiten in Form eines Arrays, wenn das Licht Gradienteneinstellungen unterstützt, wobei `colors` die Farben ausgibt, `numColors` die Anzahl der eingestellten Farben im Gradienten und `totalColors` die maximal mögliche Anzahl der Farben, die die Ressource im Gradienten unterstützen kann
+: colorTemp (int | boolean | optional) : Aktuelle Farbtemperatur des Lichts, wenn das Licht Farbtemperaturen darstellen kann und eine Farbtemperatur eingestellt wurde
+: colorTempName (string | optional) : Aktuelle Farbtemperatur des Lichts in Form eines beschreibenden Strings mit den Werten `cold`, `normal`, `warm` oder `hot`, wenn das Licht Farbtemperaturen darstellen kann und eine Farbtemperatur eingestellt wurde. Andernfalls wird `unknown` ausgegeben
+: updated (string) : Zeitpunkt der letzten Aktualisierung der Ressource von HueMagic (ISO 8601)
 
-    <h3>Ein- / Ausschalten (automatisch)</h3>
-    <p>Schaltet das Licht abhängig vom aktuellen Status basierend auf dem übergebenen <b>msg.payload</b>-Wert von ein oder aus:</p>
-    <dl class="message-properties">
-        <dt>toggle<span class="property-type">any</span></dt>
-        <dd>Schaltet das Licht mit der vorherigen Konfiguration ein oder aus (Farbe und Helligkeit)</dd>
-    </dl>
+#### Informationen des Lichts unter `msg.info`
 
-    <h3>Alert Effect</h3>
-    <p>Spielt einen Alarmeffekt basierend auf den übergebenen <b>msg.payload</b>-Werten von:</p>
-    <dl class="message-properties">
-        <dt>alert<span class="property-type">int</span></dt>
-        <dd>Konfigurierbare Anzahl von Sekunden, um den Alarmeffekt abzuspielen (max. 30)</dd>
+: id (string) : Gibt die neue ID des Lichts an
+: idV1 (string | boolean) : Gibt die alte ID des Lichts an
+: uniqueId (string) : Die eindeutige ID des Lichts
+: deviceId (string) : Die eindeutige ID des Geräts
+: name (string) : Der aktuell eingestellte Name des Lichts
+: type (string) : Der Typ des Lichts (immer `light`)
+: softwareVersion (string) : Die aktuelle Firmware des Lichts
+: model (object) : Beinhaltet die Modellinformationen des Lichts unter `id`, `manufacturer`, `name`, `type`, `certified`, `friendsOfHue`, `colorGamut` und `colorGamutType`
 
-        <dt class="optional">rgb<span class="property-type">array[int,int,int]</span></dt>
-        <dd>Optional konfigurierbarer RGB-Farbwert des Alarmeffekt. Sie müssen den RGB-Wert nicht übergeben, wenn Sie bereits einen HEX-Wert übergeben haben</dd>
+#### Zustandsänderungen unter `msg.updated`
 
-        <dt class="optional">hex<span class="property-type">string</span></dt>
-        <dd>Optional konfigurierbarer HEX-Farbwert des Alert-Effekts. Sie müssen den HEX-Wert nicht übergeben, wenn Sie bereits einen RGB-Wert übergeben haben</dd>
+Listet einzelne Parameter in Form eines Objekts auf, die sich im Vergleich zum letzten Zustand des Lichts geändert haben. Wenn keine Änderungen registriert wurden, ist dieses Objekt leer.
 
-        <dt class="optional">color<span class="property-type">string</span></dt>
-        <dd>Optional konfigurierbarer, von Menschen lesbarer Farbname in Englisch wie "red" oder "random" für eine zufällige Farbe</dd>
-    </dl>
+#### Letzter Stand des Lichts unter `msg.lastState`
 
-    <h3>Licht-Ereignisse</h3>
-    <p>Die vom Licht gesendete Ereignismeldung enthält die folgenden Daten im Objekt <b>msg.payload</b>:</p>
-    <dl class="message-properties">
-        <dt>on<span class="property-type">boolean</span></dt>
-        <dd>True für an, false, für aus</dd>
+Beinhaltet das komplette Statusobjekt (siehe Ausgabewerte oben) des letzten Zustands vor der letzten Änderung. Wenn der letzte Zustand von HueMagic noch nicht registriert wurde, wird `false` ausgegeben.
 
-        <dt>brightness<span class="property-type">int</span></dt>
-        <dd>Aktuelle Helligkeit der Glühbirne in Prozent</dd>
+#### Letzter Befehl unter `msg.command` (optional)
 
-        <dt>brightnessLevel<span class="property-type">int</span></dt>
-        <dd>Aktuelle Helligkeit der Glühbirne (0-254)</dd>
+Sofern der Status des Nodes sich über einen bestimmten Befehl geändert hat, wird der gesamte Befehl der ausgeführt wurde mit ausgegeben. Andernfalls wird dieses Objekt vom Node nicht ausgegeben.
 
-        <dt class="optional">rgb<span class="property-type">array[int,int,int]</span></dt>
-        <dd>Aktueller RGB-Farbwert der Glühbirne (falls unterstützt)</dd>
+### Beispiele von HueMagic
 
-        <dt class="optional">hex<span class="property-type">string</span></dt>
-        <dd>Aktueller HEX-Farbwert der Glühbirne (falls unterstützt)</dd>
+HueMagic stellt einige Beispielkonfigurationen zu diesem Node zur Verfügung. Um ein fertiges Beispiel in Ihrer Node-RED-Oberfläche zu importieren, klicken Sie auf das Menü-Icon von Node-RED, wählen Sie dann „Import“ und navigieren Sie in der Sidebar des Popups auf „Beispiele“. Wählen Sie anschließend den HueMagic-Ordner aus und Ihren gewünschten Node, um einen Beispielflow zu importieren.
 
-        <dt class="optional">color<span class="property-type">string</span></dt>
-        <dd>Aktueller Farbname der Glühbirne (falls unterstützt)</dd>
-
-        <dt class="optional">colorTemp<span class="property-type">int</span></dt>
-        <dd>Aktuelle Farbtemperatur der Glühbirne (falls unterstützt)</dd>
-
-        <dt>updated<span class="property-type">ISO 8601 date string</span></dt>
-        <dd>ISO 8601 Datum der letzten Aktualisierung des Status</dd>
-    </dl>
-
-    <h3>Zusätzliche Glühbirneninformationen</h3>
-    <p>Zusätzliche Informationen zur Glühbirne werden an das Objekt <b>msg.info</b> gesendet:</p>
-    <dl class="message-properties">
-        <dt>id<span class="property-type">int</span></dt>
-        <dd>Numerische ID der auf der Bridge registrierten Glühbirne</dd>
-
-        <dt>uniqueId<span class="property-type">string</span></dt>
-        <dd>Eindeutige ID der Glühbirne (normalerweise Hardware-ID)</dd>
-
-        <dt>name<span class="property-type">string</span></dt>
-        <dd>Name der Glühbirne</dd>
-
-        <dt>type<span class="property-type">string</span></dt>
-        <dd>Glühbirnen-Typ (z.B. Extended Color Light, Dimmable Light)</dd>
-
-        <dt>softwareVersion<span class="property-type">float</span></dt>
-        <dd>Softwareversion der Glühbirne</dd>
-
-        <dt>model<span class="property-type">object</span></dt>
-        <dd>Das Modellobjekt der Glühbirne enthält modellspezifische Informationen wie model.id, model.manufacturer, model.name, model.type, model.colorGamut und model.friendsOfHue</dd>
-    </dl>
-
-    <h3>Universalmodus (optional)</h3>
-    <p>Definiert die Glühbirnen-ID auf der Hue Bridge manuell, wenn sie nicht in den Node-Eigenschaften konfiguriert ist (deaktiviert Lichtaktualisierungsereignisse):</p>
-    <dl class="message-properties">
-        <dt>msg.topic<span class="property-type">int</span></dt>
-        <dd>Manuelle Definition der Glühbirnen-ID</dd>
-    </dl>
-
-    <h3>Letzte Zustandsinformationen</h3>
-    <p>Dieser Node schickt auch die gesamten letzten Zustandsinformationen (vor dem Update) in das <b>msg.lastState</b>-Objekt. Dieses kann entweder false (Boolean) or die Objekte payload (msg.lastState.payload) und info (msg.lastState.info) beinhalten. Der Rückgabewert "false" wird nur dann gesendet, wenn es keinen letzten Zustand gab oder der Node neu erstellt oder gestartet wurde.</p>
+![examples](https://user-images.githubusercontent.com/5302050/148681840-2275c15a-7c0c-4a37-b817-199608e571d2.gif)
 </script>

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

@@ -5,8 +5,8 @@
 		{
 			"name": "Name",
 			"input-name": "Name des Lichts",
-			"skipevents": "Mitteilungen ignorieren",
 			"skipevents-node": "Ignoriere die Mitteilungen des Nodes",
+			"sendinitevents-node": "Initialisierungsnachricht nicht unterdrücken",
 			"searching": "Suche nach Lichtern…",
 			"none-found": "Keine Lichter gefunden!",
 			"unknown-error": "Etwas ist schief gelaufen. Bitte versuchen Sie es erneut.",
@@ -26,8 +26,11 @@
 			"turned-off": "ausgeschaltet",
 			"error-no-id": "Keine Licht-ID definiert.",
 			"error-input": "Eingabefehler",
+			"error-invalid-temp": "Ungültige Farbtemperatur. Erlaubt sind Werte zwischen 153 - 500.",
 			"input": "Ein- / Ausschalten",
-			"output": "Status"
+			"output": "Status",
+			"command": "führt Befehl aus…",
+			"statusmsg": "Status erfolgreich abgefragt…"
 		}
 	}
 }

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

@@ -1,60 +1,68 @@
-<script type="text/x-red" data-help-name="hue-magic">
-    <p>Hue Magic Node für Animationen</p>
-
-    <h3>Einrichtung</h3>
-    <p>Wählen Sie aus, ob die Animation auf unbestimmte Zeit wiederholt werden soll und / oder ob der vorherige Zustand wiederhergestellt werden soll, nachdem die Animation beendet / gestoppt wurde. Wählen Sie eine der mitgelieferten Animationen aus und verbinden Sie den Knoten mit einer Gruppe oder einem Licht.</p>
-
-    <h3>Starten / Stoppen</h3>
-    <p>Startet oder stoppt eine Animation basierend auf den übergebenen <b>msg.payload</b>-Werten von:</p>
-    <dl class="message-properties">
-        <dt>true<span class="property-type">boolean</span></dt>
-        <dd>Startet die Animation</dd>
-
-        <dt>false<span class="property-type">boolean</span></dt>
-        <dd>Stoppt die Animation</dd>
-    </dl>
-
-    <h3>Eigene Animationen</h3>
-    <p>Alternativ können Sie eigene Animationen erstellen und anwenden. Dazu erstellen Sie ein Array und übergeben es mit den folgenden Parametern an <b>msg.payload.steps</b>.</p>
-    <dl class="message-properties">
-        <dt>delay<span class="property-type">int</span></dt>
-        <dd>Führe diesen Frame nach der Verzögerung aus (in Millisekunden)</dd>
-
-        <dt>animation<span class="property-type">object</span></dt>
-        <dd>Fügen Sie hier alle Parameter ein, die animiert werden sollen. Unterstützt alle Werte des Nodes "Hue Licht" und "Hue Gruppe".</dd>
-    </dl>
-
-    <h3>Spezielle Kommandos</h3>
-    <p>Manchmal ist es sinnvoll, Animationen ungeordnet abzuspielen. Zum Beispiel, um Feuer realistischer zu imitieren. Dazu erstellen Sie ein Objekt und übergeben es mit den folgenden Parametern an <b>msg.payload.specials</b>.</p>
-    <dl class="message-properties">
-        <dt>randomOrder<span class="property-type">boolean</span></dt>
-        <dd>Führt die Schritte in zufälliger Reihenfolge aus</dd>
-    </dl>
-
-    <h4>Beispiel (eigene Animation)</h4>
-<code>
-<pre>
-{
-    "animate": true,
-    "steps": [
-        {
-            "delay": 500,
-            "animation": {
-                "hex": "#FF0000",
-                "transitionTime": 1
-            }
-        },
-        {
-            "delay": 500,
-            "animation": {
-                "hex": "#0000FF",
-                "transitionTime": 1
+<script type="text/markdown" data-help-name="hue-magic">
+Der „Hue Magic“-Node kann komplexe und benutzerdefinierte Animationen auf Lichtern und Gruppen anwenden.
+
+### Einrichtung
+
+Vergeben Sie zunächst dem Node einen Namen, um Ihre Animation in der Node-RED-Oberfläche klar einzuordnen. Anschließend haben Sie die Wahl zwischen den Optionen „Wiederholen“ und „Wiederherstellen“. Wählen Sie die Option „Wiederholen“, wenn Sie Ihre Animation auf einem Licht oder einer Gruppe endlos abspielen möchten, bis Sie sie manuell stoppen. Wenn Sie den vorherigen Zustand der Zielressource (Licht / Gruppe) nach Beendigung der Animation wiederherstellen möchten, setzen Sie den Haken auf „Wiederherstellen“. Andernfalls bleibt der letzte Frame der Animation auf der jeweiligen Ressource stehen.
+
+Weiter unten haben Sie die Wahl aus vorgefertigten Animationen von HueMagic. Klicken Sie Ihre gewünschte Animation an, um Sie einzustellen.
+
+### Animation starten / stoppen
+
+Um eine Animation abzuspielen oder zu stoppen, übergeben Sie ein Objekt mit folgenden Inhalt an den Node:
+
+: payload (boolean) : `true`, startet die Animation, `false`, stoppt die Animation
+
+### Eigene Animationen
+
+Wenn Sie dem Node eine eigene Animation übergeben, wird die vorausgewählte, vorgefertigte Animation (wenn eingestellt) vorübergehend durch Ihre ersetzt. Eigene HueMagic-Animationen sind eine Folge von Befehlen, die in einem Array zusammengefasst wurden. Jedes Array-Element bildet einen Schritt – wobei ein Schritt auch aus mehreren Frames bestehen kann (Übergangseffekte).
+
+Erstellen Sie ein `Array` mit den jeweiligen Animationsschritten in Form eines Objekts und übergeben Sie es unter `msg.payload.steps` an den HueMagic-Node.
+
+: delay (int) : Anzahl der Millisekunden die gewartet werden soll, bis dieser Schritt ausgeführt wird
+: animation (object) : Das Objekt beinhaltet die Aktion(en), die in diesem Schritt durchgeführt werden sollen. Identische Parameter wie bei den „Hue Licht“- & „Hue Gruppe“-Nodes
+
+### Beispiel einer eigenen Animation
+
+Dieses Beispiel zeigt, wie eine einfache Animation aussehen könnte. Im ersten Schritt wird der Delay von 500 Millisekunden abgewartet. Anschließend wird über eine Zeitspanne von einer Sekunde langsam die Farbe des Lichts auf rot umgestellt. Sobald das Licht vollständig zu rot übergegangen ist, wird der zweite Schritt ausgeführt, der auch einen Delay von 500 Millisekunden hat. Abschließend wechselt die Farbe zu blau.
+
+Wenn Sie eingestellt haben, dass die Animation unendlich abgespielt werden soll, wird dieser Prozess endlos wiederholt, bis Sie die Animation manuell stoppen oder den Node neu deployen.
+
+Übergeben Sie das folgende Objekt in `msg.payload` um die Beispielanimation abzuspielen.
+
+    {
+        "animate": true,
+        "steps": [
+            {
+                "delay": 500,
+                "animation": {
+                    "hex": "#FF0000",
+                    "transitionTime": 1
+                }
+            },
+            {
+                "delay": 500,
+                "animation": {
+                    "hex": "#0000FF",
+                    "transitionTime": 1
+                }
             }
-        }
-    ]
-}</pre>
-</code>
+        ]
+    }
+
+### Spezielle Kommandos
+
+Manchmal macht es Sinn eine Animation ungeordnet abzuspielen – z. B. wenn Feuer realistischer imitiert werden soll. Um die einzelnen Schritte ungeordnet und zufällig abzuspielen, können Sie folgenden Befehl an `msg.payload.specials` übergeben:
+
+: randomOrder (boolean | any) : `true`, aktiviert die zufällige Wiedergabe der einzelnen Animationsschritte
+
+### Tipps und Hinweise
+
+Dieser Node gibt keine Statusnachrichten aus. Bitte verbinden Sie den Ausgangspunkt des Nodes mit einer Gruppe statt einzelnen Lichtern, wenn Sie mehrere Lichter gleichzeitig mit derselben Animation animieren möchten. Die Vorschauen der vorgefertigten Animationen sind eine Simulation und können von der tatsächlichen Animation auf einer Ressource geringfügig (Timing, Farben) abweichen.
+
+### Beispiele von HueMagic
+
+HueMagic stellt einige Beispielkonfigurationen zu diesem Node zur Verfügung. Um ein fertiges Beispiel in Ihrer Node-RED-Oberfläche zu importieren, klicken Sie auf das Menü-Icon von Node-RED, wählen Sie dann „Import“ und navigieren Sie in der Sidebar des Popups auf „Beispiele“. Wählen Sie anschließend den HueMagic-Ordner aus und Ihren gewünschten Node, um einen Beispielflow zu importieren.
 
-    <h3>Tipps und Hinweise</h3>
-    <p>Verbinden Sie den Hue Magic Node mit nur einem Licht- oder einem gesamten Gruppen-Node, um API-Requests auf der Hue Bridge zu sparen. Die Animationsvorschau kann geringfügig vom tatsächlichen Ergebnis auf einer Lampe / Gruppe abweichen.</p>
+![examples](https://user-images.githubusercontent.com/5302050/148681840-2275c15a-7c0c-4a37-b817-199608e571d2.gif)
 </script>