# Szenensteuerung

> 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/szenensteuerung/

_Benötigt Symcon >= 5.0_

Die Szenensteuerung speichert Werte von in einer Liste gespeicherten Variablen in Szenen und kann diese via Knopfdruck aus der Visualisierung und mobilen Apps wieder aufrufen.
Die zu schaltenden Variablen müssen dazu in der Instanzkonfiguration der Liste "Variablen" hinzugefügt werden. Sind alle für eine Szene gewünschten Variablen hinzugefügt und auf den gewünschten Wert gesetzt, können diese mit dem "Speichern"-Knopf (in der Visualisierung) der entsprechenden Szene hinzugefügt werden. Nun kann die Szene mit dem entsprechenden "Ausführen"-Knopf jederzeit abgerufen werden. Die Variablen werden auf die zuvor gespeicherten Werte gesetzt.

### Funktionsumfang
- Ermöglicht das Speichern und Aufrufen von in einer Liste gespeicherten Variablen über Szenen.
- Die aktuell aktive Szene wird angezeigt
- Darstellung und Bedienung via Visualisierung und mobilen Apps
- Wenn eine Variable ausgetauscht wird, bleiben bereits erstellte Szenen erhalten und schalten das neue Gerät

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

### Einrichten der Instanzen in IP-Symcon
- Unter "Instanz hinzufügen" kann das 'Szenensteuerung'-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                                         |
| --------- | ---------------------------------------------------- |
| Szenen    | Anzahl der Szenen die zur Verfügung gestellt werden. |
| Variablen | Liste mit den zu schaltenden Variablen.              |

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

#### Statusvariablen
Die Szenen werden 1,2..n aufsteigend durchnummeriert.

| Name         | Typ     | Beschreibung                                                                                                                                                                                                             |
| ------------ | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Aktive Szene | String  | Zeigt den Namen der gerade Aktiven Szene an. Wenn die Werte der Variablen einer Szene zugeornet werden können wird diese ebenfalls angezeigt. Entsprechen die Werte der Variablen keiner Szene wird 'Unbekann' angezeigt |
| Szene 1..n   | Integer | Zur Anzeige in der Visualisierung und den mobilen Apps. Ruft "Speichern" oder "Aufrufen" auf.                                                                                                                            |

#### Profile:

| Name             | Typ     |
| ---------------- | ------- |
| SZS.SceneControl | Integer |

### Visualisierung
Über die Visualisierung können die momentanen Werte der gelisteten Zielvariablen in einer Scene gespeichert werden. Über "Ausführen" können bereits gespeicherte Szenen aufgerufen werden.

## SZS_CallScene

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/logiken/szenensteuerung/szs-callscene/

`bool SZS_CallScene(int $InstanzID, int $SceneNumber)`

_Benötigt Symcon >= 5.0_

Ruft die Szene auf und setzt sie dazugehörigen Variablen

**Parameter**

- `$InstanzID` (int): ID der Instanz
- `$SceneNumber` (int): Nummer der Szene

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

Nummer der Szene

**Beispiel**

```text
SZS_CallScene(12345, 1);
```

## SZS_GetActiveScene

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/logiken/szenensteuerung/szs-getactivescene/

`int SZS_GetActiveScene(int $InstanzID)`

_Benötigt Symcon >= 5.0_

**Parameter**

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

**Rückgabewert** (int): Nummer der aktiven Szene. Wenn eine unbekannte Szene aktiv ist wird 0 zurückgegeben.

ID der Instanz

**Beispiel**

```text
SZS_GetActiveScene(12345);
```

## SZS_SaveScene

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/logiken/szenensteuerung/szs-savescene/

`bool SZS_SaveScene(int $InstanzID, int $SceneNumber)`

_Benötigt Symcon >= 5.0_

**Parameter**

- `$InstanzID` (int): ID der Instanz
- `$SceneNumber` (int): Nummer der Szene

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

Nummer der Szene

**Beispiel**

```text
SZS_SaveScene(12345, 1);
```