Epic Games Store Smart-Home-Integration, kostenlos und Open Source
Die wöchentlichen Gratisspiele des Epic Games Store: Titel, Daten, Cover und ein Auslöser.
Veröffentlicht von guim31
- Geräte
- Version 1.0.1
- Erfordert Gladys >=5.1.0
- ★ 0
Jede Woche verschenkt der Epic Games Store ein oder mehrere PC-Spiele, die du nach dem Abholen für immer behältst. Diese Integration verfolgt diese Angebote in Gladys: die aktuellen Gratisspiele und ihr Ende, die nächsten und ihr Beginn, ein Widget mit den Covern und ein Szenen-Auslöser, damit du sofort erfährst, wenn ein neues Spiel verfügbar ist.
Die Integration ist schreibgeschützt: Statt die Spiele für dich abzuholen, sagt sie dir, wann du sie holen kannst.
Inoffizielle Integration, keine Verbindung zu Epic Games. Epic Games Store ist eine Marke von Epic Games, Inc.
Ohne Zugriff auf die echte API entwickelt: Gebaut wurde sie mit aufgezeichneten Antworten des Stores (denen aus den Tests der Home-Assistant-Integration). Rückmeldungen sind willkommen.
Voraussetzungen
- Gladys Assistant 5.1.0 oder neuer (Widgets und Szenen-Auslöser).
- Internetzugang für Gladys. Kein Epic-Konto, kein API-Schlüssel.
Konfiguration
- Installiere die Integration aus dem Katalog (oder Integrationen → Von GitHub installieren).
- Im Tab Konfiguration:
- Sprache: die Sprache der Gerätetexte, der Szenenvariablen sowie der Titel und Links des Stores (standardmäßig Französisch);
- Land: der Code aus zwei Buchstaben deiner Store-Region (standardmäßig
FR,DE,AT,CH…). Die Gratisspiele können je nach Land abweichen.
- Speichere, öffne dann den Tab Entdecken und füge das Gerät Epic Games Store hinzu.
Die Schaltfläche Jetzt aktualisieren liest den Store sofort und zeigt unter der Schaltfläche die aktuellen und die nächsten Gratisspiele: praktisch, um das gewählte Land zu prüfen.
Das Gerät
Ein einziges Gerät, Epic Games Store, schreibgeschützt:
| Funktion | Inhalt |
|---|---|
| Gratisspiele | Die Titel der aktuell kostenlosen Spiele, getrennt durch „·“ |
| Gratis bis | Das Ende des Angebots (das früheste, wenn es mehrere gibt) |
| Gratisspiele jetzt | Anzahl dieser Spiele |
| Nächste Gratisspiele | Die Titel der nächsten angekündigten Spiele |
| Nächste Gratisspiele ab | Der Beginn des nächsten Angebots |
| Kommende Gratisspiele | Anzahl dieser Spiele |
Die Daten werden in der Zeitzone von Gladys geschrieben, zum Beispiel „Do., 22. Okt., 17:00“. Ohne Spiel lauten die Titel „Keins“ und die Daten „—“.
Bei Sonderaktionen (Weihnachten, Mega Sale) kündigt Epic Mystery-Spiele an: Bis Epic sie enthüllt, erscheinen sie als „Mystery-Spiel“.
Gladys legt die Namen der Funktionen beim Hinzufügen des Geräts fest, in der damals gewählten Sprache. Wechselst du danach die Sprache, werden die Werte übersetzt, nicht die Namen.
Das Widget
Füge dem Dashboard das Widget Epic-Gratisspiele hinzu:
- eine Zusammenfassung („2 jetzt gratis · 2 kommen“);
- die Gratisspiele, dann die nächsten, mit Cover, einem Badge Gratis oder Bald und dem Datum (das Ende bei einem Gratisspiel, der Beginn bei einem kommenden);
- beim Antippen eines Spiels: das Datum, der Publisher, der normale Preis, die Beschreibung und der Link zum Store;
- eine Schaltfläche Alle Gratisspiele zur Seite des Stores.
Einstellung Anzeige: Cover-Raster (Standard) oder Liste. Das Widget ist in der Sprache der Person geschrieben, die es ansieht; die Cover werden von der Integration heruntergeladen und verkleinert, dein Browser kontaktiert Epic nie.
Der Szenen-Auslöser
Neues Gratisspiel verfügbar löst einmal pro Spiel aus, wenn es gratis wird (donnerstags gegen 17 Uhr Pariser Zeit und während der Weihnachtsaktion jeden Tag). Er stellt der Szene bereit:
| Variable | Beispiel |
|---|---|
| Spieltitel | Filament |
| Gratis bis (Datum und Uhrzeit) | Do., 10. Nov., 17:00 |
| Gratis bis (ISO 8601) | 2022-11-10T16:00:00.000Z |
| Link zum Store | https://store.epicgames.com/de/p/filament-332a92 |
| Publisher | Kasedo Games Ltd |
| Normaler Preis | 16,99 € |
Gut zu wissen:
- beim allerersten Lesen werden die bereits kostenlosen Spiele nicht angekündigt (wer die Integration an einem Samstag installiert, bekommt das seit Donnerstag verschenkte Spiel nicht angekündigt);
- ein Mystery-Spiel wird angekündigt, sobald es enthüllt ist, unter seinem echten Titel;
- die bereits angekündigten Spiele werden in
/datagespeichert: Ein Neustart oder ein Update kündigt sie nie ein zweites Mal an; - ein Wechsel des Landes fängt von vorn an: Die im neuen Land bereits kostenlosen Spiele werden nicht angekündigt.
Die Integration hat keine Szenen-Aktion: Die Werte des Geräts reichen für eine Bedingung.
Beispiele für Szenen
- Benachrichtigung: Auslöser „Neues Gratisspiel verfügbar“, dann die Aktion „Nachricht senden“: „🎮 Spieltitel ist gratis bis Gratis bis (Datum und Uhrzeit): Link zum Store“, wobei du jede Variable über die Auswahl des Editors einfügst.
- Erinnerung vor dem Ende: jeden Mittwoch um 19 Uhr, wenn Gratisspiele jetzt größer als 0 ist, „Letzter Tag, um die Epic-Gratisspiele abzuholen!“ senden.
- Sprachansage: Auslöser „Neues Gratisspiel verfügbar“, Bedingung „zwischen 9 und 22 Uhr“, dann den Spieltitel über den Lautsprecher ansagen lassen.
Fehlerbehebung
- „Der Epic Games Store antwortet nicht“ im Tab Konfiguration: Gladys erreicht den Store nicht (Internet, DNS, Firewall). Die Integration versucht es nach 5, 15, 30 und dann 60 Minuten erneut und behält so lange die zuletzt bekannten Spiele.
- „Der Epic Games Store kennt dieses Land nicht“: Der Store kennt den Ländercode nicht. Nutze
einen ISO-Code aus zwei Buchstaben (
DE,AT,CH,FR…). - Die Werte erscheinen nicht: Das Gerät muss im Tab Entdecken hinzugefügt worden sein; die Werte werden gleich danach gesendet.
- Der Auslöser hat nicht ausgelöst: Er löst nur für ein Spiel aus, das gratis wird, während die Integration läuft (siehe oben).
- Mehr Details: Setze die Umgebungsvariable
LOG_LEVEL=debugund sieh dir die Protokolle der Integration an. Normalerweise schreibt sie nur beim Start, bei jedem neuen Spiel und bei Problemen.
Einschränkungen
- Die Integration liest die öffentliche Adresse, die die Seite „Gratisspiele“ des Stores selbst nutzt
(
store-site-backend-static.ak.epicgames.com/freeGamesPromotions). Epic dokumentiert sie nicht und kann sie ohne Vorwarnung ändern. - Gelesen wird sie 6- bis 8-mal am Tag: alle 6 Stunden, dann 2 und 30 Minuten nach jedem Wechsel des Angebots. Epic veröffentlicht für diese über ein CDN ausgelieferte Adresse kein Kontingent; dieser Rhythmus bleibt der eines Besuchers.
- Nur Gratisspiele werden verfolgt, keine Rabatte.
- Der Store sagt nicht, ob du ein Spiel schon abgeholt hast: Dafür braucht es ein Epic-Konto, und die Integration nutzt keins.
- Die in der mobilen App des Epic Games Store verschenkten Spiele sind nicht abgedeckt.
Konfigurationseinstellungen
Diese Einstellungen fragt Epic Games Store in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Kein Konto nötig | section | Nein | Die Integration liest die öffentliche Liste der Gratisspiele des Epic Games Store, ein paarmal am Tag und direkt nach jedem Wechsel (donnerstags, 17 Uhr Pariser Zeit). Füge das Gerät im Tab „Entdecken“ hinzu. Keine Verbindung zu Epic Games. |
| Sprache | select | Ja | Sprache der Gerätetexte, der Szenenvariablen sowie der Titel und Links des Stores. |
| Land | string | Ja | Code aus zwei Buchstaben für die Store-Region: Die Gratisspiele können je nach Land abweichen. |
So installierst du Epic Games Store in Gladys
- Öffne in Gladys Integrationen: Epic Games Store erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/guim31/gladys-epic-games:1.0.1) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/guim31/gladys-epic-games.
Epic Games Store 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
Epic Games Store 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.
- Alle Integrationen durchsuchen, native und aus der Community
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation