Tek Adımda Geçiş

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.

1

SDK'yı kur

npm install @tiktool/live
2

Tek bir import satırını değiştir

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

TikTools API anahtarını kullan

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

tik.tools adresinden ücretsiz anahtar al - kredi kartı gerekmez.

✅
Hepsi bu. Mevcut tüm olay işleyicilerin aynen çalışır - chat, gift, member, roomUser, like, follow, share, emote, linkMicBattle, linkMicArmies, questionNew, getState(), connect(), disconnect().

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ıDurumNotlar
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.