Saldi di Halloween: Agency Global a $266/mese con fatturazione annuale. Paghi 8 mesi, ne hai 12. Termina il 31 ott.

Termina traL'offerta termina tra 7 giorni, 13 ore e 41 minutiApprofitta dell'offerta
Migrazione in un passo

Passa da TikTok-Live-Connector in pochi secondi

Usi già tiktok-live-connector? Passa all'API gestita di TikTool cambiando una sola riga di import. Stessi nomi degli eventi, stessi metodi, nessuna modifica al codice.

1

Installa l'SDK

npm install @tiktool/live
2

Cambia una riga di import

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

Usa la tua chiave API TikTools

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

Ottieni una chiave gratuita su tik.tools - nessuna carta di credito richiesta.

✅
Fatto. Tutti i tuoi gestori di eventi esistenti funzionano esattamente come prima - chat, gift, member, roomUser, like, follow, share, emote, linkMicBattle, linkMicArmies, questionNew, getState(), connect(), disconnect().

Esempio completo funzionante

Questo codice funziona allo stesso modo sia con tiktok-live-connector sia con @tiktool/live. Cambia solo l'import.

// 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();

Compatibilità al 100% dei nomi degli eventi

Ogni nome di evento TTLC funziona esattamente allo stesso modo. In parallelo emettiamo anche il nome nativo TikTools.

Nome evento TTLCStatoNote
chat✓Identico
member✓Identico
gift✓Identico
like✓Identico
follow✓Identico
share✓Identico
subscribe✓Identico
social✓Identico
roomUser✓Alias di roomUserSeq - vengono emessi entrambi
questionNew✓Alias di question - vengono emessi entrambi
linkMicBattle✓Alias di battle - vengono emessi entrambi
linkMicArmies✓Alias di battleArmies - vengono emessi entrambi
emote✓Alias di emoteChat - vengono emessi entrambi
envelope✓Identico
liveIntro✓Identico
roomPin✓Identico
barrage✓Identico
superFan✓Nuovo in 2.0.8 - supportato
superFanJoin✓Nuovo in 2.0.8 - supportato
superFanBox✓Nuovo in 2.0.8 - supportato
connected✓Identico
disconnected✓Identico
error✓Identico
streamEnd✓Identico
rawData✓Emesso con il payload grezzo completo dell'evento
websocketConnected✓Emesso all'apertura del WS

Perché passare all'API gestita?

🛡️

Non si rompe mai

TikTok aggiorna spesso il suo protocollo, mandando in tilt le integrazioni dirette. TikTool gestisce per te tutte le modifiche al protocollo - zero tempi di inattività.

⚡

Eventi consegnati più in fretta

Latenza degli eventi sotto i 50 ms grazie alla nostra infrastruttura ottimizzata. Nessuna decodifica protobuf da parte tua.

🧩

Zero dipendenze

Niente protobufjs, niente ws-client, niente firma HTTP. Un solo pacchetto npm senza dipendenze esterne.

🔄

Riconnessione automatica

Riconnessione integrata con backoff esponenziale. La tua connessione sopravvive ai cali di rete e ai riavvii dei server di TikTok.

📊

Dashboard di utilizzo

Monitora in tempo reale l'uso dell'API, le connessioni WebSocket e il volume di eventi su tik.tools/dashboard.

💬

Supporto per sviluppatori

Ricevi aiuto su Discord, via email o nella chat di supporto dell'app. Tempo di risposta inferiore a 4 ore.

Domande frequenti

I miei tipi TypeScript funzioneranno ancora?

Sì. @tiktool/live include definizioni TypeScript complete per ogni payload di evento - chat, gift, roomUser e tutti gli altri. Se usavi i tipi di TTLC mantenuti dalla community, i nostri sono più rigorosi e sempre allineati allo schema protobuf effettivo di TikTok.

E le opzioni di TTLC come sessionId, processInitialData e requestPollingIntervalMs?

Le opzioni del costruttore che controllano il comportamento della connessione - sessionId, requestPollingIntervalMs, enableExtendedGiftInfo e simili - vengono accettate e inoltrate. Le opzioni non più applicabili (come processInitialData) vengono ignorate in silenzio, così non devi ripulire il tuo oggetto di configurazione.

TTLC a volte funziona senza chiave API. Per TikTool ne serve una?

Sì - serve una signApiKey. La chiave Sandbox gratuita si ottiene in 30 secondi su tik.tools/login, senza carta di credito. Sandbox include 5.000 chiamate API al giorno e 3 connessioni WebSocket simultanee, sufficienti per sviluppo e test.

Cosa succede davvero quando TikTok aggiorna il suo protocollo?

Con TTLC, gli aggiornamenti periodici dell'algoritmo di firma e dello schema protobuf di TikTok fanno smettere di funzionare la libreria - a volte poche ore dopo un rilascio di TikTok, senza soluzione finché il manutentore open source non la corregge. Con TikTool, gli aggiornamenti del protocollo vengono gestiti sui nostri server gestiti. Il tuo codice non nota alcun cambiamento; gli eventi continuano ad arrivare.

Bonus: funzioni che TTLC non ha

🔍

Scoperta delle dirette

Cerca e scopri chi è in diretta su TikTok in questo momento. Filtra per lingua, regione e numero di spettatori.

🐍

SDK Python

SDK Python completo disponibile: pip install tiktok-live-api. Stessa API, stessi eventi, linguaggio diverso.

Pronto a migrare?

Ottieni una chiave API gratuita - nessuna carta di credito richiesta. Il piano Sandbox include 5.000 richieste al giorno e 3 connessioni WebSocket simultanee - gratis, solo per sviluppo e valutazione.