Integra tus juegos con TikXander

¿Qué es la integración local de juegos?

Integración local significa que tu juego o widget es una página web normal (navegador, Browser Source de OBS o WebView de escritorio) y se conecta a un WebSocket en la máquina del streamer. El Agente Local es el puente: gestiona la conexión a TikTok Live (incluido el browser-mode) y reparte eventos normalizados a las apps que el streamer ha permitido.

Los eventos se quedan en localhost (127.0.0.1). Tu juego no necesita un backend público para recibir regalos durante el stream — ideal para overlays de OBS, minijuegos a medida y prototipos de desarrolladores.

¿Para quién es?

• Desarrolladores de juegos y widgets que quieren que regalos y chat de TikTok Live impulsen la jugabilidad.
• Estudios que crean overlays de OBS reaccionando a gift, like, follow y chat en tiempo real.
• Creadores y equipos que prototipan formatos interactivos propios antes de publicar un producto completo.
• Quienes prefieren un canal local de baja latencia en el PC del streamer en lugar de depender solo de relays en la nube.

Cómo funciona

1) El streamer instala e inicia sesión en el Agente Local de TikXander y empieza a capturar el live (el browser-mode del agente es el camino preferido).

2) Tu app se conecta al canal de eventos local en el puerto 8767. En el mismo servidor localhost hay dos superficies públicas: el canal versionado de desarrolladores en ws://127.0.0.1:8767/events/v1 (con app id / permisos) y el canal DAPI local en ws://127.0.0.1:8767/dapi para consumidores ligeros en la misma máquina.

3) Cuando un espectador envía un regalo, da like, escribe en el chat o sigue, el agente emite un frame de evento normalizado. Tu juego lo mapea a spawnear enemigos, llenar barras, mostrar alertas o actualizar puntuaciones.

4) En el mismo host hay ayudas opcionales: long-poll (/events/v1/poll), simulación (POST /events/v1/simulate) y estado (GET /events/v1/status) para desarrollar sin un live completo cada vez.

Endpoints locales (PC del streamer)

• WebSocket API de desarrolladores: ws://127.0.0.1:8767/events/v1 — eventos versionados y acotados por app para juegos y widgets.
• WebSocket DAPI local: ws://127.0.0.1:8767/dapi — stream de eventos local para integraciones en la misma máquina.
• Ayudas HTTP (mismo puerto): /events/v1/poll, /events/v1/simulate, /events/v1/status — sondear, inyectar eventos de prueba y diagnosticar presencia.
• Solo localhost (127.0.0.1:8767): este canal no se expone fuera del PC del streamer.

Tipos de evento a los que puedes reaccionar

• gift — regalo del espectador con identidad y metadatos (streaks resueltos antes del fan-out).
• like — likes del live (ideales para progreso suave y aceleraciones).
• chat — comentarios para juegos por palabra clave, encuestas y menciones.
• follow / join — momentos de crecimiento para bienvenidas y contadores.
• live_status — sesión iniciada/finalizada para que tu UI quede en idle al cortar la captura.

Cómo empezar

1. 1. Crea una cuenta en TikXander

   Regístrate en games.tikxander.com — el mismo panel que usan los streamers para juegos, planes y herramientas de live.

2. 2. Instala el Agente Local

   Consulta la página del Agente Local para entender overlays, widgets y el agente de escritorio que expone los puertos de eventos en localhost.

3. 3. Conecta tu juego a localhost

   Abre un WebSocket a ws://127.0.0.1:8767/events/v1 (con tu app id cuando haga falta) o a ws://127.0.0.1:8767/dapi, parsea gift/like/chat/follow y mapéalos a tu lógica de juego.

4. 4. Prueba sin un live completo

   Usa POST /events/v1/simulate y GET /events/v1/status en el mismo host para inyectar regalos de prueba y validar handlers antes de salir al aire.

5. 5. Publica con el flujo del streamer

   Cuando estés listo, los streamers pueden combinar tu experiencia con el catálogo, widgets y herramientas de sesión de TikXander desde el panel.

Por qué los desarrolladores eligen TikXander

Tienes un canal de eventos en tiempo real junto a OBS, tipos claros (gift, like, chat, follow), simulación para desarrollo y una superficie de producto que los streamers ya usan para TikTok Live interactivo. Cuentas y planes en games.tikxander.com; la ficha del Agente Local en este sitio (ruta localizada, p. ej. /es/agente-local).

Preguntas frecuentes