انتقل من TikTok-Live-Connector في ثوانٍ
تستخدم tiktok-live-connector بالفعل؟ انتقل إلى TikTool API المُدار بتغيير سطر استيراد واحد. نفس أسماء الأحداث، ونفس الدوال، وبدون أي تغيير في الكود.
ثبّت SDK
npm install @tiktool/liveغيّر سطر استيراد واحدًا
const { WebcastPushConnection } = require('tiktok-live-connector');const { WebcastPushConnection } = require('@tiktool/live');استخدم مفتاح TikTools API الخاص بك
signApiKey: 'EULER_API_KEY'signApiKey: 'TIKTOOL_API_KEY'احصل على مفتاح مجاني من tik.tools - بدون بطاقة ائتمان.
مثال عملي كامل
هذا الكود يعمل بالطريقة نفسها مع tiktok-live-connector و @tiktool/live. يتغير الاستيراد فقط.
// 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% في أسماء الأحداث
كل أسماء أحداث TTLC تعمل كما هي تمامًا. ونرسل أيضًا الاسم الأصلي في TikTools في الوقت نفسه.
| اسم الحدث في TTLC | الحالة | ملاحظات |
|---|---|---|
chat | ✓ | مطابق |
member | ✓ | مطابق |
gift | ✓ | مطابق |
like | ✓ | مطابق |
follow | ✓ | مطابق |
share | ✓ | مطابق |
subscribe | ✓ | مطابق |
social | ✓ | مطابق |
roomUser | ✓ | اسم بديل لـ roomUserSeq - يُرسل الاثنان |
questionNew | ✓ | اسم بديل لـ question - يُرسل الاثنان |
linkMicBattle | ✓ | اسم بديل لـ battle - يُرسل الاثنان |
linkMicArmies | ✓ | اسم بديل لـ battleArmies - يُرسل الاثنان |
emote | ✓ | اسم بديل لـ emoteChat - يُرسل الاثنان |
envelope | ✓ | مطابق |
liveIntro | ✓ | مطابق |
roomPin | ✓ | مطابق |
barrage | ✓ | مطابق |
superFan | ✓ | جديد في 2.0.8 - مدعوم |
superFanJoin | ✓ | جديد في 2.0.8 - مدعوم |
superFanBox | ✓ | جديد في 2.0.8 - مدعوم |
connected | ✓ | مطابق |
disconnected | ✓ | مطابق |
error | ✓ | مطابق |
streamEnd | ✓ | مطابق |
rawData | ✓ | يُرسل مع بيانات الحدث الخام كاملة |
websocketConnected | ✓ | يُرسل عند فتح WS |
لماذا تنتقل إلى API المُدار؟
لا يتعطل أبدًا
يحدّث TikTok بروتوكوله بانتظام، فتتعطل عمليات الربط المباشرة. يتولى TikTool كل تغييرات البروتوكول عنك - بدون أي توقف.
توصيل أسرع للأحداث
زمن استجابة للأحداث أقل من 50ms عبر بنيتنا المحسّنة. بدون فك ترميز protobuf من جهتك.
بدون اعتماديات
بدون protobufjs، وبدون ws-client، وبدون توقيع HTTP. حزمة npm واحدة فقط بلا أي اعتماديات خارجية.
إعادة اتصال تلقائية
إعادة اتصال مدمجة بتأخير تصاعدي. يصمد اتصالك أمام انقطاعات الشبكة القصيرة وإعادة تشغيل خوادم TikTok.
لوحة الاستخدام
راقب استخدامك لـ API واتصالات WebSocket وحجم الأحداث لحظيًا على tik.tools/dashboard.
دعم المطورين
احصل على المساعدة عبر Discord أو البريد أو دردشة الدعم داخل التطبيق. وقت الرد أقل من 4 ساعات.
أسئلة شائعة
هل ستبقى أنواع TypeScript تعمل؟
نعم. تأتي @tiktool/live بتعريفات TypeScript كاملة لكل بيانات الأحداث - chat و gift و roomUser وكل البقية. وإذا كنت تستخدم أنواع TTLC التي يصونها المجتمع، فأنواعنا أدق وتُحدَّث باستمرار وفق مخطط protobuf الفعلي في TikTok.
ماذا عن خيارات TTLC مثل sessionId و processInitialData و requestPollingIntervalMs؟
خيارات المُنشئ التي تتحكم في سلوك الاتصال - sessionId و requestPollingIntervalMs و enableExtendedGiftInfo وما شابهها - مقبولة وتُمرَّر. أما الخيارات التي لم تعد تنطبق (مثل processInitialData) فتُتجاهل بصمت، فلا يحتاج كائن الإعدادات إلى أي تنظيف.
يعمل TTLC أحيانًا بدون مفتاح API. هل أحتاج إلى مفتاح لـ TikTool؟
نعم - يلزم signApiKey. الحصول على مفتاح Sandbox المجاني يستغرق 30 ثانية من tik.tools/login بدون بطاقة ائتمان. يشمل Sandbox عدد 5,000 طلب API يوميًا و 3 اتصالات WebSocket متزامنة، وهذا يكفي للتطوير والاختبار.
ماذا يحدث فعلًا عندما يحدّث TikTok بروتوكوله؟
مع TTLC، تؤدي التحديثات الدورية لخوارزمية التوقيع ومخطط protobuf في TikTok إلى توقف المكتبة عن العمل - أحيانًا خلال ساعات من تحديث TikTok، ولا إصلاح حتى يرقّعها مشرف المشروع مفتوح المصدر. مع TikTool، تُعالَج تحديثات البروتوكول على خوادمنا المُدارة. لا يرى كودك أي تغيير، وتستمر الأحداث في الوصول.
إضافة: ميزات لا يملكها TTLC
Live Feed Discovery
ابحث واكتشف من يبث الآن على TikTok. صفِّ حسب اللغة والمنطقة وعدد المشاهدين.
Python SDK
Python SDK كامل متاح: pip install tiktok-live-api. نفس API، ونفس الأحداث، بلغة مختلفة.
جاهز للانتقال؟
احصل على مفتاح API مجاني - بدون بطاقة ائتمان. تشمل باقة Sandbox عدد 5,000 طلب يوميًا و 3 اتصالات WebSocket متزامنة - مجانًا، للتطوير والتقييم فقط.