Migration in einem Schritt

Wechsle von TikTok-Live-Connector in Sekunden

Du nutzt schon tiktok-live-connector? Wechsle mit einer einzigen geänderten Import-Zeile zur gemanagten TikTool API. Dieselben Event-Namen, dieselben Methoden, keine Code-Änderungen.

1

SDK installieren

npm install @tiktool/live
2

Eine Import-Zeile ändern

-const { WebcastPushConnection } = require('tiktok-live-connector');
+const { WebcastPushConnection } = require('@tiktool/live');
3

Deinen TikTools-API-Key nutzen

-signApiKey: 'EULER_API_KEY'
+signApiKey: 'TIKTOOL_API_KEY'

Hol dir einen kostenlosen Key auf tik.tools - keine Kreditkarte nötig.

✅
Das war's. Alle deine bestehenden Event-Handler funktionieren genau gleich - chat, gift, member, roomUser, like, follow, share, emote, linkMicBattle, linkMicArmies, questionNew, getState(), connect(), disconnect().

Komplettes funktionierendes Beispiel

Dieser Code läuft mit tiktok-live-connector und @tiktool/live identisch. Nur der Import ändert sich.

// Before: const { WebcastPushConnection } = require('tiktok-live-connector');
const { WebcastPushConnection } = require('@tiktool/live');

const connection = new WebcastPushConnection('username', {
  signApiKey: 'YOUR_TIKTOOL_API_KEY',
});

connection.on('chat', data => {
  console.log(`${data.user.uniqueId}: ${data.comment}`);
});

connection.on('gift', data => {
  console.log(`${data.user.uniqueId} sent ${data.giftName}`);
});

connection.on('roomUser', data => {
  console.log(`Viewers: ${data.viewerCount}`);
});

connection.on('connected', state => {
  console.log('Connected!', connection.getState());
});

connection.connect();

100 % kompatible Event-Namen

Jeder Event-Name von TTLC funktioniert genau gleich. Zusätzlich feuern wir gleichzeitig den nativen TikTools-Namen.

TTLC-Event-NameStatusHinweise
chat✓Identisch
member✓Identisch
gift✓Identisch
like✓Identisch
follow✓Identisch
share✓Identisch
subscribe✓Identisch
social✓Identisch
roomUser✓Alias für roomUserSeq - beide feuern
questionNew✓Alias für question - beide feuern
linkMicBattle✓Alias für battle - beide feuern
linkMicArmies✓Alias für battleArmies - beide feuern
emote✓Alias für emoteChat - beide feuern
envelope✓Identisch
liveIntro✓Identisch
roomPin✓Identisch
barrage✓Identisch
superFan✓Neu in 2.0.8 - unterstützt
superFanJoin✓Neu in 2.0.8 - unterstützt
superFanBox✓Neu in 2.0.8 - unterstützt
connected✓Identisch
disconnected✓Identisch
error✓Identisch
streamEnd✓Identisch
rawData✓Feuert mit kompletter Roh-Payload des Events
websocketConnected✓Feuert beim Öffnen des WS

Warum zur gemanagten API wechseln?

🛡️

Bricht nie

TikTok aktualisiert sein Protokoll regelmäßig, und direkte Integrationen brechen dabei. TikTool übernimmt alle Protokolländerungen für dich - ohne Ausfallzeit.

⚡

Schnellere Event-Zustellung

Event-Latenz unter 50 ms dank unserer optimierten Infrastruktur. Kein Protobuf-Decoding auf deiner Seite.

🧩

Keine Abhängigkeiten

Kein protobufjs, kein ws-client, kein HTTP-Signing. Nur ein npm-Paket ohne externe Abhängigkeiten.

🔄

Automatische Wiederverbindung

Eingebaute Wiederverbindung mit exponentiellem Backoff. Deine Verbindung übersteht Netzwerk-Aussetzer und Neustarts der TikTok-Server.

📊

Nutzungs-Dashboard

Behalte deine API-Nutzung, WebSocket-Verbindungen und dein Event-Volumen in Echtzeit im Blick, auf tik.tools/dashboard.

💬

Support für Entwickler

Hilfe über Discord, E-Mail oder den Support-Chat in der App. Antwortzeit unter 4 Stunden.

Häufige Fragen

Funktionieren meine TypeScript-Typen weiter?

Ja. @tiktool/live liefert vollständige TypeScript-Definitionen für jede Event-Payload - chat, gift, roomUser und alle anderen. Wenn du die von der Community gepflegten Typen von TTLC genutzt hast: Unsere sind strenger und werden mit TikToks tatsächlichem Protobuf-Schema aktuell gehalten.

Was ist mit TTLC-Optionen wie sessionId, processInitialData und requestPollingIntervalMs?

Die Konstruktor-Optionen, die das Verbindungsverhalten steuern - sessionId, requestPollingIntervalMs, enableExtendedGiftInfo und ähnliche -, werden akzeptiert und weitergereicht. Optionen, die nicht mehr gelten (wie processInitialData), werden stillschweigend ignoriert, damit du dein Config-Objekt nicht aufräumen musst.

TTLC funktioniert manchmal ohne API-Key. Brauche ich für TikTool einen?

Ja - ein signApiKey ist erforderlich. Den kostenlosen Sandbox-Key bekommst du in 30 Sekunden auf tik.tools/login, ohne Kreditkarte. Sandbox enthält 5.000 API-Aufrufe/Tag und 3 gleichzeitige WebSocket-Verbindungen, das reicht für Entwicklung und Tests.

Was passiert eigentlich, wenn TikTok sein Protokoll aktualisiert?

Bei TTLC führen TikToks regelmäßige Updates am Signatur-Algorithmus und am Protobuf-Schema dazu, dass die Bibliothek nicht mehr funktioniert - manchmal schon Stunden nach einem TikTok-Deploy, ohne Fix, bis der Open-Source-Maintainer sie patcht. Bei TikTool werden Protokoll-Updates auf unseren gemanagten Servern erledigt. Dein Code merkt nichts davon; die Events kommen weiter an.

Bonus: Features, die TTLC nicht hat

🔍

Live Feed Discovery

Such und entdecke, wer gerade auf TikTok live ist. Filter nach Sprache, Region und Zuschauerzahl.

🐍

Python SDK

Vollständiges Python SDK verfügbar: pip install tiktok-live-api. Dieselbe API, dieselben Events, andere Sprache.

Bereit für die Migration?

Hol dir einen kostenlosen API-Key - keine Kreditkarte nötig. Der Sandbox-Tarif enthält 5.000 Anfragen/Tag und 3 gleichzeitige WebSocket-Verbindungen - kostenlos, nur für Entwicklung und Evaluierung.