Treci de la TikTok-Live-Connector în câteva secunde
Folosești deja tiktok-live-connector? Treci la API-ul administrat TikTool schimbând o singură linie de import. Aceleași nume de evenimente, aceleași metode, zero modificări de cod.
Instalează SDK-ul
npm install @tiktool/liveSchimbă o singură linie de import
const { WebcastPushConnection } = require('tiktok-live-connector');const { WebcastPushConnection } = require('@tiktool/live');Folosește cheia ta API TikTools
signApiKey: 'EULER_API_KEY'signApiKey: 'TIKTOOL_API_KEY'Obține o cheie gratuită la tik.tools - fără card de credit.
Exemplu complet funcțional
Acest cod rulează identic atât cu tiktok-live-connector, cât și cu @tiktool/live. Se schimbă doar importul.
// 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();Compatibilitate 100% a numelor de evenimente
Fiecare nume de eveniment TTLC funcționează exact la fel. Emitem simultan și numele nativ TikTools.
| Nume eveniment TTLC | Stare | Note |
|---|---|---|
chat | ✓ | Identic |
member | ✓ | Identic |
gift | ✓ | Identic |
like | ✓ | Identic |
follow | ✓ | Identic |
share | ✓ | Identic |
subscribe | ✓ | Identic |
social | ✓ | Identic |
roomUser | ✓ | Alias pentru roomUserSeq - se emit ambele |
questionNew | ✓ | Alias pentru question - se emit ambele |
linkMicBattle | ✓ | Alias pentru battle - se emit ambele |
linkMicArmies | ✓ | Alias pentru battleArmies - se emit ambele |
emote | ✓ | Alias pentru emoteChat - se emit ambele |
envelope | ✓ | Identic |
liveIntro | ✓ | Identic |
roomPin | ✓ | Identic |
barrage | ✓ | Identic |
superFan | ✓ | Nou în 2.0.8 - suportat |
superFanJoin | ✓ | Nou în 2.0.8 - suportat |
superFanBox | ✓ | Nou în 2.0.8 - suportat |
connected | ✓ | Identic |
disconnected | ✓ | Identic |
error | ✓ | Identic |
streamEnd | ✓ | Identic |
rawData | ✓ | Se emite cu payload-ul brut complet al evenimentului |
websocketConnected | ✓ | Se emite la deschiderea WS |
De ce să treci la API-ul administrat?
Nu se strică niciodată
TikTok își actualizează protocolul regulat, iar integrările directe se strică. TikTool gestionează pentru tine toate schimbările de protocol - zero întreruperi.
Livrare mai rapidă a evenimentelor
Latență a evenimentelor sub 50 ms prin infrastructura noastră optimizată. Fără decodare protobuf la tine.
Zero dependențe
Fără protobufjs, fără ws-client, fără semnare HTTP. Doar un pachet npm, fără dependențe externe.
Reconectare automată
Reconectare integrată cu backoff exponențial. Conexiunea ta rezistă la scurte căderi de rețea și la repornirile serverelor TikTok.
Panou de utilizare
Urmărește în timp real utilizarea API, conexiunile WebSocket și volumul de evenimente la tik.tools/dashboard.
Suport pentru dezvoltatori
Primește ajutor pe Discord, prin email sau în chatul de suport din aplicație. Timp de răspuns sub 4 ore.
Întrebări frecvente
Tipurile mele TypeScript vor funcționa în continuare?
Da. @tiktool/live include definiții TypeScript complete pentru fiecare payload de eveniment - chat, gift, roomUser și toate celelalte. Dacă foloseai tipurile întreținute de comunitate pentru TTLC, ale noastre sunt mai stricte și sunt ținute la zi cu schema protobuf reală a TikTok.
Ce se întâmplă cu opțiunile TTLC precum sessionId, processInitialData și requestPollingIntervalMs?
Opțiunile constructorului care controlează comportamentul conexiunii - sessionId, requestPollingIntervalMs, enableExtendedGiftInfo și altele similare - sunt acceptate și transmise mai departe. Opțiunile care nu se mai aplică (precum processInitialData) sunt ignorate fără avertisment, așa că nu trebuie să-ți cureți obiectul de configurare.
TTLC funcționează uneori fără cheie API. Am nevoie de una pentru TikTool?
Da - este necesară o signApiKey. Cheia Sandbox gratuită se obține în 30 de secunde la tik.tools/login, fără card de credit. Sandbox include 5.000 de apeluri API/zi și 3 conexiuni WebSocket simultane, suficient pentru dezvoltare și testare.
Ce se întâmplă de fapt când TikTok își actualizează protocolul?
Cu TTLC, actualizările periodice ale algoritmului de semnătură și ale schemei protobuf de la TikTok fac ca biblioteca să nu mai funcționeze - uneori la câteva ore după un deploy TikTok, fără nicio remediere până când întreținătorul open-source o corectează. Cu TikTool, actualizările de protocol sunt gestionate pe serverele noastre. Codul tău nu observă nicio schimbare; evenimentele continuă să sosească.
Bonus: funcții pe care TTLC nu le are
Descoperire în fluxul LIVE
Caută și descoperă cine este LIVE acum pe TikTok. Filtrează după limbă, regiune și număr de spectatori.
SDK Python
SDK Python complet disponibil: pip install tiktok-live-api. Același API, aceleași evenimente, alt limbaj.
Gata de migrare?
Obține o cheie API gratuită - fără card de credit. Planul Sandbox include 5.000 de cereri/zi și 3 conexiuni WebSocket simultane - gratuit, doar pentru dezvoltare și evaluare.