Zum Hauptinhalt springen

PlayStation Network Smart-Home-Integration, kostenlos und Open Source

PlayStation Network-Integration für Gladys Assistant

Verfolge PSN-Präsenz, Spiele, Spielzeit, Trophäen und deine PS4/PS5-Konsolen.

Verfolge in Gladys, wer auf der PlayStation spielt, welches Spiel, wie lange heute, die Trophäen deines Kontos und ob deine PS4 oder PS5 an, im Ruhemodus oder aus ist.

Inoffizielle Integration, nicht mit Sony verbunden. Sony bietet keine öffentliche API: Die Integration liest dieselben Daten wie die PlayStation App.

Bevor du beginnst​

Du brauchst:

  • ein PlayStation-Network-Konto (dessen Spiele und Trophäen du verfolgen willst);
  • einen Computer mit Webbrowser, um einmal das NPSSO-Token abzurufen;
  • für die Konsolen (optional): eine PS4 oder PS5 im selben Netzwerk wie Gladys.

Dein NPSSO-Token abrufen​

Das NPSSO ist ein 64-stelliger Code, der beweist, dass du bei deinem Sony-Konto angemeldet bist. Die Integration meldet sich damit an, wie es die PlayStation App tut.

  1. Gehe im Browser auf playstation.com und melde dich mit deinem PlayStation-Network-Konto an.
  2. Öffne im selben Browser https://ca.account.sony.com/api/v1/ssocookie.
  3. Die Seite zeigt etwas wie {"npsso":"Ab12...xyz"}. Kopiere den 64-stelligen Wert zwischen den Anführungszeichen (die ganze Zeile zu kopieren geht auch: Die Integration findet den Wert).

Zeigt die Seite einen Fehler, bist du nicht angemeldet: Zurück zu Schritt 1.

Halte dieses Token geheim. Wer es besitzt, kann dein Konto nutzen. Gladys speichert es in einem geheimen Feld, und die Integration schreibt es nie auf die Festplatte oder in die Logs. Wenn du glaubst, dass es durchgesickert ist, melde in den Einstellungen deines PlayStation-Kontos alle Geräte ab und hole ein neues.

Das Token gilt etwa zwei Monate. Läuft es ab, sagt es der Konfigurationsbildschirm der Integration: Hole auf dieselbe Weise ein neues und füge es ein.

Konfiguration​

  1. Öffne den Tab Konfiguration der Integration.
  2. Füge das Token in NPSSO-Token ein.
  3. Zu verfolgende Freunde (optional): ihre Online-IDs, durch Kommas getrennt, höchstens 10. Ihre Privatsphäre-Einstellungen müssen dir ihren Online-Status zeigen.
  4. IP-Adresse der Konsole (optional): nur wenn „Meine Konsolen finden“ deine Konsole nicht findet (siehe unten).
  5. Aktualisierungsintervall: wie oft das PlayStation Network gelesen wird, standardmäßig 120 Sekunden (mindestens 60: Sony begrenzt die Anzahl der Anfragen).
  6. Zeitzone: „Heute gespielt“ beginnt um Mitternacht in dieser Zeitzone wieder bei null (standardmäßig Europe/Paris).
  7. Speichere und klicke auf Verbindung testen: Sie zeigt deine Online-ID, deinen Status, deine Trophäen und den Status jedes Freundes.
  8. Öffne den Tab Erkennung und füge die gewünschten Geräte hinzu.

Die Geräte​

Dein PSN-Konto​

Die Funktionen kommen mit ihrem englischen Namen in Gladys an (unten in Klammern): Du kannst sie beim Hinzufügen des Geräts umbenennen.

FunktionWert
Online (Online)1, wenn online an einer Konsole, sonst 0
Im Spiel (In game)1, wenn ein Spiel läuft
Aktuelles Spiel (Current game)der Name des Spiels, - wenn keines
Plattform (Platform)PS5, PS4…
Aktuelle Sitzung (Current session)Minuten seit dem Start des aktuellen Spiels
Heute gespielt (Played today)Spielminuten seit Mitternacht
Trophäenstufe (Trophy level)deine Trophäenstufe
TrophäenAnzahl der Platin-, Gold-, Silber- und Bronzetrophäen

Die Trophäen werden alle 15 Minuten und am Ende jedes Spiels gelesen.

Freunde​

Jeder verfolgte Freund ist ein Gerät mit denselben Funktionen wie dein Konto, außer den Trophäen.

Konsolen​

Jede gefundene Konsole ist ein Gerät mit einer Funktion Strom (Power): 1 wenn an, 0 im Ruhemodus oder aus.

Konsolen im lokalen Netzwerk​

Eine PS4 oder PS5 meldet im lokalen Netzwerk, ob sie an oder im Ruhemodus ist. Dafür:

  • PS5: Einstellungen → System → Energiesparen → Im Ruhemodus verfügbare Funktionen → aktiviere Mit dem Internet verbunden bleiben und Einschalten der PS5 über das Netzwerk aktivieren;
  • PS4: Einstellungen → Energiespareinstellungen → Im Ruhemodus verfügbare Funktionen festlegen → aktiviere Mit dem Internet verbunden bleiben und Einschalten des PS4-Systems über das Netzwerk aktivieren.

Klicke dann in der Konfiguration auf Meine Konsolen finden: Gladys sendet die PlayStation-Suchanfrage in dein Netzwerk und listet auf, was geantwortet hat. Öffne den Tab Erkennung, um die Konsole hinzuzufügen.

Antwortet nichts (anderes Netzwerk, Router filtert Broadcasts), gib deiner Konsole im Router eine feste IP-Adresse, trage sie unter IP-Adresse der Konsole ein und klicke erneut auf Meine Konsolen finden.

Lokal oder Cloud​

Gladys zeigt auf der Konsole ein Abzeichen lokal oder Cloud:

  • lokal: Der Status kommt von der Konsole selbst, in deinem Netzwerk;
  • Cloud: Der Status kommt von deiner PSN-Präsenz (online auf derselben Plattform = an).

Der Schalter Lokale Verbindung bevorzugen der Konfiguration wählt, was zuerst kommt. Sagt der bevorzugte Kanal nichts, wird der andere genutzt, und das Abzeichen zeigt einen orangen Punkt mit dem Grund. Ohne lokales Netzwerk lassen sich Ruhemodus und aus nicht unterscheiden, und eine von einem anderen Konto genutzte Konsole gilt als aus.

Die Integration kann eine Konsole weder einschalten noch steuern: Sie liest nur ihren Status.

Szenen​

Auslöser​

  • Ein Spiel wurde gestartet: Dein Konto oder ein verfolgter Freund hat ein Spiel gestartet. Variablen: Online-ID, Spiel, Titel-ID, Plattform.
  • Ein Spiel wurde beendet: Das Spiel endete oder ein anderes hat es ersetzt. Dieselben Variablen, plus die Sitzungsdauer in Minuten.
  • Eine Trophäe wurde verdient: Dein Konto hat neue Trophäen verdient. Filter nach Stufe (Platin, Gold, Silber, Bronze). Variablen: Stufe, Anzahl neuer Trophäen, Gesamt dieser Stufe, Trophäenstufe.

Die Gerätefunktionen funktionieren auch mit den Standardauslösern von Gladys. Beispiele:

  • wenn „Played today“ des Kontos meines Sohnes über 120 steigt, schicke mir eine Nachricht;
  • wenn „Power“ der PS5 nach 22 Uhr auf 1 geht, schalte das Licht im Wohnzimmer aus.

Aktionen​

  • Status eines Spielers abrufen: liest jetzt das PlayStation Network und gibt online, im Spiel, Spiel, Plattform, aktuelle Sitzung und heute gespielt zurück, für die folgenden Aktionen der Szene (z. B. eine Bedingung „nur wenn im Spiel“).
  • Status einer Konsole abrufen: an, Ruhemodus (standby) oder aus, jetzt gelesen.

Dashboard-Widget​

Füge das Widget PlayStation Network einem Dashboard hinzu. Es zeigt:

  • die heute gespielte Zeit und die aktuelle Sitzung, und für dein Konto die Trophäenstufe und die Anzahl der Platintrophäen;
  • wer was spielt, mit den Spielsymbolen (oder das Symbol deines Spiels, wenn du keinem Freund folgst);
  • deinen Status, Plattform und Spiel sowie den Status der Konsolen;
  • eine Schaltfläche Aktualisieren.

In den Widget-Einstellungen wählt Spieler, wessen Karte es ist (standardmäßig dein Konto).

Fehlerbehebung​

  • „Das NPSSO-Token ist abgelaufen oder falsch“: Hole ein neues (siehe oben). Das passiert auch nach einer Passwortänderung oder dem Abmelden aller Geräte.
  • „Zu viele Anfragen an das PlayStation Network“: Erhöhe das Aktualisierungsintervall.
  • Ein Freund ist „verborgen“: Seine Privatsphäre-Einstellungen zeigen dir seinen Status nicht, oder ihr seid keine Freunde mehr.
  • Ein Freund hat „kein Konto mit diesem Namen“: Prüfe die Online-ID (Buchstaben, Ziffern, - und _, 3 bis 16 Zeichen).
  • Die Konsole wird nicht gefunden: Prüfe die Energiespareinstellungen oben und dass sie eingesteckt ist (ganz ausgeschaltet antwortet sie nie).
  • „Heute gespielt“ scheint niedrig: Die Zeit wird zwischen zwei Aktualisierungen gezählt. Waren Gladys oder das PlayStation Network lange nicht erreichbar, wird für die Lücke höchstens das Doppelte des Aktualisierungsintervalls gezählt.

Konfigurationseinstellungen​

Diese Einstellungen fragt PlayStation Network in seinem Konfigurationsbildschirm in Gladys ab.

EinstellungTypPflichtfeldBeschreibung
Erste SchrittesectionNeinSony bietet keine öffentliche API: Die Integration meldet sich wie die PlayStation App mit einem NPSSO-Token an. 1) Melde dich auf playstation.com mit deinem Konto an. 2) Öffne im selben Browser den Link „Mein NPSSO abrufen“ unten. 3) Kopiere den 64-stelligen Wert von „npsso“ (oder die ganze Seite) und füge ihn unten ein. Das Token ist ein Schlüssel zu deinem Konto: Halte es geheim. Es gilt etwa zwei Monate; die Integration sagt dir, wann es erneuert werden muss.
NPSSO-TokensecretJaDer 64-stellige Wert, den die Seite „Mein NPSSO abrufen“ anzeigt.
Zu verfolgende FreundestringNeinOnline-IDs durch Kommas getrennt, höchstens 10. Jede wird ein Gerät mit Präsenz und aktuellem Spiel (die Privatsphäre-Einstellungen müssen es erlauben).
Konsolen im lokalen NetzwerksectionNeinEine PS4 oder PS5 meldet im lokalen Netzwerk, ob sie an oder im Ruhemodus ist, wenn „Mit dem Internet verbunden bleiben“ in den Energiespareinstellungen aktiv ist (PS5: auch „Einschalten der PS5 über das Netzwerk aktivieren“). Nutze „Meine Konsolen finden“ unten oder gib die IP-Adresse der Konsole ein, falls die Suche sie nicht findet. Ohne lokales Netzwerk folgt der Konsolenstatus deiner PSN-Präsenz.
IP-Adresse der Konsole (optional)stringNein
ErweitertsectionNein
Aktualisierungsintervall (s)numberNeinWie oft das PlayStation Network gelesen wird, in Sekunden (mindestens eine Minute: Sony begrenzt die Anzahl der Anfragen).
ZeitzonestringNein„Heute gespielt“ beginnt um Mitternacht in dieser Zeitzone wieder bei null.

So installierst du PlayStation Network in Gladys​

  1. Öffne in Gladys Integrationen: PlayStation Network erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
  2. Klicke auf Installieren. Gladys lädt das Docker-Image (ghcr.io/prohand/gladys-playstationnetwork:0.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/prohand/gladys-playstationnetwork.

PlayStation Network 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​

PlayStation Network 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 prohand 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 🙂