# Zufällige Beleuchtung

> Symcon Dokumentation · Deutsch · erzeugt am 2026-09-26  
> Index: https://www.symcon.de/de/llms.txt

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/logiken/zufaellige-beleuchtung/

_Benötigt Symcon >= 5.0_

Das Modul ermöglicht es den Farbwert von Lampen zufällig zwischen verschiedenen Farben zu schalten.

### Funktionsumfang
- Farbvariablen können in einer Liste hinzugefügt werden
- Eine Liste mit Farben aus denen gewählt wird, welche erweitert werden kann
- Wenn das Modul deaktiviert wird, werden die ausgewählten Farbvariablen auf den Wert vor der Aktivierung gesetzt
- Einstellung des Intervalls in dem die Farben gewechselt werden sollen

### Software-Installation
- Über den [Module Store](https://www.symcon.de/de/service/dokumentation/komponenten/verwaltungskonsole/module-store/) das 'Zufällige Beleuchtung'-Modul installieren.

### Einrichten der Instanzen in IP-Symcon
- Unter 'Instanz hinzufügen' kann das 'Zufällige Beleuchtung'-Modul mithilfe des Schnellfilters gefunden werden.
  - Weitere Informationen zum Hinzufügen von Instanzen in der [Dokumentation der Instanzen](https://www.symcon.de/service/dokumentation/konzepte/instanzen/#Instanz_hinzuf%C3%BCgen)

#### Konfigurationsseite:

| Name                    | Beschreibung                                                                               |
| ----------------------- | ------------------------------------------------------------------------------------------ |
| Farbvariablen           | Liste mit Farbvariablen, welche geschaltet werden sollen                                   |
| Farben                  | Farben von denen eine zufällig zum Schalten ausgewählt wird                                |
| Änderungsintervall      | Abstand zwischen den einzelenen Schaltungen in Sekunden                                    |
| Gleichzeitiges Schalten | Legt fest ob alle Farbvariablen auf die gleiche Farbe gesetzt werden oder auf verschiedene |

### Statusvariablen
Die Statusvariablen/Kategorien werden automatisch angelegt. Das Löschen einzelner kann zu Fehlfunktionen führen.

#### Statusvariablen

| Name  | Typ     | Beschreibung                   |
| ----- | ------- | ------------------------------ |
| Aktiv | Boolean | Schaltet das Modul an oder aus |

## ZB_ChangeLight

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/logiken/zufaellige-beleuchtung/zb-changelight/

`bool ZB_ChangeLight(int $InstanzID)`

_Benötigt Symcon >= 5.0_

**Parameter**

- `$InstanzID` (int): ID der Instanz

**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.

ID der Instanz

**Beispiel**

```text
ZB_ChangeLight(12345);
```