Intégrez vos jeux avec TikXander

Qu'est-ce que l'intégration locale de jeux ?

L'intégration locale signifie que votre jeu ou widget est une page web normale (navigateur, Browser Source OBS ou WebView bureau) et se connecte à un WebSocket sur la machine du streamer. L'Agent Local est le pont : il gère la connexion TikTok Live (y compris le browser-mode) et redistribue des événements normalisés aux apps autorisées par le streamer.

Les événements restent sur localhost (127.0.0.1). Votre jeu n'a pas besoin d'un backend public pour recevoir des cadeaux pendant le stream — idéal pour les overlays OBS, minijeux sur mesure et prototypes développeur.

Pour qui ?

• Développeurs de jeux et widgets qui veulent que les cadeaux et le chat TikTok Live pilotent le gameplay.
• Studios qui construisent des overlays OBS réagissant à gift, like, follow et chat en temps réel.
• Créateurs et équipes qui prototypent des formats interactifs avant de publier un produit complet.
• Ceux qui préfèrent un canal d'événements local à faible latence sur le PC du streamer plutôt que des relais cloud uniquement.

Comment ça marche

1) Le streamer installe et se connecte à l'Agent Local TikXander, puis démarre la capture live (le browser-mode de l'agent est le chemin recommandé).

2) Votre app se connecte au canal d'événements local sur le port 8767. Deux surfaces publiques coexistent sur le même serveur localhost : le canal développeur versionné ws://127.0.0.1:8767/events/v1 (app id / permissions) et le canal DAPI local ws://127.0.0.1:8767/dapi pour des consommateurs légers sur la machine.

3) Quand un spectateur envoie un cadeau, like, chat ou follow, l'agent émet une frame d'événement normalisée. Votre jeu la mappe vers spawns, barres de progression, alertes ou scores.

4) Des aides optionnelles sur le même hôte : long-poll (/events/v1/poll), simulation (POST /events/v1/simulate) et status (GET /events/v1/status) pour développer sans live complet à chaque fois.

Endpoints locaux (PC du streamer)

• WebSocket API développeur : ws://127.0.0.1:8767/events/v1 — événements versionnés et scoped par app.
• WebSocket DAPI local : ws://127.0.0.1:8767/dapi — flux d'événements local pour intégrations sur la machine.
• Aides HTTP (même port) : /events/v1/poll, /events/v1/simulate, /events/v1/status.
• Bind localhost uniquement (127.0.0.1:8767) : ce canal ne sort pas du PC du streamer.

Types d'événements

• gift — cadeau du spectateur avec identité et métadonnées (streaks résolus avant fan-out).
• like — likes du live (progression douce, accélérations).
• chat — commentaires pour jeux par mot-clé, sondages et shout-outs.
• follow / join — moments de croissance pour accueils et compteurs.
• live_status — session démarrée/terminée pour un idle propre de l'UI.

Par où commencer

1. 1. Créer un compte TikXander

   Inscrivez-vous sur games.tikxander.com — le même tableau de bord que les streamers pour jeux, formules et outils live.

2. 2. Installer l'Agent Local

   Consultez la page produit Agent Local pour comprendre overlays, widgets et l'agent bureau qui expose les ports d'événements localhost.

3. 3. Connecter votre jeu à localhost

   Ouvrez un WebSocket vers ws://127.0.0.1:8767/events/v1 (avec app id si requis) ou ws://127.0.0.1:8767/dapi, parsez gift/like/chat/follow et mappez-les à votre logique.

4. 4. Tester sans live complet

   Utilisez POST /events/v1/simulate et GET /events/v1/status sur le même hôte pour injecter des cadeaux de test.

5. 5. Publier avec le flux streamer

   Les streamers peuvent associer votre expérience au catalogue, widgets et outils de session TikXander depuis le tableau de bord.

Pourquoi les développeurs choisissent TikXander

Un pipe d'événements temps réel à côté d'OBS, des types clairs (gift, like, chat, follow), de la simulation pour le dev, et une surface produit déjà adoptée pour TikTok Live interactif. Comptes et formules sur games.tikxander.com ; fiche Agent Local sur ce site (ex. /fr/agent-local).

Questions fréquentes