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.
Installa l'SDK
npm install @tiktool/liveCambia una riga di import
const { WebcastPushConnection } = require('tiktok-live-connector');const { WebcastPushConnection } = require('@tiktool/live');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.
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 TTLC | Stato | Note |
|---|---|---|
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.