Integration - Xbox

Entwicklung
1

Hallo zusammen,

Ich stelle euch eine neue externe Integration vor, um eure Xbox-Konsolen (Xbox One, Xbox Series X|S) von Gladys aus zu steuern.

Was sie kann

Sie hat zwei Kanäle, die ihr einzeln oder zusammen nutzen könnt.

Lokaler Kanal (euer Netzwerk, ohne Konto):

  • findet Konsolen im Netzwerk;
  • zeigt an, ob sie eingeschaltet sind;
  • schaltet sie ein.

Cloud-Kanal (Xbox Live, mit eurem Microsoft-Konto), zusätzlich:

  • ausschalten;
  • Lautstärke und Stummschaltung;
  • Medien-Tasten und Controller-Tasten;
  • ein Spiel starten;
  • aktuelles Spiel anzeigen.

Mit beiden Kanälen wählt die Option „Lokale Verbindung bevorzugen“ den zuerst verwendeten Kanal. Ein Badge auf jeder Konsole zeigt den verwendeten Kanal an.

In Gladys

Gerät vom Typ Fernseher: Ein-/Ausschalten, Stummschaltung, Lautstärke +/-, Abspielen/Pause, Vorheriges/Nächstes, Pfeiltasten, A/B, Menü, Xbox-Taste und das aktuelle Spiel.

Szenenauslöser:

  • ein Spiel startet auf einer Xbox;
  • ein Spiel endet, mit den gespielten Minuten.

Beispiel: „Lucas hat 95 Minuten Minecraft gespielt“ per Nachricht senden.

Szenenaktionen:

  • eine Xbox einschalten und warten, bis sie antwortet;
  • ein Spiel starten;
  • eine Controller-Taste drücken.

Widget des Dashboards: Stromversorgung, aktuelles Spiel, Verbindung und Schnellzugriffstasten (Einschalten, Startseite, Abspielen/Pause, Ausschalten).

Vor dem Start

Auf der Konsole:

  1. Einstellungen → Allgemein → Stromoptionen → Schnellstart (Series) oder Sofortstart (One).
  2. Für die Cloud: Einstellungen → Geräte und Verbindungen → Fernfunktionen → aktivieren.

Für die Cloud (optional):

  1. Erstellt eine kostenlose App im Azure-Portal: https://portal.azure.com (persönliche Microsoft-Konten, Web-Plattform).
  2. Fügt ihre ID und ihr Geheimnis in die Integrationseinstellungen ein.
  3. Klickt auf Verbinden. Gladys sieht nie euer Passwort: Nur ein Refresh-Token wird gespeichert.

:warning: Microsoft erfordert eine Rückrufadresse in https. Öffnet Gladys über ihre https-Adresse (Gladys Plus oder Reverse Proxy) im Moment des Klickens auf Verbinden.

Installation

  1. Installiert die Integration Xbox aus dem Gladys-Store.
  2. Klickt auf „Verbindung testen und nach Konsolen suchen“.
  3. Erstellt eure Konsolen im Tab Erkennung.

Falls eine Konsole nicht gefunden wird (anderes Subnetz, Router filtert), gebt ihre IP-Adresse in den Einstellungen ein.

Vollständige Dokumentation:

Bekannte Einschränkungen

  • Ausschalten und die Tasten funktionieren nur über die Cloud. Lokal kann die Konsole nur eingeschaltet werden.
  • Das aktuelle Spiel stammt von eurem Xbox-Konto, nicht von der Konsole. Mit zwei eingeschalteten Konsolen zeigen beide dasselbe Spiel an.
  • Im Modus „Aus (Energiesparen)“ kann die Konsole nicht über das Netzwerk eingeschaltet werden.

Euer Feedback

Das ist eine erste Version. Sie wurde mit einer Konsole und einem simulierten Xbox Live getestet, noch nicht auf einer echten Konsole: Euer Feedback ist willkommen!

Um ein Problem zu melden, erstellt ein Issue auf Issues · prohand/gladys-xbox · GitHub und fügt hinzu:

  • euer Konsolenmodell;
  • die Versionen von Gladys und der Integration;
  • die Logs, ohne Tokens oder Adressen.

Danke! :folded_hands: