Beschreibung

Unser Twitch-Benachrichtigungsmodul wurde entwickelt, um Ihren Community-Mitgliedern ein fortschrittliches, interaktives und automatisiertes Stream-Tracking-Erlebnis auf Discord zu bieten!

🔄 Dreistufiger Arbeitsablauf

1. Erkennung des Stream-Starts

Sobald der Stream startet, erstellt das Modul automatisch eine Benachrichtigung im Discord-Server, indem es das vorkonfigurierte Stream-Start-Bild abruft und einen Ping an die konfigurierte Rolle sendet, mit einer dynamischen Vorschau und allen nützlichen Stream-Informationen (Zuschauerzahl 👀 & Startzeit ⏰).


2. Automatische Datenaktualisierung

Jede Minute ⏱️ analysiert das Modul die Entwicklung des Streams in Echtzeit: Es aktualisiert die Discord-Nachricht mit neuen Statistiken 📈 (Zuschauerzahl 🎉 & einem Screenshot des Streams 📸).

Die Mitglieder haben so aktuelle Informationen, wenn sie die Benachrichtigung später sehen. Dies stellt sicher, dass der Streamer noch live ist, wenn die Benachrichtigung später gelesen wird!


3. Verwaltung von Unterbrechungen und Stream-Ende

Wenn der Stream eine Unterbrechung erfährt 🔌, prüft das Modul 10 Minuten lang ⏳, ob die Unterbrechung vorübergehend ist (Verbindungsverlust, Neustart…).

• 🟢 Wenn der Stream neu startet, wird die Benachrichtigung wieder grün (aktiver Stream) ✅
• 🔴 Andernfalls wird die Nachricht nach dieser Verzögerung rot und als Stream-Ende betrachtet. Alle finalen Statistiken werden angezeigt: Startzeit, Endzeit, Stream-Dauer, Zuschauer-Spitzenwert & Anzahl neuer Follower (Das vorkonfigurierte Stream-Ende-Bild wird angezeigt) 📋

• 🟠 Während der Unterbrechung wird der Status orange in der Nachricht angezeigt, um auf Anomalien hinzuweisen ⚠️

✨ Systemvorteile

• 👁️ Echtzeit-Sichtbarkeit der Streamer-Aktivität direkt auf Discord
• 🎨 Verstärktes Community-Engagement durch dynamische und illustrierte Benachrichtigungen
• 📚 Automatische Historie: Der gesamte Stream-Verlauf (Statistiken, Entwicklung) wird in einer einzigen Discord-Nachricht archiviert, für jeden Stream 🗂️
• 🔄 Aktualisierung eines Sprachchats, um die Anzahl der Follower des Twitch-Kanals beim Start und beim Beenden des Live-Streams anzuzeigen

Mit diesem Modul wird jeder Twitch-Stream zu einem interaktiven Event 🎊, perfekt in Ihren Discord-Server integriert, ohne manuelle Verwaltung 🤖, für eine lebendigere Atmosphäre und vollständiges Reporting bei jeder Übertragung! 🎉🔥

❗ Wichtig

• Das Modul ist nicht funktionsfähig durch bloßes Herunterladen der Dateien; es muss in einen bereits funktionierenden Discord-Bot integriert werden
• Wir verwenden Prisma als ORM zur Datenbankverwaltung; stellen Sie sicher, dass Ihr Projekt ebenfalls Prisma verwendet oder passen Sie den Code entsprechend an

⚠️ Voraussetzungen

• Ein funktionierender Discord-Bot mit den notwendigen Berechtigungen zum Registrieren von Slash-Befehlen
• Sie sollten Kenntnisse in der Discord-Bot-Entwicklung (Javascript) & Datenbankverwaltung haben, um dieses Skript nutzen und an Ihre Bedürfnisse anpassen zu können

Dateien/Ordner

• Verzeichnisimages

  • Verzeichnisscreen-live/ Enthält temporäre Stream-Bilder

    • …
  • offline.png
  • online.png
• Verzeichnisprisma

  • schema.prisma Datenmodell für das Modul (Prisma)
• Verzeichnisutils

  • Verzeichnisnotification

    • twitch.js Funktionen zur Verwaltung der Modul-Benachrichtigungen
  • environment.js Hilfsfunktion zum Schreiben einer Variable in die .env-Datei
  • utils.js Wiederverwendbare Hilfsfunktionen
• .env Erforderliche Umgebungsvariablen
• index.js Einstiegspunkt des Skripts
• package.json Erforderliche Abhängigkeiten

Abhängigkeiten & Versionen

Hier sind die während der Entwicklung und Tests verwendeten Versionen:

• @prisma/client@6.18.0
• discord.js@14.24.0
• dotenv@16.6.1
• moment@2.30.1
• fs@0.0.2
• axios@0.26.1
• uuid-js@0.7.5
• utf8@3.0.0