دليل قائمة الشكر المتحركة

الإعداد الموصى به لمشهد ختامي

استخدم الجمع في الخلفية (Background collection) عندما لا يوجد مصدر متصفح قائمة الشكر إلا في مشهد ختامي أو قد يُزال تحميله أثناء إخفائه. يجمع التطبيق أو الإضافة النشاط أثناء البث، لذلك لا يلزم إبقاء صفحة قائمة الشكر مفتوحة.

أبقِ Social Stream Ninja نشطاً ومصادر الدردشة العادية تلتقط المحتوى طوال البث.
افتح قائمة الشكر المتحركة → التفعيل والتخصيص (Enable and customize).
اختر نمط عرض واضبط وضع التشغيل (Trigger Mode) إلى الجمع في الخلفية (Background collection) قبل بدء البث.
انسخ رابط قائمة الشكر المحدّث وأضفه إلى OBS كمصدر متصفح في مشهدك الختامي.
استخدم اختبار قائمة الشكر (Test credits) أثناء تحميل مصدر المتصفح للتأكد من الاتصال والمظهر.
في نهاية البث، انتقل إلى المشهد الختامي ليحمّل OBS مصدر قائمة الشكر أو يُظهره.
اختر بدء قائمة الشكر (Start Credits)، أو شغّل creditsStart من Stream Deck أو API.

الترتيب مهم: إذا كان OBS يوقف مصدر المتصفح عندما يكون مخفياً، فأظهر المشهد الختامي قبل اختيار بدء قائمة الشكر (Start Credits). يظل الجمع يعمل في وضع الخلفية، لكن يجب أن يكون المصدر متصلاً لتلقي أمر البدء.

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

اختيار وضع التشغيل الصحيح

الوضع	أين يُجمع النشاط	كيف تبدأ القائمة	أفضل استخدام
تلقائي (Auto)	داخل صفحة قائمة الشكر المحمّلة	تلقائياً عندما يُظهر OBS أو المتصفح الصفحة	يبقى المصدر محمّلاً طوال البث
يدوي (Manual)	داخل صفحة قائمة الشكر المحمّلة	زر البدء أو Stream Deck أو API	تبقى الصفحة محمّلة، لكنك تريد توقيت بدء دقيقاً
الجمع في الخلفية (Background collection)	داخل تطبيق Social Stream أو الإضافة	زر البدء أو Stream Deck أو API	مشهد ختامي منفصل أو مصدر يكون مغلقاً أو غير محمّل أثناء البث

اضبط الوضع قبل البث. بيانات صفحة Auto/Manual وبيانات الجمع في الخلفية منفصلة. لا ينقل تغيير الأوضاع أثناء البث الأسماء التي جمعها الوضع الآخر مسبقاً.

ماذا تفعل عناصر التحكم الأربعة

التحكم	النتيجة
بدء قائمة الشكر (Start Credits)	يشغّل القائمة الحقيقية المجمعة. في وضع Auto/Manual، تُزال الإدخالات المعروضة عند انتهاء القائمة ما لم يُفعّل الحفظ أو التكرار. يبقى النشاط الجديد المستقبَل أثناء العرض للتشغيل التالي. تبقى بيانات الخلفية محفوظة حتى إعادة الضبط.
معاينة (Preview)	يشغّل القائمة الحقيقية الحالية دون استهلاكها. استخدمه للتحقق من التخطيط قبل البث المباشر.
اختبار قائمة الشكر (Test credits)	يرسل أمثلة مدمجة لمشاركين وأعضاء ومتبرعين. ولا يضيف إلى القائمة الحقيقية المحفوظة أو يستبدلها أو يمسحها.
إعادة ضبط قائمة الشكر المحفوظة (Reset saved credits)	يمسح قائمة الخلفية المحفوظة ويطلب من صفحة قائمة الشكر المتصلة مسح قائمتها المحلية.

إذا كان اختبار قائمة الشكر (Test credits) يشير إلى عدم وجود مصدر قائمة شكر متصل، فحمّل مصدر متصفح OBS أو أظهره وحاول مجددًا.

من يظهر في القائمة

يمكن لقائمة الشكر التعرّف على المشاركين الملتقطين في الدردشة والعضويات والاشتراكات والنشاط الشبيه بالتبرعات. يحتاج الشخص إلى حدث ملتقط يحمل اسماً ونوع منصة؛ ولا يستطيع Social Stream إدراج المشاهدين الصامتين الذين لا تبلغ المنصة عنهم مطلقاً.

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

مع الترتيب الافتراضي، يضيف كل نشاط ملتقط نقطة واحدة، وتضيف العضوية 50 نقطة، ويضيف كل دولار تبرع بعد توحيد العملة 100 نقطة. تُقسم القائمة إلى داعمين مميزين وداعمين عاديين ومشاركين في البث. فعّل إعطاء الأولوية للتبرعات (Prioritize donations) لاستخدام مجموعات متبرعي البث وأعضاء القناة والمشاركين في البث الأكثر وضوحاً بدلاً من ذلك.

قائمة شكر قياسية تعرض فئة متبرعي البث مع أسماء المتبرعين وشارات الدعم وأيقونات المصادر ومبالغ التبرعات — لحظة متوقفة مؤقتاً من نمط Standard Roll مع تفعيل أولوية التبرعات ومبالغ التبرعات.

الإعداد السريع والمرشحات والبيانات المحفوظة

تكرار الداعمين: يفعّل التكرار وبيانات التراكب المحفوظة والتصفية للداعمين فقط وأولوية التبرعات ومبالغ التبرعات.
المتبرعون فقط: يفعّل التكرار وبيانات التراكب المحفوظة والتصفية للمتبرعين فقط ومبالغ التبرعات.
تضمين الداعمين فقط: يتضمن المتبرعين والأعضاء والمشتركين المعروفين، لكنه يستبعد المشاركين في الدردشة فقط.
تضمين المتبرعين فقط: يتطلب إشارة تبرع ملتقطة.
حفظ قائمة الشكر في هذا التراكب (Save credits list in this overlay): يحفظ بيانات جمع الصفحة في Auto/Manual عبر التحديثات وتبديل المصادر، ويمنع تشغيل Start المكتمل من استهلاك القائمة.
تكرار قائمة الشكر باستمرار: يعيد بدء الحركة ويضم النشاط الذي جُمع حديثاً في الدورة التالية.

يخزن التطبيق أو الإضافة بيانات الجمع في الخلفية للجلسة الحالية بالفعل. تبقى بعد إغلاق صفحة قائمة الشكر وتظل متاحة حتى استخدام إعادة ضبط قائمة الشكر المحفوظة (Reset saved credits) .

تفاصيل إعداد OBS

أكمل خيارات قائمة الشكر أولاً، ثم انسخ رابطها كي يتضمن معاملات URL المحددة.
أضف ذلك الرابط كمصدر متصفح في OBS. يناسب مصدر عادي بحجم 1920 × 1080 أنماط ملء الشاشة.
إذا استخدمت Auto أو Manual، فأبقِ المصدر محمّلاً طوال البث. إعادة استخدام مصدر OBS نفسه في كل مشهد أكثر أماناً من إنشاء نسخ غير مترابطة.
إذا استخدمت الجمع في الخلفية، فقد يكون المصدر غائباً أو غير محمّل أثناء البث. لا يلزم اتصاله إلا قبل إرسال Start أو Preview أو Test.
استخدم المعاينة أو الاختبار للتحقق من حجم الخط والسرعة والفئات والشفافية ورسالة النهاية قبل البث المباشر.

خيار OBS: يوقف «Shutdown source when not visible» الجمع في Auto/Manual لأن أداة الجمع فيهما توجد داخل الصفحة. وهو متوافق مع الجمع في الخلفية ما دمت تُظهر المصدر قبل إرسال أمر البدء.

التحكم عبر Stream Deck وAPI

تتيح إضافة Stream Deck الرسمية إجراءات البدء والمعاينة والاختبار وإعادة الضبط لقائمة الشكر. تتوفر الأوامر نفسها عبر واجهة التحكم عن بُعد API في Social Stream:

الإجراء	مثال HTTP
`creditsStart`	`https://io.socialstream.ninja/SESSION_ID/creditsStart`
`creditsPreview`	`https://io.socialstream.ninja/SESSION_ID/creditsPreview`
`creditsTest`	`https://io.socialstream.ninja/SESSION_ID/creditsTest`
`creditsReset`	`https://io.socialstream.ninja/SESSION_ID/creditsReset`

استبدل SESSION_ID بجلسة Social Stream النشطة. فعّل التحكم في الإضافة عن بُعد عبر API ضمن الإعدادات العامة (Global settings) ← آليات العمل (Mechanics). يجب أن يكون مصدر متصفح قائمة الشكر متصلاً كي تظهر نتائج Start أو Preview أو Test على الشاشة.

فتح لوحة إرساء التحكم في OBS عرض دليل الإعداد

مشكلات شائعة

يعمل الاختبار لكن القائمة الحقيقية فارغة: إدخالات الاختبار مدمجة ولا تثبت جمع النشاط. تأكد من تحديد وضع التشغيل المقصود قبل البث ومن أن مصادر الدردشة كانت تلتقط المحتوى.
لا تظهر عناصر التحكم بعد إعادة فتح الإعدادات: يظهر Start وPreview لوضعي Manual وBackground. أما Auto فيبدأ عند الظهور.
لا يوجد مصدر قائمة شكر متصل: حمّل مصدر OBS أو أظهره، وتأكد من أنه يحمل الرابط المنسوخ الحالي والجلسة، ثم أعد المحاولة.
مشاركون في الدردشة غائبون: يتطلب Auto/Manual بقاء صفحة قائمة الشكر محمّلة. استخدم الجمع في الخلفية للمشهد الختامي المنفصل.
أعضاء أو متبرعون غائبون: تأكد من أن مصدر المنصة أصدر حدث عضوية أو تبرع يحمل اسماً، وأن خياري المتبرعين فقط أو الداعمين فقط لا يستبعدانه.
اختفت الأسماء بعد اكتمال القائمة: فعّل حفظ قائمة الشكر في هذا التراكب (Save credits list in this overlay)، أو استخدم المعاينة، أو وضع الخلفية. يستهلك تشغيل Start العادي الذي يجمع البيانات داخل الصفحة الإدخالات المعروضة عندما يكون الحفظ والتكرار معطّلين.
لا تزال الأسماء القديمة موجودة: اختر إعادة ضبط قائمة الشكر المحفوظة (Reset saved credits) قبل البث التالي. تُخزن بيانات الخلفية لكل جلسة Social Stream حتى إعادة الضبط.