Integra i tuoi giochi con TikXander

Cos'è l'integrazione locale dei giochi?

Integrazione locale significa che il tuo gioco o widget è una pagina web normale (browser, Browser Source OBS o WebView desktop) e si connette a un WebSocket sulla macchina dello streamer. L'Agente Locale è il ponte: gestisce la connessione a TikTok Live (incluso browser-mode) e distribuisce eventi normalizzati alle app autorizzate dallo streamer.

Gli eventi restano su localhost (127.0.0.1). Il tuo gioco non ha bisogno di un backend pubblico per ricevere gift durante lo stream — ideale per overlay OBS, minigiochi custom e prototipi.

Per chi è?

• Sviluppatori di giochi e widget che vogliono gift e chat di TikTok Live a guidare il gameplay.
• Studio che costruiscono overlay OBS che reagiscono a gift, like, follow e chat in tempo reale.
• Creator e team che prototipano formati interattivi prima di pubblicare un prodotto completo.
• Chi preferisce un canale eventi locale a bassa latenza sul PC dello streamer invece di soli relay cloud.

Come funziona

1) Lo streamer installa e accede all'Agente Locale TikXander e avvia la cattura live (il browser-mode dell'agente è il percorso consigliato).

2) La tua app si connette al canale eventi locale sulla porta 8767. Sullo stesso server localhost ci sono due superfici pubbliche: il canale developer versionato ws://127.0.0.1:8767/events/v1 (app id / permessi) e il canale DAPI locale ws://127.0.0.1:8767/dapi per consumatori leggeri sulla macchina.

3) Quando uno spettatore invia un gift, like, chat o follow, l'agente emette un frame normalizzato. Il tuo gioco lo mappa a spawn, barre, alert o punteggi.

4) Sullo stesso host: long-poll (/events/v1/poll), simulate (POST /events/v1/simulate) e status (GET /events/v1/status) per sviluppare senza un live completo ogni volta.

Endpoint locali (PC dello streamer)

• WebSocket API developer: ws://127.0.0.1:8767/events/v1 — eventi versionati e scoped per app.
• WebSocket DAPI locale: ws://127.0.0.1:8767/dapi — stream eventi locale.
• Helper HTTP (stessa porta): /events/v1/poll, /events/v1/simulate, /events/v1/status.
• Solo localhost (127.0.0.1:8767): questo canale non esce dal PC dello streamer.

Tipi di evento

• gift — regalo dello spettatore con identità e metadati (streak risolti prima del fan-out).
• like — like del live (progressi soft e boost).
• chat — commenti per giochi a keyword, sondaggi e shout-out.
• follow / join — momenti di crescita per welcome e contatori.
• live_status — sessione avviata/terminata per un idle pulito dell'UI.

Come iniziare

1. 1. Crea un account TikXander

   Registrati su games.tikxander.com — la stessa dashboard usata dagli streamer per giochi, piani e tool live.

2. 2. Installa l'Agente Locale

   Consulta la pagina prodotto Agente Locale per overlay, widget e l'agente desktop che espone le porte eventi su localhost.

3. 3. Collega il gioco a localhost

   Apri un WebSocket su ws://127.0.0.1:8767/events/v1 (con app id se richiesto) o ws://127.0.0.1:8767/dapi e mappa gift/like/chat/follow alla tua logica.

4. 4. Testa senza un live completo

   Usa POST /events/v1/simulate e GET /events/v1/status sullo stesso host per iniettare gift di prova.

5. 5. Pubblica con il flusso streamer

   Gli streamer possono abbinare la tua esperienza a catalogo, widget e tool di sessione TikXander dalla dashboard.

Perché gli sviluppatori scelgono TikXander

Un pipe eventi in tempo reale accanto a OBS, tipi chiari (gift, like, chat, follow), simulazione per lo sviluppo e una superficie prodotto già usata per TikTok Live interattivo. Account e piani su games.tikxander.com; scheda Agente Locale su questo sito (es. /it/agente-locale).

Domande frequenti