Integriere deine Spiele mit TikXander

Was ist lokale Spielintegration?

Lokale Integration bedeutet: dein Spiel oder Widget ist eine normale Webseite (Browser, OBS Browser Source oder Desktop-WebView) und verbindet sich mit einem WebSocket auf dem Rechner des Streamers. Der Local Agent ist die Brücke: er verwaltet die TikTok-Live-Verbindung (inkl. Browser-Mode) und verteilt normalisierte Events an freigegebene Apps.

Events bleiben auf localhost (127.0.0.1). Dein Spiel braucht kein öffentliches Backend, um während des Streams Gifts zu empfangen — ideal für OBS-Overlays, Custom-Minispiele und Prototypen.

Für wen?

• Game- und Widget-Entwickler, die TikTok-Live-Gifts und Chat ins Gameplay steuern wollen.
• Studios, die OBS-Overlays bauen, die auf Gift, Like, Follow und Chat in Echtzeit reagieren.
• Creator und Teams, die eigene interaktive Formate prototypisieren, bevor sie ein Produkt veröffentlichen.
• Alle, die einen lokalen Event-Kanal mit niedriger Latenz auf dem Streamer-PC statt nur Cloud-Relays wollen.

So funktioniert es

1) Der Streamer installiert den TikXander Local Agent, meldet sich an und startet die Live-Erfassung (Browser-Mode im Agent ist der bevorzugte Weg).

2) Deine App verbindet sich mit dem lokalen Event-Kanal auf Port 8767. Auf demselben Localhost-Server gibt es zwei öffentliche Oberflächen: den versionierten Developer-Kanal ws://127.0.0.1:8767/events/v1 (App-ID / Berechtigungen) und den lokalen DAPI-Kanal ws://127.0.0.1:8767/dapi für leichte Integrationen auf dem Rechner.

3) Sendet ein Zuschauer ein Gift, Like, Chat oder Follow, emittiert der Agent einen normalisierten Event-Frame. Dein Spiel mappt das auf Spawns, Fortschrittsbalken, Alerts oder Scores.

4) Optional auf demselben Host: Long-Poll (/events/v1/poll), Simulate (POST /events/v1/simulate) und Status (GET /events/v1/status) zum Entwickeln ohne jedes Mal ein volles Live.

Lokale Endpoints (Streamer-PC)

• WebSocket Developer-API: ws://127.0.0.1:8767/events/v1 — versionierte, app-bezogene Events.
• WebSocket lokales DAPI: ws://127.0.0.1:8767/dapi — lokaler Event-Stream.
• HTTP-Helfer (gleicher Port): /events/v1/poll, /events/v1/simulate, /events/v1/status.
• Nur localhost (127.0.0.1:8767): dieser Kanal verlässt den Streamer-PC nicht.

Event-Typen

• gift — Zuschauer-Geschenk mit Identität und Metadaten (Streaks vor dem Fan-out aufgelöst).
• like — Likes im Live (weicher Fortschritt und Boosts).
• chat — Kommentare für Keyword-Spiele, Umfragen und Shout-outs.
• follow / join — Wachstumsmomente für Welcome-Effekte und Zähler.
• live_status — Session gestartet/beendet für sauberes UI-Idle.

So startest du

1. 1. TikXander-Konto erstellen

   Registriere dich auf games.tikxander.com — dasselbe Dashboard, das Streamer für Spiele, Pläne und Live-Tools nutzen.

2. 2. Local Agent installieren

   Lies die Local-Agent-Produktseite zu Overlays, Widgets und dem Desktop-Agent, der die Localhost-Event-Ports bereitstellt.

3. 3. Spiel mit localhost verbinden

   Öffne einen WebSocket zu ws://127.0.0.1:8767/events/v1 (mit App-ID bei Bedarf) oder ws://127.0.0.1:8767/dapi und mappe gift/like/chat/follow auf deine Spiellogik.

4. 4. Ohne volles Live testen

   Nutze POST /events/v1/simulate und GET /events/v1/status auf demselben Host, um Test-Gifts einzuspeisen.

5. 5. Mit dem Streamer-Workflow shippen

   Streamer können dein Erlebnis mit Katalog, Widgets und Session-Tools von TikXander im Dashboard kombinieren.

Warum Entwickler TikXander wählen

Echtzeit-Event-Pipe neben OBS, klare Typen (gift, like, chat, follow), Simulation für die Entwicklung und eine Produktfläche, der Streamer für interaktives TikTok Live schon vertrauen. Konten und Pläne auf games.tikxander.com; Local-Agent-Seite auf dieser Website (z. B. /de/local-agent).

Häufig gestellte Fragen