Migrasi Satu Langkah

Pindah dari TikTok-Live-Connector dalam Hitungan Detik

Sudah pakai tiktok-live-connector? Pindah ke API TikTool yang terkelola cukup dengan mengganti satu baris import. Nama event sama, method sama, tanpa perubahan kode.

1

Instal SDK

npm install @tiktool/live
2

Ganti satu baris import

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

Pakai API key TikTools kamu

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

Dapatkan key gratis di tik.tools - tanpa kartu kredit.

✅
Selesai. Semua event handler kamu yang sudah ada tetap bekerja persis sama - chat, gift, member, roomUser, like, follow, share, emote, linkMicBattle, linkMicArmies, questionNew, getState(), connect(), disconnect().

Contoh Lengkap yang Berjalan

Kode ini berjalan persis sama dengan tiktok-live-connector maupun @tiktool/live. Hanya import-nya yang berubah.

// 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% Kompatibel dengan Nama Event

Setiap nama event TTLC bekerja persis sama. Kami juga mengirim nama native TikTools secara bersamaan.

Nama Event TTLCStatusCatatan
chat✓Identik
member✓Identik
gift✓Identik
like✓Identik
follow✓Identik
share✓Identik
subscribe✓Identik
social✓Identik
roomUser✓Alias untuk roomUserSeq - keduanya terkirim
questionNew✓Alias untuk question - keduanya terkirim
linkMicBattle✓Alias untuk battle - keduanya terkirim
linkMicArmies✓Alias untuk battleArmies - keduanya terkirim
emote✓Alias untuk emoteChat - keduanya terkirim
envelope✓Identik
liveIntro✓Identik
roomPin✓Identik
barrage✓Identik
superFan✓Baru di 2.0.8 - didukung
superFanJoin✓Baru di 2.0.8 - didukung
superFanBox✓Baru di 2.0.8 - didukung
connected✓Identik
disconnected✓Identik
error✓Identik
streamEnd✓Identik
rawData✓Terkirim dengan payload event mentah lengkap
websocketConnected✓Terkirim saat WS terbuka

Kenapa Pindah ke API Terkelola?

🛡️

Tidak Pernah Rusak

TikTok rutin memperbarui protokolnya, sehingga integrasi langsung jadi rusak. TikTool menangani semua perubahan protokol untuk kamu - tanpa downtime.

⚡

Pengiriman Event Lebih Cepat

Latensi event di bawah 50ms lewat infrastruktur kami yang teroptimasi. Tidak perlu decoding protobuf di sisi kamu.

🧩

Tanpa Dependensi

Tanpa protobufjs, tanpa ws-client, tanpa signing HTTP. Cukup satu paket npm tanpa dependensi eksternal.

🔄

Sambung Ulang Otomatis

Reconnect bawaan dengan exponential backoff. Koneksi kamu tetap bertahan saat jaringan putus sesaat dan server TikTok restart.

📊

Dasbor Penggunaan

Pantau penggunaan API, koneksi WebSocket, dan volume event kamu secara real-time di tik.tools/dashboard.

💬

Dukungan Developer

Dapatkan bantuan lewat Discord, email, atau chat dukungan di aplikasi. Waktu respons di bawah 4 jam.

Pertanyaan Umum

Apakah tipe TypeScript saya tetap berfungsi?

Ya. @tiktool/live menyertakan definisi TypeScript lengkap untuk setiap payload event - chat, gift, roomUser, dan lainnya. Kalau sebelumnya kamu memakai tipe TTLC yang dikelola komunitas, tipe kami lebih ketat dan selalu mengikuti skema protobuf TikTok yang sebenarnya.

Bagaimana dengan opsi TTLC seperti sessionId, processInitialData, dan requestPollingIntervalMs?

Opsi constructor yang mengatur perilaku koneksi - sessionId, requestPollingIntervalMs, enableExtendedGiftInfo, dan sejenisnya - diterima dan diteruskan. Opsi yang sudah tidak berlaku (seperti processInitialData) diabaikan tanpa peringatan, jadi objek config kamu tidak perlu dibersihkan.

TTLC kadang bisa jalan tanpa API key. Apakah saya butuh key untuk TikTool?

Ya - signApiKey wajib. Key Sandbox gratis bisa didapat dalam 30 detik di tik.tools/login tanpa kartu kredit. Sandbox mencakup 5.000 panggilan API/hari dan 3 koneksi WebSocket bersamaan, cukup untuk development dan pengujian.

Apa yang sebenarnya terjadi saat TikTok memperbarui protokolnya?

Dengan TTLC, pembaruan berkala algoritma signature dan skema protobuf TikTok membuat library berhenti bekerja - kadang hanya beberapa jam setelah TikTok melakukan deploy, tanpa perbaikan sampai maintainer open-source menambalnya. Dengan TikTool, pembaruan protokol ditangani di server terkelola kami. Kode kamu tidak merasakan perubahan apa pun; event tetap berdatangan.

Bonus: Fitur yang Tidak Dimiliki TTLC

🔍

Live Feed Discovery

Cari dan temukan siapa yang sedang live di TikTok. Filter berdasarkan bahasa, wilayah, dan jumlah penonton.

🐍

SDK Python

SDK Python lengkap tersedia: pip install tiktok-live-api. API sama, event sama, bahasa berbeda.

Siap Migrasi?

Dapatkan API key gratis - tanpa kartu kredit. Paket Sandbox mencakup 5.000 request/hari dan 3 koneksi WebSocket bersamaan - gratis, khusus development & evaluasi.