المنتجات المباشرة وروابط المشاهدين

1. إضافة منتج أو رابط دعم

افتح Monetization > Products & support links > Set up products and links. الصق رابط HTTPS عامًا واختر تحميل التفاصيل من الرابط (Load details from link). يدعم الاستيراد السريع صفحات Gumroad وitch.io وKo-fi وBuy Me a Coffee وFourthwall العامة. قد تتطلب النطاقات المخصصة وإعادات التوجيه والصفحات الخاصة والصفحات التي لا تتضمن بيانات وصفية عامة إدخالًا يدويًا. تظل خيارات استيراد API الحالية لـShopify وFourthwall متاحة.

تحقق من العنوان والصورة والسعر والعملة والغرض. يترك الاستيراد السريع السعر فارغًا عمدًا. اختر إضافة منتج أو رابط (Add product or link)، وفعّل روابط المنتجات والدعم (Products & support links)، ثم حفظ الإعداد (Save setup). لا يلزم حساب تاجر للبطاقات اليدوية.

تصف Shop وGift وSupport وJoin غرض الرابط. ولا تغير تصنيف أحداث الدفع اللاحقة. البطاقات لقطات محفوظة؛ وصفحة الدفع هي المرجع المعتمد للمخزون والأسعار.

2. التحكم فيما يظهر

أضف رابط تراكب Products & support links الحالي إلى OBS. استخدم Showcase أو Support card للترويج، أو Both لتضمين تنبيهات النشاط.

• عرض الآن (Show now) في صف محفوظ يثبّت ذلك المنتج ويتجاوز جدول البطاقات الدوري.
• المنتج التالي (Next product) يثبّت المنتج المحفوظ التالي.
• إخفاء المنتجات (Hide products) يخفي البطاقات الترويجية. تستمر تنبيهات المشتريات والهدايا.
• استئناف الجدول (Resume schedule) يستعيد إعدادات المنتج الأول أو التدوير المحفوظة.

اضبط Show/hide seconds قبل استخدام أي عنصر تحكم. تستمر القيمة صفر حتى التغيير؛ وتستعيد القيم 1-3600 الجدول المحفوظ بعد ذلك العدد من الثواني. تُعاد تعيين التجاوزات المباشرة عند إعادة تشغيل SSN. تُعلَّم الصفوف غير المحفوظة وتظل أزرار Show now الخاصة بها معطلة حتى Save setup. تسمي الحالة المنتج المحدد وتعرض الثواني المتبقية؛ ولا تدعي أن OBS يبث مباشرة أو أن هذا المصدر مرئي. تعرّف عناصر التحكم المنتج برابطه المحفوظ الدقيق، لذا لا يؤدي تحريكه في القائمة إلى تعطيل الأتمتة.

3. نشر رابط واحد للمشاهدين

افتح Display options > Public viewer page واختر نشر الروابط المحفوظة (Publish saved links). ينشر هذا صراحة كل رابط منتج أو دعم محفوظ، بما في ذلك العناوين والصور والأسعار والأغراض. شارك نسخ رابط المشاهد (Copy viewer link) مع مشاهدينك. تستخدم رموز QR للمنتجات الآن هذه الصفحة الثابتة، ليظل المشاهد قادرًا على العثور على منتج بعد تدوير التراكب.

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

إلغاء النشر (Unpublish) يزيل الصفحة؛ وتعود رموز QR للمنتجات إلى روابط المنتجات الفردية. تُمسَح صفحات المشاهد المفتوحة عند فحصها الناجح التالي. تتوقف الروابط التي شُوركت سابقًا عن التحميل حتى تنشر مجددًا. يعيد النشر من الجهاز نفسه الرابط نفسه. احتفظ بملف جهاز SSN الشخصي: مفتاح النشر الخاص به مطلوب لتحديث الصفحة أو إزالتها.

إذا لم تتوفر API، تظل عناصر التحكم المحلية تعمل. تترك التحديثات الفاشلة آخر صفحة منشورة مرئية وتعيد المحاولة أثناء فتح SSN. تعرض النافذة المنبثقة الفشل. يتطلب النشر نشر خدمة المتجر العام الاختيارية؛ ولا يتدخل أي حساب متجر أو دفع.

Event Flow وعناصر التحكم عن بُعد

في Event Flow، أضف إجراء المنتجات والدعم من مجموعة إجراءات التراكبات. اختر Show أو Next أو Hide أو Resume؛ ويمكنك تحديد رابط المنتج المحفوظ الدقيق والثواني. استخدم محفزًا مناسبًا موجودًا، مثل أمر إشراف خاص بك، بدلًا من السماح لكل رسالة دردشة بتغيير المنتجات.

في إضافة Stream Deck، أضف مفاتيح Preset Command من المنتجات والدعم (Products & support): Show product وNext product وHide products وResume products. يتضمن Show محددًا للمنتجات المحفوظة؛ اختر Refresh products and state لتحميل القائمة. يبقى الاختيار المحفوظ غير المتاح ظاهرًا بدلًا من تغييره بصمت. يمكنك مع ذلك لصق رابط المنتج العام، أو تركه فارغًا للمنتج الحالي أو الأول. يقبل Next وHide عدد ثوانٍ اختياريًا. تنتظر المفاتيح تأكيد SSN للتغيير المحلي، بصورة مستقلة عن تحديثات الصفحة العامة. أضف مفتاح Product State الاختياري لعرض حالة التحديد أو الإخفاء أو الجدولة، مع تحديث كل خمس ثوانٍ أثناء ظهور المفتاح. يعرض مفتش الإعدادات وSSN اسم المنتج كاملًا؛ ويختصر مفتاح الحالة الصغير الأسماء الطويلة. استخدم اتصال P2P أو WebSocket الحالي.

تقبل واجهة التحكم عن بُعد API الحالية للجلسة الموثقة أمر التحكم نفسه:

{"action":"commerceControl","command":"show","url":"https://example.com/product","seconds":30}

الأوامر هي show, next, hide و resume. احذف URL لعرض المنتج الحالي أو الأول. يجب تفعيل عناصر تحكم المضيف. لا تشارك رابط جلسة أو تحكم خاصًا مع المشاهدين أبدًا؛ استخدم رابط المشاهد المنشور.

تبث هذه الإجراءات حالة العرض الحالية فقط monetization_update . لا تنشئ تبرعات أو مشتريات أو منشورات دردشة أو محفزات دفع لـEvent Flow. يبقى سلوك hasDonation دون تغيير.

معرفة وقت اكتمال أمر التحكم

ينتظر إجراء Products & Support رد SSN قبل متابعة التدفق. في حمولات الأحداث العادية، meta.commerceControlResult يتضمن success وإما نتيجة commerce لحالة التحكم أو error. يوقف الفشل الإجراءات اللاحقة في تلك السلسلة؛ وتظل عملية الشراء أو التبرع الأصلية متاحة للتدفقات والتراكبات الأخرى. تؤكد الحالة اختيار SSN أو حالة الإخفاء أو الجدول؛ أما الظهور في OBS فأمر منفصل.

إذا لم يصل رد خلال ثماني ثوانٍ، يبلغ الإجراء عن انتهاء المهلة. قد يكون التحكم طُبِّق رغم ذلك: تحقق من حالة النافذة المنبثقة أو اللوحة قبل إعادة محاولة Next. ينبغي للعملاء البعيدين الخارجيين استخدام بروتوكول الطلب والرد الحالي وفحص النتيجة المُعادة، بدلًا من اعتبار إرسال الأمر نجاحًا.

للمؤثرات الأخرى نتائجها الخاصة. يبلغ Print Thermal Label عن meta.thermalPrintResult؛ تقديم مهمة بنجاح لا يؤكد خروج الورق. يمكن لإجراء Webhook متزامن إعادة حالة HTTP والاستجابة، ويمكنه منع المتابعة عند الفشل. هذه نتائج إجراءات وليست أحداث دفع جديدة. راجع مرجع الأحداث لمعرفة عقد نتيجة التحكم.