أمر !لعبة مع فئة البث الحالية في بوت الدردشة

من أين يحصل البوت على اسم اللعبة الحالية

عادةً لا يعرض أمر !لعبة التطبيق قيد التشغيل على الحاسوب، بل فئة القناة الحالية على Twitch. يغيّر البث اللعبة أو الفئة من لوحة التحكم بالبث، ويحصل البوت على هذه القيمة عبر متغير مدمج أو طلب إلى API.

إذا بقيت اللعبة السابقة في لوحة Twitch، أو تم اختيار فئة «محادثة»، أو كان الحقل فارغًا، فسيعرض البوت القيمة نفسها. بوت الدردشة بحد ذاته لا يتعرف على اللعبة على الشاشة: فهو يعمل بالبيانات التي ترسلها المنصة أو الأتمتة الخارجية.

حدّث فئة القناة على Twitch أولًا

قبل إعداد الأمر، تحقق من المكان الذي تغيّر فيه الفئة: في لوحة Creator Dashboard، أو عبر برنامج إدارة البث، أو عبر التكامل مع البوت. المهم هو الحالة النهائية للقناة التي يراها المشاهدون على صفحة البث.

بعد تغيير اللعبة لا تتوقع تحديثًا فوريًا في جميع الخدمات. قد يحتفظ البوت بآخر قيمة في الذاكرة المؤقتة، وقد ترسل المنصة البيانات المحدّثة بتأخير. بالنسبة لأمر !لعبة، من الأفضل تغيير الفئة قبل بدء البث والتحقق من الرد في الدردشة بشكل منفصل.

أمر !لعبة في Nightbot

في Nightbot افتح Custom Commands، وأنشئ أمر !لعبة وحدد رسالة بالمتغير الخاص بـ Twitch. للقناة الحالية يُستخدم عادةً هذا الرد: «الآن نلعب: $(twitch game $(channel))».

يستبدل المتغير $(channel) القناة التي تم استدعاء الأمر فيها، بينما يطلب $(twitch game ...) فئتها. إذا كان البوت يخدم عدة قنوات، فهذا الخيار أنسب من كتابة اسم البث يدويًا في كل أمر.

• Command: !لعبة
• Message: الآن نلعب: $(twitch game $(channel))
• Userlevel: Everyone
• Cooldown: اضبط تأخيرًا حتى لا تزدحم الدردشة بالردود المتطابقة

عيب Nightbot هو المنطق المحدود للرد. سيكون من الصعب معالجة فئة فارغة، أو عدة صيغ نصية، أو بيانات من جدولك الخاص دون حلول بديلة إضافية.

أمر الفئة في StreamElements

في StreamElements يُضاف متغير اللعبة الحالية عادةً إلى رد الأمر بصيغة ${game}. في قسم Chat bot أنشئ أمر !لعبة وحدد النص: «اللعبة الحالية: ${game}».

قبل الحفظ تحقق من الأمر في الدردشة بحساب مشاهد. إذا لم يكن البوت متصلًا بالقناة المطلوبة أو لم تُحدَّث فئة القناة، فقد يعيد المتغير قيمة قديمة أو نصًا فارغًا. توجد إعدادات الصلاحيات والتأخير في المكان نفسه، ضمن معاملات الأمر.

• Command: !لعبة
• Response: اللعبة الحالية: ${game}
• Permission: Everyone
• Cooldown: اضبطه بما يناسب نشاط الدردشة

عيب StreamElements هو أن الأمر يعتمد على تكامل الخدمة نفسها مع Twitch. عند فشل التفويض أو تأخر المزامنة لن تتمكن من تصحيح الرد يدويًا دون تعديل الأمر.

كيفية عرض الفئة عبر Streamer.bot

في Streamer.bot من الأنسب بناء الأمر عبر Action. أنشئ إجراءً يحصل على معلومات قناة Twitch ثم يرسل رسالة إلى الدردشة. بعد الأمر الفرعي لجلب بيانات القناة يتوفر عادةً في معاملات الإجراء اسم اللعبة gameName.

في الأمر الفرعي Send Message حدد مثلًا: «الآن نلعب: %gameName%». ثم اربط الـ Action بالأمر !لعبة في قسم Commands. إذا كان اسم المعامل مختلفًا في نسختك من Streamer.bot، فشغّل الإجراء أولًا في وضع الاختبار واطلع على قائمة المعاملات التي أعادها الأمر الفرعي الخاص بـ Twitch.

عيب Streamer.bot هو كثرة الإعداد اليدوي. عليك ربط الأمر والإجراء ووصول البوت إلى الدردشة وتفويض Twitch بنفسك، لذا فإن خطأً في أي مرحلة سيترك الأمر دون رد.

طلب الفئة عبر Twitch API

يمكن لبوت مخصص أو سكربت أو Action في Streamer.bot الحصول على الفئة مباشرة عبر Twitch API. للقيام بذلك، اعرف أولًا المعرّف الرقمي للقناة: الطلب GET https://api.twitch.tv/helix/users?login=اسم_القناة يعيد بيانات المستخدم بما فيها id.

بعد ذلك استخدم الطلب GET https://api.twitch.tv/helix/channels?broadcaster_id=معرّف_القناة. يحتوي رد API على الحقل game_name، وهو اسم الفئة الحالية الذي يمكن إرساله إلى الدردشة ردًا على !لعبة.

يتطلب الطلب ترويستي Client-ID وAuthorization مع رمز الوصول. لا تُدرج الرمز ومعرّف التطبيق في نص الأمر المكشوف أو مستودع عام أو أداة متصفح: يجب تخزين هذه البيانات في إعدادات البوت أو في متغيرات البيئة.

ترتيب إعداد أمر API

1. أنشئ تطبيقًا في لوحة مطوري Twitch واحصل على Client ID.
2. احصل على رمز وصول يتيح قراءة بيانات القناة واحفظه في إعدادات البوت أو السكربت الخاص بك.
3. حدد broadcaster_id للقناة عبر endpoint users باستخدام اسم القناة.
4. أرسل طلبًا إلى endpoint channels مع broadcaster_id.
5. خذ الحقل game_name من الرد وصِغ رسالة للدردشة.
6. إذا كان game_name فارغًا، فأخرج نصًا محايدًا بدلًا من رد فارغ.

لا تستعلم من API عند كل رسالة في الدردشة. من العملي أكثر تحديث القيمة عند أول استدعاء لـ !لعبة، وحفظها طوال مدة تأخير الأمر، وإعادة جلب البيانات بعد انتهاء الذاكرة المؤقتة. بعد تغيير الفئة يدويًا يمكنك إجبار تحديث القيمة بأمر منفصل للمشرفين.

كيفية تحديث الفئة وتجنب الحصول على رد قديم

إذا غيّرت اللعبة أثناء البث، فحدّث الفئة على Twitch أولًا، ثم انتظر حتى تظهر القيمة الجديدة على صفحة القناة، وبعد ذلك فقط تحقق من !لعبة. إذا كان البوت يستخدم ذاكرة مؤقتة، فامسحها أو انتظر الطلب التالي إلى API.

لقناة واحدة يكفي عادةً تحديث الفئة عند استدعاء الأمر بدلًا من تشغيل استعلام دائم. إذا كنت بحاجة إلى مراقبة تلقائية، فاجعل التحقق بفاصل زمني معتدل وراعِ قيود API. الطلبات المتكررة لن تجعل البيانات أدق، لكنها قد تؤدي إلى قيود من جانب المنصة.

عيب النهج المباشر عبر API هو ضرورة متابعة الرمز. بعد إلغاء الوصول أو تغيير كلمة المرور أو تعديل صلاحيات التطبيق أو خطأ في التفويض قد يبدأ الأمر بعرض فئة قديمة أو يتوقف عن الرد.

التعرف على اللعبة على الحاسوب وقيوده

لا تكون أداة التعرف المنفصلة ضرورية إلا عندما لا تتغير فئة Twitch يدويًا. تتابع هذه الأتمتة العملية قيد التشغيل، أو بيانات منصة الألعاب، أو النافذة النشطة، أو القياسات عن بُعد، وتطابق اللعبة مع فئة Twitch وتحدّث القناة عبر API.

بعد ذلك يظل البوت يقرأ فئة Twitch وليس محتوى الشاشة. الأتمتة فقط تغيّر بيانات القناة نيابةً عنك. قد تخطئ إذا كانت اللعبة تعمل عبر مشغّل، أو تُستخدم نسخة المتصفح، أو كان اسم العملية لا يطابق اللعبة، أو انتقل البث إلى برنامج آخر.

عيب التعرف أنه يحتاج إلى إعداد ومراقبة منفصلين. بالنسبة للبثوث التي تتضمن عدة ألعاب وتعديلات ومحاكيات ومشاهد تقنية، غالبًا ما يكون التغيير اليدوي للفئة أكثر موثوقية.

الفئة الفارغة، وعدة ألعاب، والنص اليدوي

ترسل المنصة فئة حالية واحدة فقط. إذا كان البث يتضمن عدة ألعاب، فيجب أن يعرض أمر !لعبة اللعبة الجارية الآن، ومن الأفضل نقل خطة البث إلى أمر منفصل !جدول أو إلى وصف القناة.

للفئة الفارغة جهّز ردًا واضحًا: «لم تُحدد الفئة الحالية بعد» أو «الآن بث حواري». في Nightbot وStreamElements قد يتطلب هذا المعالجة أمرًا منفصلًا أو تغيير النص يدويًا. في سكربت API المخصص يمكنك التحقق مما إذا كان الحقل game_name فارغًا وإدراج بديل احتياطي.

يبقى الأمر اليدوي احتياطيًا عمليًا: «الآن نلعب: اسم اللعبة». العيب واضح — من السهل نسيان تحديثه بعد تغيير اللعبة، وسيحصل المشاهدون على معلومات خاطئة.

الصلاحيات والتأخير والتحقق قبل البث

عادةً يُترك أمر !لعبة الأساسي متاحًا لجميع المشاهدين، لكن مع إضافة cooldown. هذا يقلل تكرار الرسائل المتطابقة عندما يسأل عدة أشخاص عن اللعبة في الوقت نفسه. اترك أمر مسح الذاكرة المؤقتة أو التحديث اليدوي للنص أو إعادة تشغيل الـ Action للمشرفين ومالك القناة.

تحقق من الأمر بعد تغيير البوت أو الرمز أو تكامل Twitch. حتى المتغير الصحيح لن يساعد إذا كان البوت متصلًا بقناة أخرى أو فقد إذن قراءة البيانات.

1. حدد اللعبة أو الفئة المطلوبة في لوحة Twitch.
2. تأكد من ظهور الاسم الجديد على صفحة القناة.
3. تحقق من أن بوت الدردشة متصل بقناتك تحديدًا.
4. استدعِ !لعبة من حساب مشاهد عادي.
5. غيّر الفئة وأعد الاستدعاء بعد تحديث الذاكرة المؤقتة أو تأخير الأمر.
6. تحقق من الرد عند الفئة الفارغة وأثناء البث الحواري.
7. إذا كان API مستخدمًا، فتحقق من صلاحية الرمز وسجل أخطاء الطلب.