إعداد TikFinity
دليل خطوة بخطوة لربط TikFinity بـ BakoshApp عبر آلية Third-party action — يعمل على خطط Free وPRO.
يستعرض هذا الدليل مسار TikFinity — ربط أحداث TikTok LIVE في BakoshApp عبر آلية Third-party action لـ TikFinity. هذا هو الخيار المجاني ويعمل على أي خطة BakoshApp. للحصول على بديل بدون TikFinity، راجع Native Connector.
ما هو Third-party action
Third-party action نوع إجراء في TikFinity يعيد توجيه حدث TikTok LIVE إلى برنامج خارجي — في حالتنا، BakoshApp:
يلتقط TikFinity الحدث ← يعيد توجيهه إلى BakoshApp ← يشغّل BakoshApp التأثير داخل اللعبة.
يمكنك توجيه أحداث TikTok التالية من خلاله: Gift، Like، Follow، Share، Comment، Join.
كيف يتجمّع كل شيء معاً
- تطلق BakoshApp.
- تطلق TikFinity.
- داخل TikFinity تنشئ مشغّلاً.
- يتم تعيين إجراء المشغّل إلى Third-party action.
- عند حدوث حدث مشاهد، يرسل TikFinity إشارة.
- يستقبل BakoshApp الحدث ويشغّل التأثير المطابق.
يجب أن يكون BakoshApp يعمل قبل اختبار المشغّلات. وإلا فإن TikFinity لا يملك شيئاً ليسلمه إليه.
المتطلبات الأولية
تأكد من أن لديك:
- BakoshApp مثبّت ومسجّل دخوله (راجع التثبيت)
- TikFinity مثبّت ومتصل بـ LIVE الخاص بك (الحالة: Connected)
- TikTok LIVE نشط
- اللعبة المستهدفة قيد التشغيل (إذا كان الإجراء يحتاج إلى لعبة قيد التشغيل)
- لا جدار حماية يحجب التطبيقين
- اتصال إنترنت مستقر
من العادات الجيدة إعادة تشغيل كلا التطبيقين قبل أول تمرير تهيئة.
الخطوة 1 — أنشئ مشغّلاً في TikFinity
- افتح TikFinity.
- اذهب إلى Triggers.
- انقر Add Trigger.
الخطوة 2 — اختر الحدث
اختر نوع حدث TikTok:
- Gift
- Like
- Follow
- Share
- Comment
- Join
مثال: Gift إذا كنت تريد التفاعل مع هدية مشاهد.
الخطوة 3 — عيّن الشروط
يمكنك تضييق المشغّل بـ:
- هدية محددة (مثل Rose أو Galaxy)
- الحد الأدنى للعدد
- الحد الأدنى للقيمة
- أي هدية
- فقط من اسم مستخدم محدد
إذا تركت الشروط فارغة، يُطلق المشغّل على كل حدث من هذا النوع.
الخطوة 4 — أضف إجراءً
- اضغط Add Action.
- اختر Third-party action من القائمة.
تُفتح لوحة الإعدادات.
الخطوة 5 — هيّئ Third-party action
اختر الفئة
ينشر BakoshApp فئاته المتاحة إلى TikFinity تلقائياً — لكن فقط للإجراءات التي لها مشغّل Tikfinity مُعيَّن داخل BakoshApp. الإجراءات بدون مشغّل، أو مع مشغّل غير Tikfinity (Gift، Like، Chat، …) لن تظهر هنا: تتم معالجتها بواسطة Native Connector مباشرة.
تعتمد الفئات على المود النشط:
- GTA V (KOTH / Chaos / Train) — الفئات المشتركة Vehicles، Props، GTA V Other (المعرّفة في
gtav-actions.json) متاحة في جميع أشكال GTA V الثلاثة عبر اقتراض الكتالوج. يضيف كل شكل أيضاً فئاته الخاصة: يضيف KOTH وChaos مجموعاتهما الخاصة بطريقة اللعب، يضيف Train Trainmod (تشغيل/إيقاف، تبديل المسارات، عناصر تحكم السرعة/الصحة). - GTA V Chaos — 7 فئات Chaos (player، NPC، vehicle، screen، time، weather، misc).
- Rust Survival — 16 فئة: weapons، tools، food، medical، traps، resources، animal spawns، player effects.
اختر الإجراء
داخل الفئة المختارة، اختر الإجراء المحدد — على سبيل المثال، استدعاء مركبة، الانتقال، تبديل الطقس، إطلاق تأثير فوضى، أو إطلاق تأثير مؤقت.
استخدم زر Test
تحتوي لوحة Third-party action على زر Test:
- يرسل حدثاً اصطناعياً إلى BakoshApp.
- يتحقق من التكامل من البداية إلى النهاية.
- يؤكد أن التأثير داخل اللعبة يُطلق فعلاً.
اضغط Test مباشرة بعد التهيئة. إذا لم يحدث شيء، تحقق من أن BakoshApp يعمل ومن أن لا جدار حماية يحجب أياً من التطبيقين.
مثال مُطبَّق
الهدف: عندما يرسل مشاهد Galaxy، أطلق انفجاراً بجانب اللاعب.
في TikFinity:
- الحدث: Gift ← Gift Name = Galaxy
- الإجراء: Third-party action ← الفئة = Effects ← الإجراء = Explosion nearby
ثم:
- اضغط Save.
- أكّد أن المشغّل مفعّل.
- اضغط Test.
- تحقق على بث مباشر.
فحص السلامة
أنت مُهيَّأ بشكل صحيح عندما تكون جميع هذه صحيحة:
- حالة TikFinity = Connected إلى LIVE.
- حدث TikTok يطلق المشغّل المطابق في TikFinity.
- BakoshApp يسجّل الحدث الوارد.
- التأثير داخل اللعبة يُشغَّل فعلاً.
إذا فشل أي من الأربعة، أعد فحص الخطوة السابقة.
أخطاء شائعة
لا يحدث شيء
- BakoshApp لا يعمل.
- المشغّل مُوقف.
- هدية خاطئة محددة.
- لا يوجد LIVE نشط.
زر Test لا يفعل شيئاً
- BakoshApp لا يعمل.
- إصدارات التطبيقات غير متزامنة — حدّث كليهما.
- أداة أخرى تعترض الأحداث.
المشغّل يُطلق كثيراً جداً
- لم تُعيَّن شروط.
- أو اخترت Any Gift بالخطأ.
نصائح الاستقرار
- أطلق BakoshApp قبل أن تذهب LIVE.
- لا تغيّر الإعدادات أثناء نشاط LIVE.
- لا تكرر مشغّلات متطابقة.
- اضغط Test أحياناً كاختبار سريع.
- أبقِ كلا التطبيقين محدّثَين.
ما التالي
- راجع المشغّلات للكتالوج الكامل لأنواع المشغّلات داخل BakoshApp.
- على PRO؟ قارن مع Native Connector — لا حاجة إلى TikFinity.
- إذا أساء شيء التصرف، تحقق من أخطاء عامة وقراءة السجلات.