Integre seus jogos com o TikXander

O que é a integração local de jogos?

Integração local significa que seu jogo ou widget é uma página web normal (navegador, Browser Source do OBS ou WebView desktop) e se conecta a um WebSocket na máquina do streamer. O Agente Local é a ponte: gerencia a conexão com o TikTok Live (incluindo browser-mode) e distribui eventos normalizados para os apps permitidos pelo streamer.

Os eventos ficam em localhost (127.0.0.1). Seu jogo não precisa de backend público para receber gifts durante o stream — ideal para overlays OBS, minijogos sob medida e protótipos.

Para quem é?

• Desenvolvedores de jogos e widgets que querem gifts e chat do TikTok Live dirigindo a jogabilidade.
• Estúdios que criam overlays de OBS reativos a gift, like, follow e chat em tempo real.
• Criadores e equipes que prototipam formatos interativos antes de publicar um produto completo.
• Quem prefere um canal de eventos local de baixa latência no PC do streamer em vez de só relays na nuvem.

Como funciona

1) O streamer instala e entra no Agente Local TikXander e inicia a captura do live (browser-mode do agente é o caminho preferido).

2) Seu app conecta ao canal de eventos local na porta 8767. No mesmo servidor localhost há duas superfícies públicas: o canal versionado de desenvolvedores ws://127.0.0.1:8767/events/v1 (app id / permissões) e o canal DAPI local ws://127.0.0.1:8767/dapi para consumidores leves na máquina.

3) Quando um espectador envia gift, like, chat ou follow, o agente emite um frame normalizado. Seu jogo mapeia isso para spawns, barras, alertas ou pontuações.

4) No mesmo host: long-poll (/events/v1/poll), simulate (POST /events/v1/simulate) e status (GET /events/v1/status) para desenvolver sem um live completo sempre.

Endpoints locais (PC do streamer)

• WebSocket API de desenvolvedores: ws://127.0.0.1:8767/events/v1 — eventos versionados e com escopo por app.
• WebSocket DAPI local: ws://127.0.0.1:8767/dapi — stream de eventos local.
• Ajudas HTTP (mesma porta): /events/v1/poll, /events/v1/simulate, /events/v1/status.
• Somente localhost (127.0.0.1:8767): este canal não sai do PC do streamer.

Tipos de evento

• gift — presente do espectador com identidade e metadados (streaks resolvidos antes do fan-out).
• like — likes do live (progresso suave e boosts).
• chat — comentários para jogos por palavra-chave, enquetes e menções.
• follow / join — momentos de crescimento para boas-vindas e contadores.
• live_status — sessão iniciada/encerrada para idle limpo da UI.

Como começar

1. 1. Crie uma conta TikXander

   Cadastre-se em games.tikxander.com — o mesmo painel que os streamers usam para jogos, planos e ferramentas de live.

2. 2. Instale o Agente Local

   Veja a página do Agente Local para overlays, widgets e o agente desktop que expõe as portas de eventos em localhost.

3. 3. Conecte seu jogo ao localhost

   Abra um WebSocket em ws://127.0.0.1:8767/events/v1 (com app id se necessário) ou ws://127.0.0.1:8767/dapi e mapeie gift/like/chat/follow para a lógica do jogo.

4. 4. Teste sem um live completo

   Use POST /events/v1/simulate e GET /events/v1/status no mesmo host para injetar gifts de teste.

5. 5. Publique com o fluxo do streamer

   Streamers podem combinar sua experiência com o catálogo, widgets e ferramentas de sessão do TikXander no painel.

Por que desenvolvedores escolhem o TikXander

Você tem um pipe de eventos em tempo real ao lado do OBS, tipos claros (gift, like, chat, follow), simulação para desenvolvimento e uma superfície de produto que streamers já usam no TikTok Live interativo. Contas e planos em games.tikxander.com; página do Agente Local neste site (ex. /pt/agente-local).

Perguntas frequentes