إعداد Twitch وEventSub

اختيار وضع مصدر Twitch

إعداد تطبيق سطح المكتب

1. اختر إضافة مصدر (Add source) → Twitch.
2. أدخل اسم تسجيل الدخول لقناة Twitch المستخدم في رابطها. بالنسبة إلى twitch.tv/examplechannel، أدخل examplechannel.
3. اترك WebSocket محددًا لاستخدام مصدر EventSub الأكثر شمولًا. يستخدم Twitch هذا الوضع افتراضيًا حاليًا في التطبيق.
4. اختر تفعيل المصدر (Activate source)، ثم تسجيل الدخول إلى Twitch.
5. وافق على الأذونات المطلوبة وأبقِ نافذة مصدر Twitch مفتوحة.

إعداد EventSub في إضافة المتصفح

1. ثبّت إضافة Social Stream Ninja الحالية وفعّلها.
2. افتح صفحة مصدر Twitch EventSub.
3. استبدل examplechannel في الرابط باسم تسجيل دخول القناة التي تريد مراقبتها.
4. اختر تسجيل الدخول إلى Twitch ووافق على الوصول المطلوب.
5. أبقِ تلك الصفحة مفتوحة. تأكد من صحة حقلي User وChannel قبل اختبار التنبيهات.

https://socialstream.ninja/sources/websocket/twitch.html?channel=CHANNEL_LOGIN

للالتقاط الأساسي بوضع Standard بدلًا من ذلك، افتح صفحة دردشة Twitch العادية أو المنبثقة وأبقِ الدردشة ظاهرة.

ما يطلبه Twitch

يطلب Social Stream رمز مستخدم بالأذونات التي تحتاجها عناصر التحكم والاشتراكات التي يدعمها. منح نطاق لا يجعل الحساب مالك بث أو مشرفًا؛ يظل Twitch يتحقق من دور الحساب في القناة المحددة.

راجع المرجع الرسمي لـ Twitch حول مرجع النطاقات و أنواع اشتراكات EventSub.

الأحداث التي يعالجها المصدر الحالي

• المتابعات: new_follower.
• الاشتراكات: new_subscriber, resub، و subscription_gift.
• Bits: cheer بقيمة تبرع.
• نقاط القناة (Channel Points): reward.
• الغارات (Raids): raid.
• حالة البث والإعلانات: stream_online, stream_offline، و ad_break.
• Hype Train: hype_train تحديثات البداية والتقدم والنهاية.
• الإشراف: تحديثات الحظر وحذف الرسائل عند السماح بذلك.

تتطلب أحداث مشتركي Twitch قناة مؤهلة من فئة Affiliate أو Partner ووصول مالك البث. تتطلب اشتراكات المتابعة والإشراف أن يكون المستخدم المسجّل مالك البث أو مشرفًا مخولًا، حسب الحدث.

لأسماء التنبيهات وحقول الحمولة التي تستخدمها المكونات المستقبلة، راجع دليل توافق الأحداث والتنبيهات و مرجع الأحداث.

الفحوص الأولى عند غياب حدث

1. تأكد من أن صفحة المصدر تعرض القيم الصحيحة للحقلين: المستخدم (User) و القناة.
2. أبقِ صفحة المصدر أو نافذته مفتوحة وتأكد من أن اتصال الدردشة نشط.
3. إذا كانت الدردشة تعمل ولكن المتابعات أو الاشتراكات أو المكافآت لا تعمل، فسجّل الخروج وامنح التفويض مجددًا لمنح النطاقات الحالية.
4. تحقق من أن الحساب المسجّل هو مالك البث أو مشرف مسموح له في تلك القناة.
5. تحقق من استخدام لوحة الإرساء وتراكب التنبيهات معرّف جلسة Social Stream نفسه.
6. استخدم الرسالة التجريبية الوهمية من النافذة المنبثقة أو معاينة Multi Alerts للتمييز بين مشكلات الالتقاط ومشكلات التراكب.