إنشاء ألعاب ومكافآت بالهدايا والدردشة

نعم، يمكن للعبتك التفاعل مع هدايا TikTok

يلتقط Social Stream Ninja الحدث ويرسله إلى صفحتك، وتحدد JavaScript النتيجة: دفع صاروخ أو تنمية حديقة أو إنشاء عدو أو تطوير هدف مشترك. تختار الإجراء وحدّه داخل اللعبة. لا يغيّر SSN أسعار هدايا المنصة.

ابدأ هنا: جرّب القوالب الثلاثة، ثم اختر ما ستقيسه القاعدة: وحدات المنصة أو هوية الهدية أو تقدير USD.

لصوت أو تنبيه أو إجراء OBS أو webhook، ابدأ باستخدام Event Flow. تفيد صفحة HTML مخصصة عندما تحتاج إلى لوحة لعب أو حالة خاصة باللعبة. للألعاب الجاهزة، راجع معرض الألعاب.

ثلاثة قوالب صغيرة قابلة للتعديل

تحتوي كل معاينة على أزرار أمثلة وعارض لآخر بيانات مستلمة. الأمثلة أحداث خيالية وليست مشتريات. لا ينضم وضع المعاينة إلى جلستك الحية.

صاروخ العملات: تمنح 10 عملات TikTok أو 100 Bits من Twitch أو 100 نجمة Facebook دفعة واحدة. تتراكم البواقي لكل مشاهد ومنصة على حدة. غيّر COST في HTML لتحديد مبالغك.
هدف دعم مشترك: اجمع الدعم التقديري بالدولار من المنصات الأربع لبناء قاعدة قمرية. غيّر GOAL_USD أو استبدل عرض التقدم بالضرر أو الوقود أو مؤقت.
حديقة الهدايا والأحداث: تضيف هدية TikTok المختارة زهورًا، وتضيف متابعة TikTok الملتقطة شجرة، ويضيف الأمر المجاني !water في الدردشة ماءً. اضبط GIFT_ID إلى معرّف ملتقط، أو اضبط GIFT_NAME إلى الاسم الدقيق. «Demo flower» مثال خيالي.

افتح مصدر HTML وابحث عن EDIT THIS RULE أو EDIT THESE RULES. receive(data) هي الدالة التي تستبدل فيها الإجراء التجريبي بمنطق لعبتك. توجد مساعدات الاتصال والعدّ في starter.js؛ وتوجد أنماط العرض في starter.css.

ربط قالب بالبث

شغّل SSN وصِل مصدر الدردشة. تأكد من وصول الدردشة وصفوف الهدايا/الدعم إلى dock. لإعداد TikTok، راجع أوضاع الاتصال.
افتح القالب دون ?demo، مستخدمًا معرّف جلسة SSN. أضف كلمة مرور الجلسة إن كانت محددة.
تحقق من الصفحة في المتصفح، ثم أضف الرابط نفسه كمصدر متصفح في OBS، مثلًا بمقاس 1000 × 800. أضف &clean لإخفاء عارض البيانات وحالة الاتصال وأزرار المضيف.

https://socialstream.ninja/games/templates/coin-rocket.html?session=YOUR_SESSION&password=YOUR_PASSWORD&clean

عند استخدام موقع beta، أبقِ /beta/ قبل games/. احذف معامل كلمة المرور إن لم تُضبط كلمة مرور. أبقِ روابط جلساتك خاصة.

يستخدم الاتصال الافتراضي جسر iframe نفسه المستخدم في تراكبات SSN. لاستخدام مسار الدردشة الملتقطة عبر WebSocket المستضاف، فعّل إعداد SSN إرسال الرسائل إلى لوحة الإرساء من الإضافة عبر الخادم وأضف &server2. راجع دليل WebSocket للإعداد المحلي؛ وتقبل القوالب أيضًا &server2&localserver و &localserverport=3000. localserver وحده لا يفعّل مسارًا. المسار الأقدم server يستخدم قناة مختلفة وقد يعتمد على dock ينشر إليها.

إنشاء نسختك الخاصة

تنزيل ملف ZIP لمصدر beta واستخرجه. عدّل الملفات تحت games/templates/، مع الحفاظ على بنية المجلدات؛ إذ تحمّل القوالب أيضًا js/local-server-url.js، بينما يحمّل هدف الدعم currency.js من جذر المستودع.

قدّم المجلد المستخرج عبر خادم ويب محلي. إذا كان Python مثبتًا، شغّل التالي من ذلك المجلد:

python -m http.server 8080 --bind 127.0.0.1

ثم استخدم http://127.0.0.1:8080/games/templates/coin-rocket.html?session=YOUR_SESSION في المتصفح أو OBS. عند الاستضافة في مكان آخر، حافظ على المسارات النسبية نفسها. لا تحتاج إلى خطوة بناء.

كيف أختار عدد العملات لإجراء معين؟

اختر ما تريد قياسه قبل اختيار رقم:

القاعدة	اقرأ	مثال
وحدات المنصة	TikTok `meta.coinsPerGift × meta.tiktokGiftCount` عند توافره، أو قيمة صريحة في `hasDonation` بنص مثل `10 coins`, `100 bits`، أو `100 Stars`.	كل 10 عملات تمنح دفعة واحدة.
هدية محددة	TikTok `meta.giftId` أو `meta.giftName`، مع عددها.	كل هدية مطابقة تضيف زهرة، بغض النظر عن قيمتها التقديرية بالدولار.
قيمة دعم قابلة للمقارنة	`getDonationValueUSD(data)` من `currency.js`.	كل دولار تقديري يضيف 10 وحدات وقود؛ و25 دولارًا تكمل الهدف.
إجراء مجاني أو عضوية	قيمة المصدر الفعلية في `event`، أو أمر دردشة.	المتابعة تنمّي شجرة؛ والاشتراك المدفوع الجديد يشغّل حركة.

حدّد ما إذا كان المبلغ يعني مطابقة تامة (coins === 10)، أو حد أدنى لكل حدث (coins >= 10)، أو رصيد تراكمي. يستخدم الصاروخ رصيدًا تراكميًا: تمنح 25 عملة دفعتين وتترك خمس عملات. قاعدة «10 بالضبط» ستتجاهل 25 عملة. عند اختيار إجراء واحد من عدة مستويات، افحص أعلى حد أولًا حتى لا يشغّل الحدث جميع المستويات الأدنى.

على TikTok يشتري المشاهدون العملات وينفقونها على الهدايا التي يظهر سعرها. اختر هدايا متاحة في بث LIVE الخاص بك وافحص البيانات قبل نشر القاعدة. اسم الهدية وعددها والعملات والماسات مقاييس مختلفة. لا تستنتج «عملات دقيقة» بقسمة تقدير الدولار ولا تعامل الماسات كعملات. شرح TikTok للعملات والهدايا.

إذا وفر الالتقاط اسم/عدد الهدية أو وصفًا بالماسات فقط، يتجاهل قالب العملات الحدث ما لم توجد بيانات صريحة للعملات. استخدم قاعدة لهوية الهدية أو قالب الدولار التقديري. قد تأتي بيانات العملات أيضًا من جدول هدايا SSN؛ قارنها بقائمة هدايا LIVE الحالية عندما تهمك دقة السعر. تختلف الكتالوجات وطرق الالتقاط، ولا يوجد حقل عملات موحّد مضمون في كل رسالة TikTok.

ما الذي ترسله كل منصة؟

type يحدد المصدر؛ event يحدد الإجراء عند وجوده. يعتمد التوافر على وضع الالتقاط والإعدادات وما تعرضه المنصة. تصف الأمثلة مسارات كود SSN الحالية، ولا تضمن جميع الأحداث لكل حساب.

المنصة	بيانات الدعم والأحداث	ميّز بين
TikTok	`type: "tiktok"`, `event: "gift"`. قد يوفّر التقاط التبرعات `hasDonation` و `donoValue`. قد تشمل البيانات المعرّف والاسم والعدد والعملات أو الماسات لكل هدية ومعرّف سلسلة الهدايا.	تشتري العملات الهدايا؛ والماسات مكافآت لصنّاع المحتوى. يحسم التقاط WebSocket في SSApp السلاسل قبل إرسالها، بينما قد يرسل المتصفح تحديثات تراكمية. تعطيل التقاط تبرعات TikTok قد يترك أحداث الهدايا دون حقول مالية.
Twitch	تستخدم Cheers وحدات Bits، مثل `hasDonation: "100 bits"`. قد يستخدم الالتقاط عبر API `event: "cheer"` و `donoValue: 1`؛ قد لا يتضمن التقاط الدردشة المعروضة علامة حدث.	الاشتراكات والاشتراكات المهداة والغارات ونقاط القناة إجراءات منفصلة. شارة مشترك في رسالة عادية ليست اشتراكًا جديدًا. Cheers المباشرة وBits المستخدمة في إضافات Twitch تكاملات مختلفة.
Facebook	توفر صفوف النجوم الظاهرة في Live Chat مثلًا `hasDonation: "100 Stars"` و `donoValue: 1`، دون `event` .	لا يستنتج مسار API التعليقات النجوم من النص. يحتاج التقاط DOM إلى صف نجوم ظاهر؛ التعليقات والتفاعلات العادية لا تثبت مبلغًا مدفوعًا.
YouTube	`superchat` و `supersticker` تحمل مبلغ العملة الأصلي في `hasDonation`. تستخدم الهدايا `jeweldonation` مع `N Jewels`، أو `1 YouTube Gift` عندما يكون المبلغ مخفيًا.	ينفق المشاهدون الجواهر على الهدايا ويحصل المنشئون على الياقوت. العضويات والعضويات المهداة أحداث منفصلة وليست جواهر. Super Thanks منتج منفصل ولا يضمن حدث تبرع في الدردشة الحية.

مراجع المنصات: ماسات TikTok; Bits واشتراكات Twitch; نظرة عامة على نجوم Meta; Super Chat وSuper Stickers من YouTube; جواهر وهدايا وياقوت YouTube. تم التحقق من المصطلحات في 29 سبتمبر 2026؛ راجع صفحات المنصات الحالية للأهلية والتوافر.

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

استخدام donoValue وcurrency.js بشكل صحيح

hasDonation هو نص العرض الأصلي، مثل €5.00 أو 100 bits. donoValue مبلغ USD رقمي اختياري يقدمه المصدر. احترم القيمة الصالحة، بما فيها الصفر، قبل التقدير من النص. احتفظ بالنص الأصلي للعرض.

<script src="../../currency.js"></script>
<script>
// From games/templates/: use the existing helper, including its zero handling.
var usd = getDonationValueUSD(data);
// Use usd for your rule; display data.hasDonation for the original amount/unit.
</script>

سلوك التحويل الحالي: يقدّر SSN حاليًا عملة TikTok بـ0.01 دولار، والماسة بـ0.005 دولار، ووحدة Bit من Twitch أو نجمة Facebook بـ0.01 دولار، وجوهرة YouTube بـ0.005 دولار. هدية TikTok مجهولة السعر تُحسب افتراضيًا كعملة واحدة لكل هدية؛ ولهدية YouTube دون عدد جواهر تقدير بديل مستقل قدره 0.01 دولار. تحويل العملات التقليدية يستخدم أيضًا أسعارًا داخلية تقريبية، لا خدمة أسعار صرف حية.

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

لا تستخدم donoValue || convertToUSD(...): فهذا يتجاهل الصفر المقصود. لا تستخرج أرقامًا من chatmessage لكشف المدفوعات، ولا تشترط علامة event === "donation": نجوم Facebook وبعض Cheers لا تحمل علامة حدث. يختار قالب هدف الدعم أنواع الدعم أولًا، ثم يستدعي المحوّل المشترك.

المصدر: currency.js و مرجع البيانات. بيانات الهدايا الوصفية اختيارية؛ ولا تختلق الأمثلة حقولًا غير موجودة في بياناتك.

احتساب سلسلة الهدايا مرة واحدة

قد يبلغ TikTok عن أعداد تراكمية 1، 2، 3 للسلسلة نفسها. هذه ثلاث هدايا وليست ستًا. للإجراءات التراكمية احفظ أكبر عدد أو مبلغ وصل وطبّق الزيادة فقط. تحديث الإكمال بالمجموع نفسه لا يضيف شيئًا.

// All three events refer to the same streak:
// incoming total: 1, 2, 3, 3
// added to game:  1, 1, 1, 0
var newCoins = RewardStarter.increment(data, RewardStarter.coins(data), 'coins');

تستخدم الدالة المساعدة معرّفات مجموعة/مرسل/هدية TikTok الأصلية عند توافرها، ثم meta.tiktokGiftStreakId أو معرّفات الرسائل. تمنع المعرّفات العادية أيضًا تكرار التسليم. لا تنتظر الدالة repeatEnd لأن التقاط المتصفح قد لا يوفّره مطلقًا. إذا أردت إجراءً واحدًا بعد اكتمال السلسلة فقط، فاكتب قاعدة إكمال منفصلة بالحقول التي يرسلها اتصالك فعلًا.

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

مكافآت دون لعبة مخصصة

في Event Flow، استخدم مقارنة خاصية مع donoValue, أكبر من أو يساوي، وحدّك بالدولار الأمريكي، ثم صِل صوتًا أو حركة أو أمرًا في OBS. تستخدم المقارنة قيمة المصدر إن كانت صالحة، والتحويل الحالي للعملات عند الحاجة.

لهدية TikTok محددة، قارن meta.giftId أو meta.giftName، واقصر التدفق على أحداث هدايا TikTok. المقارنات الرقمية للحقل hasDonation تُفسَّر أيضًا بالدولار، وليست مقارنات مباشرة للعملات. استخدم البيانات الأصلية أو كودًا مخصصًا لقواعد العملات.

الحد الذي يُقيَّم لكل رسالة يختلف عن الرصيد التراكمي أو عدّاد السلسلة. لا تفترض أن حد Event Flow ينفذ تلقائيًا التجميع وإزالة التكرار الموجودين في القالب. استخدم عقد الحالة عندما يحتاج التدفق إلى حالة، أو أبقِ هذا المنطق في لعبتك.

جرّبه قبل ربط إجراء مدفوع

استخدم أزرار الأمثلة. سلسلة 1 → 2 → 3 يجب أن تضيف قيمة ثلاث هدايا؛ ومثال الصفر الصريح يجب ألا يضيف دولارًا؛ والسعر المجهول يجب ألا يضيف عدد عملات دقيقًا.
صِل المصدر الحقيقي وافحص البيانات الملتقطة فعلًا. تحقق من اسم/معرّف الهدية والمبلغ/الوحدة والعدد والحدث المتوقع. المثال يثبت القاعدة، لا الالتقاط الحي من المنصة.
تحقق داخل مشهد OBS من الأحداث المتكررة وإعادة الاتصال وإعادة التحميل. تجنب إيقاف مصدر المتصفح أو تحديثه إذا كان الحفاظ على الجولة في الذاكرة مهمًا.

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

إذا لم يصل شيء، افحص dock في SSN أولًا، ثم الجلسة/كلمة المرور وإعداد النقل. إذا وصلت الدردشة ولم تطابق الهدية، افحص البيانات ومرشحات التبرعات/الأحداث. يختلف توافر المتابعات والاشتراكات باختلاف المصدر؛ راجع مرجع الأحداث. لمزيد من تفاصيل الاتصال، راجع تراكبات مخصصة.