TikTok-Live-Connector'dan Saniyeler İçinde geç
Zaten tiktok-live-connector kullanıyor musun? Tek bir import satırını değiştirerek yönetilen TikTool API'sine geç. Aynı olay adları, aynı metotlar, sıfır kod değişikliği.
SDK'yı kur
npm install @tiktool/liveTek bir import satırını değiştir
const { WebcastPushConnection } = require('tiktok-live-connector');const { WebcastPushConnection } = require('@tiktool/live');TikTools API anahtarını kullan
signApiKey: 'EULER_API_KEY'signApiKey: 'TIKTOOL_API_KEY'tik.tools adresinden ücretsiz anahtar al - kredi kartı gerekmez.
Tam Çalışan Örnek
Bu kod hem tiktok-live-connector hem @tiktool/live ile aynen çalışır. Yalnızca import değişir.
// 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 Olay Adı Uyumluluğu
Her TTLC olay adı aynen çalışır. Ayrıca yerel TikTools adını da aynı anda tetikleriz.
| TTLC Olay Adı | Durum | Notlar |
|---|---|---|
chat | ✓ | Aynı |
member | ✓ | Aynı |
gift | ✓ | Aynı |
like | ✓ | Aynı |
follow | ✓ | Aynı |
share | ✓ | Aynı |
subscribe | ✓ | Aynı |
social | ✓ | Aynı |
roomUser | ✓ | roomUserSeq için takma ad - ikisi de tetiklenir |
questionNew | ✓ | question için takma ad - ikisi de tetiklenir |
linkMicBattle | ✓ | battle için takma ad - ikisi de tetiklenir |
linkMicArmies | ✓ | battleArmies için takma ad - ikisi de tetiklenir |
emote | ✓ | emoteChat için takma ad - ikisi de tetiklenir |
envelope | ✓ | Aynı |
liveIntro | ✓ | Aynı |
roomPin | ✓ | Aynı |
barrage | ✓ | Aynı |
superFan | ✓ | 2.0.8 sürümünde yeni - destekleniyor |
superFanJoin | ✓ | 2.0.8 sürümünde yeni - destekleniyor |
superFanBox | ✓ | 2.0.8 sürümünde yeni - destekleniyor |
connected | ✓ | Aynı |
disconnected | ✓ | Aynı |
error | ✓ | Aynı |
streamEnd | ✓ | Aynı |
rawData | ✓ | Tam ham olay verisiyle tetiklenir |
websocketConnected | ✓ | WS açıldığında tetiklenir |
Neden Yönetilen API'ye Geçmeli?
Asla Bozulmaz
TikTok protokolünü düzenli olarak günceller ve bu doğrudan entegrasyonları bozar. TikTool tüm protokol değişikliklerini senin yerine halleder - sıfır kesinti.
Daha Hızlı Olay İletimi
Optimize altyapımız sayesinde 50 ms altı olay gecikmesi. Senin tarafında protobuf çözümleme yok.
Sıfır Bağımlılık
protobufjs yok, ws-client yok, HTTP imzalama yok. Hiçbir harici bağımlılığı olmayan tek bir npm paketi.
Otomatik Yeniden Bağlanma
Yerleşik, üstel bekleme süreli yeniden bağlanma. Bağlantın ağ kesintilerini ve TikTok sunucu yeniden başlatmalarını atlatır.
Kullanım Paneli
API kullanımını, WebSocket bağlantılarını ve olay hacmini tik.tools/dashboard adresinde anlık izle.
Geliştirici Desteği
Discord, e-posta ya da uygulama içi destek sohbeti üzerinden yardım al. Yanıt süresi 4 saatin altında.
Sık Sorulan Sorular
TypeScript tiplerim çalışmaya devam edecek mi?
Evet. @tiktool/live, her olay verisi için tam TypeScript tanımlarıyla gelir - chat, gift, roomUser ve diğerleri. TTLC'nin topluluk tarafından sürdürülen tiplerini kullanıyorsan, bizimkiler daha katıdır ve TikTok'un gerçek protobuf şemasıyla güncel tutulur.
sessionId, processInitialData ve requestPollingIntervalMs gibi TTLC seçenekleri ne olacak?
Bağlantı davranışını kontrol eden kurucu seçenekleri - sessionId, requestPollingIntervalMs, enableExtendedGiftInfo ve benzerleri - kabul edilir ve iletilir. Artık geçerli olmayan seçenekler (processInitialData gibi) sessizce yok sayılır; böylece yapılandırma nesneni temizlemen gerekmez.
TTLC bazen API anahtarı olmadan çalışıyor. TikTool için anahtar gerekli mi?
Evet - bir signApiKey gerekir. Ücretsiz Sandbox anahtarını tik.tools/login adresinden kredi kartı olmadan 30 saniyede alırsın. Sandbox günde 5.000 API çağrısı ve 3 eşzamanlı WebSocket bağlantısı içerir; geliştirme ve test için yeterlidir.
TikTok protokolünü güncellediğinde aslında ne oluyor?
TTLC'de TikTok'un periyodik imza algoritması ve protobuf şeması güncellemeleri kütüphanenin çalışmasını durdurur - bazen bir TikTok güncellemesinden birkaç saat sonra ve açık kaynak geliştiricisi yamayı çıkarana kadar çözümsüz. TikTool'da protokol güncellemeleri yönetilen sunucularımızda halledilir. Kodun hiçbir değişiklik görmez; olaylar gelmeye devam eder.
Bonus: TTLC'de Olmayan Özellikler
Canlı Yayın Keşfi
TikTok'ta şu anda kimin canlı olduğunu ara ve keşfet. Dile, bölgeye ve izleyici sayısına göre filtrele.
Python SDK
Tam Python SDK mevcut: pip install tiktok-live-api. Aynı API, aynı olaylar, farklı dil.
Geçişe Hazır mısın?
Ücretsiz API anahtarı al - kredi kartı gerekmez. Sandbox planı günde 5.000 istek ve 3 eşzamanlı WebSocket bağlantısı içerir - ücretsiz, yalnızca geliştirme ve değerlendirme için.