Zum Hauptinhalt springen

Sony Audio Smart-Home-Integration, kostenlos und Open Source

Sony Audio-Integration für Gladys Assistant

Sony-Soundbars, Receiver und Lautsprecher: Ein/Aus, Lautstärke, Quelle, Klang, live und lokal.

Auf GitHub ansehenAlle Integrationen

Steuere deine Sony-Soundbars, AV-Receiver und WLAN-Lautsprecher aus Gladys, in deinem lokalen Netzwerk: Ein/Aus, Lautstärke, Stummschaltung, Quelle, Klangmodus, Nachtmodus, Sprachverbesserung und Subwoofer-Pegel, in Echtzeit aktualisiert.

Ohne die Hardware entwickelt: Rückmeldungen sind willkommen. Schreib, was funktioniert und was nicht, auf github.com/guim31/gladys-songpal/issues, mit dem Modell deines Geräts.

Diese Integration ist weder mit Sony verbunden noch von Sony unterstützt.

Überblick​

Die Integration spricht mit den Geräten, die mit der App Sony Music Center (früher SongPal) funktionieren, über ihre lokale Audio-Control-API: Soundbars (HT-A7000, HT-A5000, HT-ST5000, HT-ZF9, HT-XF9000, HT-NT5…), AV-Receiver (STR-DN1080, STR-AN1000, STR-AZ…), WLAN-Lautsprecher (SRS-X77, SRS-X99, SRS-ZR7…). Kein Konto, keine Cloud: Alles bleibt in deinem Netzwerk.

  • Gefunden über die Suche im Tab Erkennung (keine Adresse einzugeben).
  • Ein Gladys-Gerät pro Produkt, nur mit den Funktionen, die es hat.
  • Echtzeit-Aktualisierung: Eine Änderung per Fernbedienung, Fernseher oder Sony-App erscheint in weniger als einer Sekunde in Gladys.
  • Zwei Dashboard-Widgets, ein Szenen-Auslöser und zwei Szenen-Aktionen.

Sony-Bravia-Fernseher nutzen dieselbe API, bleiben aber der Integration Sony Bravia TV überlassen.

Voraussetzungen​

  • Gladys 5.1.0 oder neuer.
  • Das Gerät mit deinem Netzwerk verbunden (WLAN oder Ethernet), einmal mit der App Sony Music Center eingerichtet.
  • Netzwerk-Standby an („Netzwerk-Standby“, „Schnellstart“ oder „Fernstart“, je nach Modell): Ohne ihn verlässt das Gerät im Standby das Netzwerk, und Gladys kann es weder einschalten noch sehen.
  • Gladys und das Gerät im selben Netzwerk: Die Suche nutzt SSDP (UPnP), von Gladys weitergeleitet. Zwischen Subnetzen gib die Adresse des Geräts in der Konfiguration ein.

Installation und Konfiguration​

  1. Öffne in Gladys Integrationen → Von GitHub installieren und installiere https://github.com/guim31/gladys-songpal (oder installiere Sony Audio aus dem Store).
  2. Schalte dein Gerät ein (nicht im Standby), damit es seine Quellen und Klangeinstellungen nennt.
  3. Öffne den Tab Erkennung der Integration und starte eine Suche. Jedes gefundene Gerät erscheint mit seinen Funktionen: Füge es zu Gladys hinzu.
  4. Optional, unter Konfiguration:
    • Adressen (optional): nur für ein Gerät, das die Suche nicht findet, seine IP-Adresse (mehrere durch Kommas getrennt, z. B. 192.168.1.30, 192.168.1.31). Lege sie in deinem Router fest.
    • Leseintervall: wie oft ein Gerät gelesen wird, wenn es seine Änderungen nicht senden kann (standardmäßig 30 Sekunden).
    • Lautstärkeschritt des Widgets: um wie viel die Tasten Leiser und Lauter die Lautstärke ändern.
    • Sprache der Funktionsnamen: die Namen der Funktionen eines neuen Geräts und die Sprache der Meldungen (standardmäßig Französisch).
  5. Verbindung testen liest jedes bekannte Gerät und meldet, was es findet: an oder im Standby, Quelle, Lautstärke und ob die Live-Aktualisierung funktioniert.

Geräte und Funktionen​

Jedes Produkt ist ein Gerät, erkannt an seiner MAC-Adresse (eine neue IP-Adresse von deinem Router behält dasselbe Gerät: Starte die Suche erneut, es wird unter seiner neuen Adresse gefunden). Nur die Funktionen, die das Gerät hat, werden angelegt:

FunktionGladys-TypWas sie tut
Ein / StandbySchalterEin / Standby.
LautstärkeMusiklautstärkeDie Lautstärke, in den Einheiten des Geräts (oft 0 bis 50, 0 bis 74 bei einem Receiver).
StummSchalterStummschaltung an / aus.
QuelleListeDie Eingänge des Geräts (HDMI, TV, optisch, analog, Bluetooth…), mit den dort eingestellten Namen. „Andere (Netzwerk, App)“, solange Spotify, Chromecast oder USB läuft.
KlangmodusListeDie Klangfelder des Geräts (Standard, Film, Musik…) oder die Equalizer-Voreinstellungen eines Lautsprechers.
NachtmodusSchalterDer Nachtmodus einer Soundbar.
SprachverbesserungSchalter oder ListeAn/aus, oder die Stufen (Type 1, 2, 3) älterer Soundbars.
Subwoofer-PegelDimmerDer Pegel des Subwoofers, in den Grenzen des Geräts (in Schritten von 0,5 dB bei einem Receiver).
Wiedergabe, Pause, Zurück, WeiterMusiktastenNur bei einer Netzwerk- oder USB-Quelle: Ein Eingang (HDMI, TV) spielt, was sein Gerät sendet.
WiedergabestatusMusik-WiedergabestatusWiedergabe oder Pause, für die Musik-Box des Dashboards.

Eine Quelle zu wählen, während das Gerät im Standby ist, schaltet es zuerst ein. Ein Receiver wird in seiner Hauptzone gesteuert.

Widgets​

  • Sony-Audio-Fernbedienung: das Gerät und sein Zustand, seine Quelle, sein Klangmodus und seine Lautstärke, mit vier Tasten: Einschalten (oder Standby), Leiser, Lauter und Stumm (ihr Symbol ist ein Haken, solange stummgeschaltet).
  • Sony-Audio-Quellen: vier Lieblingsquellen mit einem Tipp, das Gerät wird bei Bedarf eingeschaltet. Gib ihre Namen in den Widget-Einstellungen ein (z. B. TV, HDMI 1, Bluetooth); leer: die ersten verbundenen Eingänge. Die genutzte Quelle hat einen Haken.

Wähle das Gerät in den Einstellungen jedes Widgets (sonst das erste).

Szenen-Auslöser​

Sony Audio: Quelle geändert: Der genutzte Eingang hat sich geändert, egal wodurch: der Fernseher über HDMI (das Einschalten des Fernsehers schaltet die Soundbar oft auf ihn um), eine Konsole, die Fernbedienung, die Sony-App oder Gladys. Das Einschalten zählt, wenn das Gerät auf einer anderen Quelle als der letzten landet.

  • Filter: das Gerät und die neue Quelle, genau wie in der Quellenliste des Geräts geschrieben (z. B. HDMI 1; leer: jede Quelle).
  • Variablen: der Name des Geräts, die neue Quelle, die vorherige Quelle.

Szenen-Aktionen​

  • Sony Audio: Quelle wählen: nach ihrem Namen, wie das Gerät ihn zeigt (TV, HDMI 1, Bluetooth; Groß-/Kleinschreibung und Leerzeichen egal). Schaltet das Gerät vorher ein, falls nötig. Gibt die gewählte Quelle zurück.
  • Sony Audio: Klang einstellen: in einem Schritt der Klangmodus nach seinem Namen (Movie, Music), Nachtmodus und Sprachverbesserung (an, aus oder unverändert) und die Lautstärke. Schaltet das Gerät vorher ein, falls nötig. Gibt den Klangmodus und die Lautstärke zurück.

Szenen-Beispiele​

  • Filmabend: Wenn die Szene „Film“ startet, Sony Audio: Quelle wählen TV, dann Sony Audio: Klang einstellen mit Movie, Sprachverbesserung an und Lautstärke 18; dimme das Licht.
  • Ruhe in der Nacht: jeden Tag um 22 Uhr, wenn die Soundbar an ist, den Nachtmodus einschalten und den Subwoofer-Pegel senken.
  • Konsolenzeit: Mit Sony Audio: Quelle geändert, gefiltert auf HDMI 2, schalte die Lampe am TV-Möbel ein und sende die Nachricht „Die Konsole ist an“.

Fehlerbehebung​

  • Die Suche findet nichts: Prüfe, ob das Gerät im selben Netzwerk wie Gladys ist, mit Netzwerk-Standby an, und ob es in der App Sony Music Center erscheint. Dein Router blockiert vielleicht Multicast zwischen WLAN und Ethernet: Gib die Adresse unter Adressen (optional) ein.
  • „antwortet nicht (ausgesteckt, oder Netzwerk-Standby aus)“: Das Gerät hat das Netzwerk verlassen. Aktiviere den Netzwerk-Standby in seinen Einstellungen. Sein Gladys-Gerät bleibt, Ein / Standby zeigt aus, bis es antwortet.
  • Keine Live-Aktualisierung (der Test meldet „keine Live-Aktualisierung“): Das Gerät nimmt die WebSocket-Verbindung nicht an; es wird stattdessen im Leseintervall gelesen. Nichts zu ändern.
  • Eine Quelle oder ein Klangmodus fehlt: Die Listen sind die, die das Gerät im eingeschalteten Zustand nennt. Schalte es ein und starte die Suche erneut: Die Listen eines hinzugefügten Geräts werden aktualisiert, ohne es anzufassen.
  • Eine Funktion erscheint nach einem Update: Ein im Standby hinzugefügtes Gerät hatte noch keine Klangeinstellungen; der Tab Erkennung schlägt vor, es zu aktualisieren.
  • Protokolle: Die Integration schreibt wenig (Start, verlorene und wiedergefundene Geräte, Aktionen des Benutzers). Für mehr Details setze LOG_LEVEL=debug für die Integration.

Grenzen​

  • Ohne die Hardware entwickelt: nach der Referenz der Sony-Audio-Control-API und den Open-Source-Projekten gebaut, die sie nutzen. Manche Modelle benennen ihre Einstellungen vielleicht anders.
  • Das Gerät muss im Standby im Netzwerk bleiben, damit Gladys es einschalten kann (kein Wake-on-LAN).
  • Nur die Hauptzone eines Receivers; keine Multiroom-Gruppen, keine Favoriten, kein Durchsuchen der Netzwerkdienste, keine Equalizer-Bänder.
  • Wiedergabe und Pause hängen von der Quelle ab: Ein HDMI- oder TV-Eingang lässt sich nicht von der Soundbar aus pausieren.
  • Das Gerät wird höchstens alle 10 Sekunden gelesen, wenn es nicht melden kann, sonst alle 5 Minuten; die API ist lokal, ohne Kontingent.
  • Bravia-Fernseher bleiben der Integration Sony Bravia TV überlassen.

Konfigurationseinstellungen​

Diese Einstellungen fragt Sony Audio in seinem Konfigurationsbildschirm in Gladys ab.

EinstellungTypPflichtfeldBeschreibung
Deine Sony-AudiogerätesectionNeinSoundbars, Receiver und Lautsprecher, die mit der App Sony Music Center (früher SongPal) funktionieren. Verbinde sie mit deinem Netzwerk, aktiviere den Netzwerk-Standby („Netzwerk-Standby“ oder „Schnellstart“), damit Gladys sie einschalten kann, und suche dann im Tab Erkennung dieser Integration.
Adressen (optional)stringNeinNur für ein Gerät, das die Suche nicht findet: seine IP-Adresse, mehrere durch Kommas getrennt. Lege sie in deinem Router fest.
OptionensectionNeinDie Geräte senden ihre Änderungen sofort. Wenn sie das nicht können, werden sie in diesem Abstand gelesen.
LeseintervallselectNein
Lautstärkeschritt des WidgetsselectNeinUm wie viel die Tasten Leiser und Lauter die Lautstärke ändern.
Sprache der FunktionsnamenselectNeinFür die Namen der Funktionen eines neuen Geräts und die Meldungen der Integration.

So installierst du Sony Audio in Gladys​

  1. Öffne in Gladys Integrationen: Sony Audio erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
  2. Klicke auf Installieren. Gladys lädt das Docker-Image (ghcr.io/guim31/gladys-songpal:1.0.1) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration).
  3. Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
  4. Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/guim31/gladys-songpal.

Sony Audio benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.

Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.

Über externe Integrationen​

Sony Audio ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von guim31 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.

Abonniere den Newsletter von Gladys Assistant

Ein paar E-Mails im Monat zu neuen Releases und Neuigkeiten aus dem Projekt. Verschickt von Pierre-Gilles Leymarie, dem Gründer des Projekts. Jederzeit abbestellbar 🙂
Zuletzt aktualisiert am