Πέρασε από το TikTok-Live-Connector σε δευτερόλεπτα
Χρησιμοποιείς ήδη το tiktok-live-connector; Πέρασε στο managed TikTool API αλλάζοντας μία μόνο γραμμή import. Ίδια ονόματα events, ίδιες μέθοδοι, καμία αλλαγή στον κώδικα.
Εγκατάστησε το SDK
npm install @tiktool/liveΆλλαξε μία γραμμή import
const { WebcastPushConnection } = require('tiktok-live-connector');const { WebcastPushConnection } = require('@tiktool/live');Χρησιμοποίησε το API key σου από το TikTools
signApiKey: 'EULER_API_KEY'signApiKey: 'TIKTOOL_API_KEY'Πάρε δωρεάν key στο tik.tools - χωρίς πιστωτική κάρτα.
Πλήρες παράδειγμα που δουλεύει
Αυτός ο κώδικας τρέχει ακριβώς το ίδιο με το tiktok-live-connector και με το @tiktool/live. Αλλάζει μόνο το 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();100% συμβατότητα ονομάτων events
Κάθε όνομα event του TTLC δουλεύει ακριβώς το ίδιο. Ταυτόχρονα στέλνουμε και το native όνομα του TikTools.
| Όνομα event TTLC | Κατάσταση | Σημειώσεις |
|---|---|---|
chat | ✓ | Ίδιο |
member | ✓ | Ίδιο |
gift | ✓ | Ίδιο |
like | ✓ | Ίδιο |
follow | ✓ | Ίδιο |
share | ✓ | Ίδιο |
subscribe | ✓ | Ίδιο |
social | ✓ | Ίδιο |
roomUser | ✓ | Alias για το roomUserSeq - στέλνονται και τα δύο |
questionNew | ✓ | Alias για το question - στέλνονται και τα δύο |
linkMicBattle | ✓ | Alias για το battle - στέλνονται και τα δύο |
linkMicArmies | ✓ | Alias για το battleArmies - στέλνονται και τα δύο |
emote | ✓ | Alias για το emoteChat - στέλνονται και τα δύο |
envelope | ✓ | Ίδιο |
liveIntro | ✓ | Ίδιο |
roomPin | ✓ | Ίδιο |
barrage | ✓ | Ίδιο |
superFan | ✓ | Νέο στην 2.0.8 - υποστηρίζεται |
superFanJoin | ✓ | Νέο στην 2.0.8 - υποστηρίζεται |
superFanBox | ✓ | Νέο στην 2.0.8 - υποστηρίζεται |
connected | ✓ | Ίδιο |
disconnected | ✓ | Ίδιο |
error | ✓ | Ίδιο |
streamEnd | ✓ | Ίδιο |
rawData | ✓ | Στέλνεται με το πλήρες raw payload του event |
websocketConnected | ✓ | Στέλνεται όταν ανοίγει το WS |
Γιατί να περάσεις στο managed API;
Δεν χαλάει ποτέ
Το TikTok ενημερώνει τακτικά το πρωτόκολλό του και χαλάει τις απευθείας ενσωματώσεις. Το TikTool χειρίζεται όλες τις αλλαγές πρωτοκόλλου για σένα - μηδενικό downtime.
Πιο γρήγορη παράδοση events
Latency events κάτω από 50 ms μέσα από τη βελτιστοποιημένη υποδομή μας. Χωρίς αποκωδικοποίηση protobuf από τη μεριά σου.
Μηδενικά dependencies
Χωρίς protobufjs, χωρίς ws-client, χωρίς υπογραφή HTTP. Μόνο ένα πακέτο npm χωρίς εξωτερικά dependencies.
Αυτόματη επανασύνδεση
Ενσωματωμένη επανασύνδεση με exponential backoff. Η σύνδεσή σου αντέχει τις μικροδιακοπές δικτύου και τις επανεκκινήσεις των servers του TikTok.
Dashboard χρήσης
Παρακολούθησε τη χρήση του API, τις συνδέσεις WebSocket και τον όγκο events σε πραγματικό χρόνο στο tik.tools/dashboard.
Υποστήριξη για developers
Βοήθεια μέσω Discord, email ή του support chat μέσα στην εφαρμογή. Χρόνος απόκρισης κάτω από 4 ώρες.
Συχνές ερωτήσεις
Θα δουλεύουν ακόμα τα TypeScript types μου;
Ναι. Το @tiktool/live έρχεται με πλήρη TypeScript definitions για κάθε payload event - chat, gift, roomUser και όλα τα υπόλοιπα. Αν χρησιμοποιούσες τα types του TTLC που συντηρεί η κοινότητα, τα δικά μας είναι αυστηρότερα και ενημερώνονται σύμφωνα με το πραγματικό protobuf schema του TikTok.
Τι γίνεται με τις επιλογές του TTLC όπως sessionId, processInitialData και requestPollingIntervalMs;
Οι επιλογές του constructor που ελέγχουν τη συμπεριφορά της σύνδεσης - sessionId, requestPollingIntervalMs, enableExtendedGiftInfo και παρόμοιες - γίνονται δεκτές και προωθούνται. Οι επιλογές που δεν ισχύουν πια (όπως το processInitialData) αγνοούνται σιωπηλά, οπότε το config object σου δεν χρειάζεται καθάρισμα.
Το TTLC μερικές φορές δουλεύει χωρίς API key. Χρειάζομαι ένα για το TikTool;
Ναι - απαιτείται signApiKey. Το δωρεάν Sandbox key το παίρνεις σε 30 δευτερόλεπτα στο tik.tools/login, χωρίς πιστωτική κάρτα. Το Sandbox περιλαμβάνει 5.000 κλήσεις API/ημέρα και 3 ταυτόχρονες συνδέσεις WebSocket, αρκετά για ανάπτυξη και έλεγχο.
Τι ακριβώς γίνεται όταν το TikTok ενημερώνει το πρωτόκολλό του;
Με το TTLC, οι περιοδικές ενημερώσεις του αλγορίθμου υπογραφής και του protobuf schema του TikTok κάνουν τη βιβλιοθήκη να σταματά να δουλεύει - μερικές φορές μέσα σε λίγες ώρες από ένα deploy του TikTok, χωρίς λύση μέχρι να το διορθώσει ο maintainer του open-source έργου. Με το TikTool, οι ενημερώσεις πρωτοκόλλου αντιμετωπίζονται στους managed servers μας. Ο κώδικάς σου δεν βλέπει καμία αλλαγή και τα events συνεχίζουν να έρχονται.
Bonus: Λειτουργίες που δεν έχει το TTLC
Ανακάλυψη Live Feed
Αναζήτησε και ανακάλυψε ποιος είναι live στο TikTok αυτή τη στιγμή. Φιλτράρισμα ανά γλώσσα, περιοχή και αριθμό θεατών.
Python SDK
Διαθέσιμο πλήρες Python SDK: pip install tiktok-live-api. Ίδιο API, ίδια events, άλλη γλώσσα.
Ξεκινάμε τη μετάβαση;
Πάρε δωρεάν API key - χωρίς πιστωτική κάρτα. Το πακέτο Sandbox περιλαμβάνει 5.000 requests/ημέρα και 3 ταυτόχρονες συνδέσεις WebSocket - δωρεάν, μόνο για ανάπτυξη και αξιολόγηση.