Migrare într-un singur pas

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.

1

Instalează SDK-ul

npm install @tiktool/live
2

Schimbă o singură linie de import

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

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.

✅
Asta e tot. Toate handler-ele de evenimente existente funcționează identic - chat, gift, member, roomUser, like, follow, share, emote, linkMicBattle, linkMicArmies, questionNew, getState(), connect(), disconnect().

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 TTLCStareNote
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.