Chuyển đổi một bước

Chuyển từ TikTok-Live-Connector chỉ trong vài giây

Đang dùng tiktok-live-connector? Chuyển sang TikTool API được quản lý chỉ bằng cách đổi một dòng import. Cùng tên sự kiện, cùng phương thức, không phải sửa code.

1

Cài SDK

npm install @tiktool/live
2

Đổi một dòng import

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

Dùng API key TikTools của bạn

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

Nhận key miễn phí tại tik.tools - không cần thẻ tín dụng.

✅
Vậy là xong. Mọi event handler hiện có của bạn chạy y hệt - chat, gift, member, roomUser, like, follow, share, emote, linkMicBattle, linkMicArmies, questionNew, getState(), connect(), disconnect().

Ví dụ chạy được đầy đủ

Đoạn code này chạy y hệt với cả tiktok-live-connector và @tiktool/live. Chỉ dòng import thay đổi.

// 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();

Tương thích 100% tên sự kiện

Mọi tên sự kiện TTLC hoạt động y như cũ. Chúng tôi cũng phát đồng thời tên gốc của TikTools.

Tên sự kiện TTLCTrạng tháiGhi chú
chat✓Giống hệt
member✓Giống hệt
gift✓Giống hệt
like✓Giống hệt
follow✓Giống hệt
share✓Giống hệt
subscribe✓Giống hệt
social✓Giống hệt
roomUser✓Bí danh của roomUserSeq - cả hai đều phát
questionNew✓Bí danh của question - cả hai đều phát
linkMicBattle✓Bí danh của battle - cả hai đều phát
linkMicArmies✓Bí danh của battleArmies - cả hai đều phát
emote✓Bí danh của emoteChat - cả hai đều phát
envelope✓Giống hệt
liveIntro✓Giống hệt
roomPin✓Giống hệt
barrage✓Giống hệt
superFan✓Mới trong 2.0.8 - đã hỗ trợ
superFanJoin✓Mới trong 2.0.8 - đã hỗ trợ
superFanBox✓Mới trong 2.0.8 - đã hỗ trợ
connected✓Giống hệt
disconnected✓Giống hệt
error✓Giống hệt
streamEnd✓Giống hệt
rawData✓Phát kèm toàn bộ payload sự kiện gốc
websocketConnected✓Phát khi WS mở

Vì sao nên chuyển sang API được quản lý?

🛡️

Không bao giờ hỏng

TikTok cập nhật giao thức thường xuyên, làm hỏng các tích hợp trực tiếp. TikTool xử lý mọi thay đổi giao thức cho bạn - không gián đoạn.

⚡

Nhận sự kiện nhanh hơn

Độ trễ sự kiện dưới 50ms nhờ hạ tầng được tối ưu. Bạn không phải tự giải mã protobuf.

🧩

Không phụ thuộc

Không protobufjs, không ws-client, không ký HTTP. Chỉ một package npm, không có phụ thuộc bên ngoài.

🔄

Tự động kết nối lại

Có sẵn cơ chế kết nối lại với exponential backoff. Kết nối của bạn vượt qua các lần chập chờn mạng và khi server TikTok khởi động lại.

📊

Bảng điều khiển mức sử dụng

Theo dõi mức dùng API, kết nối WebSocket và lưu lượng sự kiện theo thời gian thực tại tik.tools/dashboard.

💬

Hỗ trợ lập trình viên

Nhận hỗ trợ qua Discord, email hoặc chat hỗ trợ trong app. Thời gian phản hồi dưới 4 giờ.

Câu hỏi thường gặp

Type TypeScript của tôi có còn dùng được không?

Có. @tiktool/live có đầy đủ định nghĩa TypeScript cho mọi payload sự kiện - chat, gift, roomUser và tất cả các sự kiện khác. Nếu bạn đang dùng type do cộng đồng TTLC duy trì, type của chúng tôi chặt chẽ hơn và luôn được cập nhật theo schema protobuf thực tế của TikTok.

Còn các tùy chọn TTLC như sessionId, processInitialData và requestPollingIntervalMs thì sao?

Các tùy chọn constructor điều khiển hành vi kết nối - sessionId, requestPollingIntervalMs, enableExtendedGiftInfo và tương tự - đều được chấp nhận và chuyển tiếp. Những tùy chọn không còn áp dụng (như processInitialData) được bỏ qua lặng lẽ nên bạn không cần dọn object cấu hình.

TTLC đôi khi chạy được mà không cần API key. TikTool có cần không?

Có - bắt buộc phải có signApiKey. Key Sandbox miễn phí chỉ mất 30 giây để lấy tại tik.tools/login, không cần thẻ tín dụng. Sandbox có 5.000 lượt gọi API/ngày và 3 kết nối WebSocket đồng thời, đủ cho phát triển và kiểm thử.

Chuyện gì thực sự xảy ra khi TikTok cập nhật giao thức?

Với TTLC, các lần TikTok cập nhật thuật toán chữ ký và schema protobuf định kỳ khiến thư viện ngừng hoạt động - đôi khi chỉ vài giờ sau một lần TikTok triển khai, và không có bản sửa cho tới khi người duy trì mã nguồn mở vá lại. Với TikTool, cập nhật giao thức được xử lý trên server được quản lý của chúng tôi. Code của bạn không thấy gì thay đổi; sự kiện vẫn tiếp tục đến.

Thêm nữa: tính năng TTLC không có

🔍

Khám phá luồng live

Tìm kiếm và khám phá ai đang live trên TikTok. Lọc theo ngôn ngữ, khu vực và số người xem.

🐍

Python SDK

Có Python SDK đầy đủ: pip install tiktok-live-api. Cùng API, cùng sự kiện, khác ngôn ngữ.

Sẵn sàng chuyển đổi?

Nhận API key miễn phí - không cần thẻ tín dụng. Gói Sandbox có 5.000 request/ngày và 3 kết nối WebSocket đồng thời - miễn phí, chỉ dùng để phát triển và đánh giá.