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.
SDK installieren
npm install @tiktool/liveEine Import-Zeile ändern
const { WebcastPushConnection } = require('tiktok-live-connector');const { WebcastPushConnection } = require('@tiktool/live');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.
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-Name | Status | Hinweise |
|---|---|---|
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.