أفكار وميزات للعبة

ميزتك التالية

رموز الهدايا

اسمح للاعبين بإدخال رموز الهدايا واستردادها.

تتطلب جلسة لاعب
Unity
رسم توضيحي لميزة رموز الهدايا
النتيجة المرئية

يُسترد رمز تجريبي. يخضع الاسترداد المتكرر لقواعدك.

إنشاء كود هدية1:42

يُشغّل هذا الدرس باللغة الإنجليزية.

فتح الفيديو بشكل منفصل ↗
الفيديو قادم لاحقًا

لا يوجد فيديو لهذه الخطوة بعد. الدليل وطلب MCP متاحان للاستخدام.

قيم اللاعب على الخادم

جهّزوا المشروع نفسه

  1. اختر في لوحة التحكم المشروع نفسه الموجود في إعداد لعبتك.

    رموز الهدايا →
  2. أنشئوا إدخالات الاختبار هذه أو أعيدوا استخدام الموجود منها في نموذج لوحة التحكم. القيم أمثلة وليست بيانات المشروع الحالية.

    الرمز
    WELCOME
    بيانات الهدية (JSON)
    {}
    الحد الأقصى لكل مستخدم
    1

    يضيف الخادم حتى ثماني قيم مُعدّة عند الاسترداد. تبقى giftData بيانات لعبة منفصلة. اعرض الرصيد المعاد ولا تضف المكافأة مرة أخرى محليًا.

    قيم اللاعب →
  3. احفظوا الإدخالات وأعيدوا تحميلها وتحققوا منها قبل المثال. احتفظوا بالتعريفات الأخرى.

أضف هذه الميزة

يمكنك الاطلاع على الدليل. يتطلب التنفيذ مفتاح مشروع نشطًا. تجهيز المشروع

SDK مُثبّت وإعداد المشروع مُستورد واللاعب مسجّل الدخول.

يضيف الخادم حتى ثماني قيم مُعدّة عند الاسترداد. تبقى giftData بيانات لعبة منفصلة. اعرض الرصيد المعاد ولا تضف المكافأة مرة أخرى محليًا. يستخدم مثال SDK هذا فرع develop. تحقّق من وجود واجهات API المطلوبة في SDK المثبّت.

احفظوا ملف C# وألحقوه بـGameObject ثم شغّلوا Play. تحققوا من Console.

C#
Assets/Scripts/GiftCodesDemo.cs
استدعاء horizOnالتهيئة
1using UnityEngine;
2using PM.horizOn.Cloud.Core;
3using PM.horizOn.Cloud.Manager;
4​
5// أرفق هذا السكربت بـ GameObject في المشهد الأول.
6public class GiftCodesDemo : MonoBehaviour
7{
8 async void Start()
9 {
10 // التهيئة: التهيئة والاتصال وتسجيل دخول لاعب.
11 HorizonApp.Initialize();
12 await new HorizonServer().Connect();
13 if (!UserManager.Instance.IsSignedIn)
14 {
15 bool authenticated = UserManager.Instance.HasCachedAnonymousToken()
16 ? await UserManager.Instance.RestoreAnonymousSession()
17 : await UserManager.Instance.SignUpAnonymous("StatisticsPlayer");
18 if (!authenticated) return;
19 }
20​
21 // horizOn: تحقق من رمز الهدية واستبدله.
22 // Run from one explicit player action; serialize this handler until it completes.
23 string userId = UserManager.Instance.CurrentUser.UserId;
24 string project = HorizonApp.Network.GetApiKey();
25 string scope = PM.horizOn.Cloud.Objects.Network.Responses.GiftCodeIntent.ProjectFingerprint(project);
26 string pendingKey = "horizOn_gift_v2_" + scope + "_" + userId;
27 // Preserve an old V1 demo record for reconciliation. Never reinterpret its UUID as a count.
28 if (PlayerPrefs.HasKey("horizOn_gift_pending_" + userId)) return;
29 PM.horizOn.Cloud.Objects.Network.Responses.GiftCodeIntent pending;
30 if (PlayerPrefs.HasKey(pendingKey)) {
31 pending = JsonUtility.FromJson<PM.horizOn.Cloud.Objects.Network.Responses.GiftCodeIntent>(PlayerPrefs.GetString(pendingKey));
32 if (pending == null || !pending.IsValidFor(project, userId)) return;
33 } else {
34 pending = await GiftCodeManager.Instance.PrepareRedemption("WELCOME");
35 if (pending == null || !pending.IsValidFor(project, userId) || PlayerPrefs.HasKey(pendingKey)) return;
36 PlayerPrefs.SetString(pendingKey, JsonUtility.ToJson(pending));
37 PlayerPrefs.Save(); // All seven fields before the first mutating request.
38 }
39 string original = JsonUtility.ToJson(pending);
40 if (PlayerPrefs.GetString(pendingKey) != original) return;
41 var result = await GiftCodeManager.Instance.RedeemPrepared(pending);
42 if (result == null || !result.success) return; // Keep the exact tuple after any uncertain result.
43 if (PlayerPrefs.GetString(pendingKey) == original) {
44 PlayerPrefs.DeleteKey(pendingKey);
45 PlayerPrefs.Save();
46 }
47 if (result.playerValues != null) {
48 foreach (var value in result.playerValues.values) Debug.Log(value.key + "=" + value.balance);
49 }
50 // alreadyApplied/replayed means the sequence slot was consumed, with no copied historical rewards.
51 // Replace balances with playerValues. Never add grantedValues locally.
52 }
53}
فتح مثال SDK الكامل ↗

اختبر ميزتك الجديدة.

يُسترد رمز تجريبي. يخضع الاسترداد المتكرر لقواعدك.

اختر في لوحة التحكم المشروع نفسه الموجود في إعداد لعبتك.

نقاط النهاية
  • POST/gift-codes/validate
  • POST/gift-codes/redeem
كل نقاط النهاية في مرجع API
رسم توضيحي لميزة لوحات المتصدرين
اقتراحنا لخطوتك التالية

أضف رقمًا قياسيًا لكل جولة.

احفظ النتيجة بعد الجولة وأظهر المتصدر. واصل استخدام اتصالك وجلسة اللاعب.