# Spotify > 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/benachrichtigungen/spotify/ _Benötigt Symcon >= 5.3_ Das Spotify-Modul ermöglicht die Verknüpfung mit einem Spotify-Premium-Konto. Darüber kann die Wiedergabe über das Konto gesteuert werden. So ist es möglich, die eine Wiedergabe zu starten oder die aktuelle Wiedergabe zu ändern bzw. zu beenden. Auch Optionen wie Wiederholung oder Zufallswiedergabe können gesetzt werden. Innerhalb des Moduls werden Favoriten gespeichert, welche dann komfortabel aus der Visualisierung abgerufen werden können. ### Funktionsumfang - Verknüpfung mit einem Spotify-Premium-Konto - Wiedergabe abspielen oder pausieren - Zu nächstem oder vorherigen Song wechseln - Gerät für Wiedergabe auswählen oder wechseln - Favoriten abspeichern und wieder aufrufen - Wiederholung oder Zufallswiedergabe aktivieren ### Voraussetzungen - Spotify-Premium-Konto ### Software-Installation - Über den [Module Store](https://www.symcon.de/de/service/dokumentation/komponenten/verwaltungskonsole/module-store/) das 'Spotify'-Modul installieren. ### Einrichten der Instanzen in IP-Symcon - Unter 'Instanz hinzufügen' kann das 'Spotify'-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: Initial muss das Modul durch einen Klick auf den Button "Registrieren" mit einem Spotify-Premium-Konto verknüpft werden. Durch den Klick öffnet sich ein Anmeldungsdialog von Spotify. Nach Eingabe der Benutzerdaten muss die Verknüpfung bestätigt werden. Danach stehen alle Funktionen des Moduls zur Verfügung. #### _Erweiterte Einstellungen_ | Name | Beschreibung | | ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Aktualisierungsintervall | In diesem Intervall werden die Werte der Statusvariablen mit der aktuellen Wiedergabe von Spotify abgeglichen. Dies beinhaltet das Gerät, Wiedergabe oder Pause, Zufallswiedergabe und Wiederholung | | Cover: Maximale Breite | Maximale Breite des dargestellten Covers | | Cover: Maximale Höhe | Maximale Höhe des dargestellten Covers | #### _Suche_ | Name | Beschreibung | | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | | Suche | In diesem Feld wird ein Suchbegriff für eine Suche eingegeben | | Suche nach Alben | Gibt an ob die nächste Suche Alben beinhalten soll | | Suche nach Künstlern | Gibt an ob die nächste Suche Künstler beinhalten soll | | Suche nach Playlists | Gibt an ob die nächste Suche Playlists beinhalten soll | | Suche nach Songs | Gibt an ob die nächste Suche Songs beinhalten soll | | Suche starten | Startet eine Suche | | Suchergebnisse | Diese Liste beinhaltet die Ergebnisse der aktuellen Suche - Durch ein Aktivieren des Feldes "Favorit" kann ein Ergbnis den Favoriten hinzugefügt werden | Die Liste "Ihre Playlists" beinhaltet die Playlists des verknüpften Spotify-Kontos. Diese können über das Feld "Favorit" den Favoriten hinzugefügt werden. Die Liste "Favoriten" beinhaltet die eingestellten Favoriten. Durch ein Klick auf das Mülleimer-Symbol können Favoriten entfernt werden. ### Statusvariablen und Profile Die Statusvariablen/Kategorien werden automatisch angelegt. Das Löschen einzelner kann zu Fehlfunktionen führen. #### Statusvariablen | Name | Typ | Beschreibung | | -------------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Aktuelles Cover | HTMLBox | Hier wird das Cover des aktuell abgespielten Albums dargestellt, sofern vorhanden | | Aktueller Song | string | Hier wird der Name des aktuell abgespielten Songs angezeigt | | Aktueller Künstler | string | Hier wird der Künstler des aktuell abgespielten Songs angezeigt | | Aktuelles Album | string | Hier wird das Album des aktuell abgespielten Songs angezeigt | | Aktion | integer | Hierüber kann eine Wiedergabe gestartet oder pausiert werden. Außerdem ist es möglich auf den vorherigen oder nächsten Song zu wechseln | | Gerät | integer | Mit dieser Variable kann ein Wiedergabegerät ausgewählt werden. Ist aktuell eine Wiedergabe aktiv, so wird diese auf das neue Gerät gewechselt | | Favorit | integer | Diese Variable stellt die im Modul konfigurierten Favoriten dar. Durch die Auswahl eines Favoriten wird dieser auf dem aktuell gewählten Gerät abgespielt | | Wiederholen | integer | Über diese Variable kann die Wiederholung aktiviert werden - "Aus": Keine Wiederholung, "Kontext": Der aktuelle Kontext, also das Album, die Playlist, ... wird wiederholt, "Song": Der aktuelle Song wird wiederholt | | Zufällige Wiedergabe | boolean | Aktiviert bzw. deaktiviert die zufällige Wiedergabe | #### Profile: | Name | Typ | | ----------------------------- | ------- | | Spotify.Favorites. | Integer | | Spotify.Devices | Integer | | Spotify.Repeat | Integer | ### Visualisierung Über die Visualisierung oder in den mobilen Apps werden Statusvariablen angezeigt und können geschaltet werden. ## SPO_MakeAPIRequest Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/benachrichtigungen/spotify/spo-makeapirequest/ `string SPO_MakeAPIRequest(int $InstanzID, string $Method, string $Url, string $Body)` _Benötigt Symcon >= 5.3_ **Parameter** - `$InstanzID` (int): ID der Instanz - `$Method` (string): Art der HTML-Anfrage - `$Url` (string): Pfad, welcher nach `https://api.spotify.com/v1 ` steht - `$Body` (string): Nachricht, welche an den Endpunkt gesendet werden soll **Rückgabewert** (string): Die Funktion gibt die Rückgabe der API als String zurück oder false bei einem Fehler. Nachricht, welche an den Endpunkt gesendet werden soll **Beispiel** ```text SPO_MakeAPIRequest(12345, 'GET', '/me', ''); ``` ## SPO_NextTrack Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/benachrichtigungen/spotify/spo-nexttrack/ `bool SPO_NextTrack(int $InstanzID)` _Benötigt Symcon >= 5.3_ **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 SPO_NextTrack(12345); ``` ## SPO_Pause Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/benachrichtigungen/spotify/spo-pause/ `bool SPO_Pause(int $InstanzID)` _Benötigt Symcon >= 5.3_ **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 SPO_Pause(12345); ``` ## SPO_Play Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/benachrichtigungen/spotify/spo-play/ `bool SPO_Play(int $InstanzID)` _Benötigt Symcon >= 5.3_ **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 SPO_Play(12345); ``` ## SPO_PlayURI Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/benachrichtigungen/spotify/spo-playuri/ `bool SPO_PlayURI(int $InstanzID, string $URI)` _Benötigt Symcon >= 5.3_ **Parameter** - `$InstanzID` (int): ID der Instanz - `$URI` (string): URI der Spotify-Resource **Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__. URI der Spotify-Resource **Beispiel** ```text SPO_PlayURI(12345, 'spotify:artist:1Lw1vZvhgNZk7hVSvdY4OA'); ``` ## SPO_PreviousTrack Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/benachrichtigungen/spotify/spo-previoustrack/ `bool SPO_PreviousTrack(int $InstanzID)` _Benötigt Symcon >= 5.3_ **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 SPO_PreviousTrack(12345); ``` ## SPO_ResetToken Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/benachrichtigungen/spotify/spo-resettoken/ `bool SPO_ResetToken(int $InstanzID)` _Benötigt Symcon >= 5.3_ **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 SPO_ResetToken(12345); ``` ## SPO_SetRepeat Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/benachrichtigungen/spotify/spo-setrepeat/ `bool SPO_SetRepeat(int $InstanzID, string $Repeat)` _Benötigt Symcon >= 5.3_ **Parameter** - `$InstanzID` (int): ID der Instanz - `$Repeat` (string) | Wert | Bedeutung | | ---- | ------------------------ | | 0 | Wiederholung deaktiviert | | 1 | Wiederholung des Kontext | | 2 | Wiederholung des Songs | **Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__. | Wert | Bedeutung | | ---- | ------------------------ | | 0 | Wiederholung deaktiviert | | 1 | Wiederholung des Kontext | | 2 | Wiederholung des Songs | **Beispiel** ```text SPO_SetRepeat(12345, 2); ``` ## SPO_SetShuffle Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/benachrichtigungen/spotify/spo-setshuffle/ `bool SPO_SetShuffle(int $InstanzID, bool $Shuffle)` _Benötigt Symcon >= 5.3_ **Parameter** - `$InstanzID` (int): ID der Instanz - `$Shuffle` (bool): De-/Aktiviert die zufällige Wiedergabe **Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__. De-/Aktiviert die zufällige Wiedergabe **Beispiel** ```text SPO_SetShuffle(12345, true); ```