Configurazione di TikFinity

Guida passo passo per collegare TikFinity a BakoshApp tramite il meccanismo Third-party action — funziona sui piani Free e PRO.

Questa guida illustra il percorso TikFinity — collegare gli eventi TikTok LIVE a BakoshApp tramite il meccanismo Third-party action di TikFinity. Questa è l'opzione gratuita e funziona su qualsiasi piano BakoshApp. Per un'alternativa senza TikFinity, vedi Native Connector.

Cos'è una Third-party action

Third-party action è un tipo di azione TikFinity che inoltra un evento TikTok LIVE a un programma esterno — nel nostro caso, BakoshApp:

TikFinity cattura l'evento → lo inoltra a BakoshApp → BakoshApp esegue l'effetto in-game.

Puoi instradare i seguenti eventi TikTok attraverso di essa: Gift, Like, Follow, Share, Comment, Join.

Come si incastra tutto

  1. Avvii BakoshApp.
  2. Avvii TikFinity.
  3. Dentro TikFinity crei un Trigger.
  4. L'Action del Trigger è impostata su Third-party action.
  5. Quando un evento dello spettatore avviene, TikFinity invia un segnale.
  6. BakoshApp riceve l'evento ed esegue l'effetto corrispondente.
Warning

BakoshApp deve essere in esecuzione prima di testare i trigger. Altrimenti TikFinity non ha nulla a cui consegnare.

Prerequisiti

Assicurati di avere:

  • BakoshApp installato e con accesso effettuato (vedi Installazione)
  • TikFinity installato e collegato alla tua LIVE (stato: Connected)
  • Una TikTok LIVE attiva
  • Il gioco di destinazione in esecuzione (se l'azione necessita di un gioco in esecuzione)
  • Nessun firewall che blocca le due app
  • Una connessione internet stabile

È una buona abitudine riavviare entrambe le app prima del tuo primo passaggio di configurazione.

Step 1 — Crea un Trigger in TikFinity

  1. Apri TikFinity.
  2. Vai a Triggers.
  3. Clicca Add Trigger.

Step 2 — Scegli l'evento

Scegli il tipo di evento TikTok:

  • Gift
  • Like
  • Follow
  • Share
  • Comment
  • Join

Esempio: Gift se vuoi reagire al regalo di uno spettatore.

Step 3 — Imposta le condizioni

Puoi restringere il trigger per:

  • Regalo specifico (ad esempio Rose o Galaxy)
  • Conteggio minimo
  • Valore minimo
  • Qualsiasi regalo
  • Solo da un nome utente specifico

Se lasci le condizioni vuote, il trigger si attiva su ogni evento di quel tipo.

Step 4 — Aggiungi un'Action

  1. Premi Add Action.
  2. Scegli Third-party action dalla lista.

Il pannello delle impostazioni si apre.

Step 5 — Configura la Third-party action

Scegli la categoria

BakoshApp pubblica le sue categorie disponibili a TikFinity automaticamente — ma solo per le azioni che hanno un trigger Tikfinity assegnato dentro BakoshApp. Le azioni senza trigger, o con un trigger non-Tikfinity (Gift, Like, Chat, …) non compariranno qui: quelle sono gestite direttamente dal Native Connector.

Le categorie dipendono dal mod attivo:

  • GTA V (KOTH / Chaos / Train) — le categorie condivise Vehicles, Props, GTA V Other (definite in gtav-actions.json) sono disponibili in tutte e tre le varianti GTA V tramite catalog borrowing. Ogni variante aggiunge anche le proprie categorie: KOTH e Chaos aggiungono i loro gruppi specifici del gameplay, Train aggiunge Trainmod (start/stop, cambio binari, controlli velocità/salute).
  • GTA V Chaos — 7 categorie Chaos (Chaos mod Player, NPC, Chaos mod Vehicle, Chaos mod Screen, Chaos mod Time, Chaos mod Weather, Chaos mod Misc).
  • Rust Survival — 16 categorie: Items Weapons, Items Tools, Items Food, Items Medical, Items Traps, Items Resources, Animals, Player, Items Ammo, Items Attire, Items Components, Items Construction, Items Electrical, Items Fun, Items Misc, Items Other.

Scegli l'azione

Dentro la categoria scelta, scegli l'azione specifica — ad esempio, spawnare un veicolo, teletrasportare, cambiare il meteo, attivare un effetto caos o attivare un effetto temporizzato.

Usa il pulsante Test

Il pannello Third-party action ha un pulsante Test:

  • Invia un evento sintetico a BakoshApp.
  • Verifica l'integrazione end-to-end.
  • Conferma che l'effetto in-game si attivi effettivamente.

Premi Test subito dopo la configurazione. Se non succede nulla, controlla che BakoshApp sia in esecuzione e che nessun firewall stia bloccando una delle due app.

Esempio pratico

Obiettivo: quando uno spettatore invia una Galaxy, attiva un'esplosione vicino al giocatore.

In TikFinity:

  • Event: Gift → Gift Name = Galaxy
  • Action: Third-party action → Category = Effects → Action = Explosion nearby

Poi:

  1. Premi Save.
  2. Conferma che il Trigger sia abilitato.
  3. Premi Test.
  4. Verifica su uno stream dal vivo.

Verifica di sanità

Sei configurato correttamente quando tutti questi sono veri:

  • Stato TikFinity = Connected to LIVE.
  • Un evento TikTok attiva il Trigger corrispondente in TikFinity.
  • BakoshApp registra l'evento in arrivo.
  • L'effetto in-game viene effettivamente riprodotto.

Se uno qualsiasi dei quattro fallisce, ricontrolla il passaggio precedente.

Errori comuni

Non succede nulla

  • BakoshApp non è in esecuzione.
  • Il trigger è disattivato.
  • Regalo sbagliato selezionato.
  • Nessuna LIVE attiva.

Il pulsante Test non fa nulla

  • BakoshApp non è in esecuzione.
  • Le versioni delle app non sono sincronizzate — aggiorna entrambe.
  • Un altro strumento sta intercettando gli eventi.

Il trigger si attiva troppo spesso

  • Non sono state impostate condizioni.
  • O hai scelto Any Gift per errore.

Suggerimenti per la stabilità

  • Avvia BakoshApp prima di andare LIVE.
  • Non cambiare le impostazioni mentre la LIVE è attiva.
  • Non duplicare trigger identici.
  • Premi Test occasionalmente come test di sanità.
  • Mantieni entrambe le app aggiornate.

Cosa fare dopo