Integra els teus jocs amb TikXander

Què és la integració local de jocs?

Integració local vol dir que el teu joc o widget és una pàgina web normal (navegador, Browser Source d'OBS o WebView d'escriptori) i es connecta a un WebSocket a la màquina del streamer. L'Agent Local és el pont: gestiona la connexió a TikTok Live (inclòs el browser-mode) i reparteix esdeveniments normalitzats a les apps que el streamer ha permès.

Els esdeveniments es queden a localhost (127.0.0.1). El teu joc no necessita un backend públic per rebre regals durant l'stream — ideal per a overlays d'OBS, minijocs a mida i prototips.

Per a qui és?

• Desenvolupadors de jocs i widgets que volen que regals i xat de TikTok Live impulsin la jugabilitat.
• Estudis que creen overlays d'OBS reaccionant a gift, like, follow i chat en temps real.
• Creadors i equips que prototipen formats interactius propis abans de publicar un producte complet.
• Qui prefereix un canal local de baixa latència al PC del streamer en lloc de dependre només de relays al núvol.

Com funciona

1) El streamer instal·la i inicia sessió a l'Agent Local de TikXander i comença a capturar el live (el browser-mode de l'agent és el camí preferit).

2) La teva app es connecta al canal d'esdeveniments local al port 8767. Al mateix servidor localhost hi ha dues superfícies públiques: el canal versionat de desenvolupadors ws://127.0.0.1:8767/events/v1 (app id / permisos) i el canal DAPI local ws://127.0.0.1:8767/dapi per a consumidors lleugers a la mateixa màquina.

3) Quan un espectador envia un regal, fa like, escriu al xat o segueix, l'agent emet un frame normalitzat. El teu joc el mapeja a spawns, barres, alertes o puntuacions.

4) Al mateix host: long-poll (/events/v1/poll), simulació (POST /events/v1/simulate) i estat (GET /events/v1/status) per desenvolupar sense un live complet cada vegada.

Endpoints locals (PC del streamer)

• WebSocket API de desenvolupadors: ws://127.0.0.1:8767/events/v1 — esdeveniments versionats i acotats per app.
• WebSocket DAPI local: ws://127.0.0.1:8767/dapi — stream d'esdeveniments local.
• Ajudes HTTP (mateix port): /events/v1/poll, /events/v1/simulate, /events/v1/status.
• Només localhost (127.0.0.1:8767): aquest canal no surt del PC del streamer.

Tipus d'esdeveniment

• gift — regal de l'espectador amb identitat i metadades (streaks resolts abans del fan-out).
• like — likes del live (progrés suau i acceleracions).
• chat — comentaris per a jocs per paraula clau, enquestes i mencions.
• follow / join — moments de creixement per a benvingudes i comptadors.
• live_status — sessió iniciada/finalitzada per a un idle net de la UI.

Com començar

1. 1. Crea un compte a TikXander

   Registra't a games.tikxander.com — el mateix panell que fan servir els streamers per a jocs, plans i eines de live.

2. 2. Instal·la l'Agent Local

   Consulta la pàgina de l'Agent Local per entendre overlays, widgets i l'agent d'escriptori que exposa els ports d'esdeveniments a localhost.

3. 3. Connecta el teu joc a localhost

   Obre un WebSocket a ws://127.0.0.1:8767/events/v1 (amb app id quan calgui) o a ws://127.0.0.1:8767/dapi i mapeja gift/like/chat/follow a la teva lògica.

4. 4. Prova sense un live complet

   Fes servir POST /events/v1/simulate i GET /events/v1/status al mateix host per injectar regals de prova.

5. 5. Publica amb el flux del streamer

   Els streamers poden combinar la teva experiència amb el catàleg, widgets i eines de sessió de TikXander des del panell.

Per què els desenvolupadors trien TikXander

Tens un canal d'esdeveniments en temps real al costat d'OBS, tipus clars (gift, like, chat, follow), simulació per al desenvolupament i una superfície de producte que els streamers ja usen per a TikTok Live interactiu. Comptes i plans a games.tikxander.com; fitxa de l'Agent Local en aquest lloc (p. ex. /ca/agent-local).

Preguntes freqüents