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.
Cài SDK
npm install @tiktool/liveĐổi một dòng import
const { WebcastPushConnection } = require('tiktok-live-connector');const { WebcastPushConnection } = require('@tiktool/live');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í 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 TTLC | Trạng thái | Ghi 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á.