TikFinity-Einrichtung

Schritt-für-Schritt-Anleitung zum Einbinden von TikFinity in BakoshApp über den Mechanismus für Aktionen von Drittanbietern – funktioniert bei den Tarifen „Free“ und PRO.

Dieser Leitfaden führt Sie durch den TikFinity-Pfad – die Einbindung von TikTok-LIVE-Ereignissen in BakoshApp über den Third-party action-Mechanismus von TikFinity. Dies ist die kostenlose Option und funktioniert mit jedem BakoshApp-Tarif. Eine Alternative ohne TikFinity finden Sie unter Native Connector.

Was ist eine Drittanbieter-Aktion?

Drittanbieter-Aktion ist ein TikFinity-Aktions-Typ, der ein TikTok-LIVE-Ereignis an ein externes Programm weiterleitet – in unserem Fall an BakoshApp:

TikFinity erfasst das Ereignis → leitet es an BakoshApp weiter → BakoshApp führt den In-Game-Effekt aus.

Du kannst die folgenden TikTok-Ereignisse darüber leiten: Geschenk, Like, Folgen, Teilen, Kommentar, Beitreten.

Wie das Ganze zusammenpasst

  1. Du startest BakoshApp.
  2. Du startest TikFinity.
  3. Innerhalb von TikFinity erstellst du einen Trigger.
  4. Die Aktion des Triggers wird auf Drittanbieter-Aktion gesetzt.
  5. Wenn ein Zuschauerereignis eintritt, sendet TikFinity ein Signal.
  6. BakoshApp empfängt das Ereignis und führt den entsprechenden Effekt aus.
Warning

BakoshApp muss bereits laufen, bevor du Trigger testest. Andernfalls hat TikFinity nichts, wohin es senden kann.

Voraussetzungen

Stelle sicher, dass du Folgendes hast:

  • BakoshApp installiert und angemeldet ist (siehe Installation)
  • TikFinity installiert und mit deinem LIVE verbunden ist (Status: Verbunden)
  • Ein aktives TikTok LIVE
  • Das Zielspiel läuft (falls die Aktion ein laufendes Spiel erfordert)
  • Keine Firewall, die die beiden Apps blockiert
  • Eine stabile Internetverbindung

Es empfiehlt sich, beide Apps vor der ersten Konfiguration neu zu starten.

Schritt 1 – Erstelle einen Trigger in TikFinity

  1. Öffne TikFinity.
  2. Gehe zu Trigger.
  3. Klicke auf Trigger hinzufügen.

Schritt 2 – Wähle das Ereignis

Wählen Sie den TikTok-Ereignistyp:

  • Geschenk
  • Like
  • Folgen
  • Teilen
  • Kommentar
  • Beitreten

Beispiel: Geschenk, wenn Sie auf das Geschenk eines Zuschauers reagieren möchten.

Schritt 3 – Legen Sie die Bedingungen fest

Sie können den Trigger eingrenzen durch:

  • Bestimmtes Geschenk (z. B. Rose oder Galaxy)
  • Mindestanzahl
  • Mindestwert
  • Beliebiges Geschenk
  • Nur von einem bestimmten Benutzernamen

Wenn du die Bedingungen leer lässt, wird der Trigger bei jedem Ereignis dieses Typs ausgelöst.

Schritt 4 – Füge eine Aktion hinzu

  1. Klicke auf Aktion hinzufügen.
  2. Wähle Aktion eines Drittanbieters aus der Liste aus.

Das Einstellungsfenster wird geöffnet.

Schritt 5 – Konfiguriere die Aktion eines Drittanbieters

Kategorie auswählen

BakoshApp veröffentlicht seine verfügbaren Kategorien automatisch in TikFinity – jedoch nur für Aktionen, denen in BakoshApp ein Tikfinity-Trigger zugewiesen ist. Aktionen ohne Trigger oder mit einem Nicht-Tikfinity-Trigger (Geschenk, Like, Chat, …) werden hier nicht angezeigt: Diese werden direkt vom Native Connector verarbeitet.

Die Kategorien hängen vom aktiven Mod ab:

  • GTA V (KOTH / Chaos / Train) – die gemeinsamen Kategorien Vehicles, Props, GTA V Other (definiert in gtav-actions.json) sind in allen drei GTA V-Varianten über Katalogausleihe verfügbar. Jede Variante fügt zudem eigene Kategorien hinzu: KOTH und Chaos fügen ihre spielspezifischen Gruppen hinzu, Train fügt Trainmod hinzu (Start/Stopp, Gleiswechsel, Geschwindigkeits-/Gesundheitssteuerung).
  • GTA V Chaos — 7 Chaos-Kategorien (Chaos mod Player, NPC, Chaos mod Vehicle, Chaos mod Screen, Chaos mod Time, Chaos mod Weather, Chaos mod Misc).
  • Rust Survival — 16 Kategorien: 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.

Wähle die Aktion

Wähle innerhalb der ausgewählten Kategorie die spezifische Aktion aus – zum Beispiel ein Fahrzeug spawnen, teleportieren, das Wetter ändern, einen Chaos-Effekt auslösen oder einen zeitgesteuerten Effekt abfeuern.

Verwende die Schaltfläche „Test“

Das Aktionsfenster für Drittanbieter verfügt über eine Schaltfläche Test:

  • Es sendet ein synthetisches Ereignis an BakoshApp.
  • Es überprüft die Integration von Anfang bis Ende.
  • Es bestätigt, dass der Effekt im Spiel tatsächlich ausgelöst wird.

Drücke direkt nach der Konfiguration auf Test. Wenn nichts passiert, überprüfe, ob BakoshApp läuft und keine Firewall eine der beiden Apps blockiert.

Anwendungsbeispiel

Ziel: Wenn ein Zuschauer ein Galaxy sendet, soll eine Explosion neben dem Spieler ausgelöst werden.

In TikFinity:

  • Ereignis: Geschenk → Geschenkname = Galaxy
  • Aktion: Drittanbieter-Aktion → Kategorie = Effekte → Aktion = Explosion in der Nähe

Dann:

  1. Klicke auf Speichern.
  2. Vergewissere dich, dass der Trigger aktiviert ist.
  3. Klicke auf Testen.
  4. Überprüfe dies in einem Live-Stream.

Plausibilitätsprüfung

Die Einrichtung ist korrekt, wenn alle folgenden Bedingungen erfüllt sind:

  • TikFinity-Status = Mit LIVE verbunden.
  • Ein TikTok-Ereignis löst den entsprechenden Trigger in TikFinity aus.
  • BakoshApp protokolliert das eingehende Ereignis.
  • Der Effekt im Spiel wird tatsächlich abgespielt.

Wenn eine der vier Bedingungen nicht erfüllt ist, überprüfe den vorherigen Schritt erneut.

Häufige Fehler

Es passiert nichts

  • BakoshApp läuft nicht.
  • Der Trigger ist deaktiviert.
  • Falsches Geschenk ausgewählt.
  • Kein aktives LIVE.

Der Test-Button hat keine Wirkung

  • BakoshApp läuft nicht.
  • Die App-Versionen sind nicht synchron – aktualisiere beide.
  • Ein anderes Tool fängt Ereignisse ab.

Der Trigger wird zu oft ausgelöst

  • Es wurden keine Bedingungen festgelegt.
  • Oder du hast versehentlich Beliebiges Geschenk ausgewählt.

Tipps zur Stabilität

  • Starte BakoshApp bevor du LIVE gehst.
  • Ändere keine Einstellungen, während LIVE aktiv ist.
  • Dupliziere keine identischen Trigger.
  • Klicke gelegentlich auf Test, um einen Smoke-Test durchzuführen.
  • Halte beide Apps auf dem neuesten Stand.

Was kommt als Nächstes

  • Unter Trigger findest du den vollständigen Katalog der Trigger-Typen in BakoshApp.
  • Verwenden Sie PRO? Vergleichen Sie es mit dem Native Connector – TikFinity ist nicht erforderlich.
  • Wenn etwas nicht richtig funktioniert, sehen Sie unter Allgemeine Fehler und Protokolle lesen nach.