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

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

رموز الهدايا

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

احفظوا GDScript وألحقوه بعقدة في المشهد الرئيسي ثم شغّلوه. تحققوا من Output.

GDScript
res://scripts/gift_codes.gd
استدعاء horizOnالتهيئة
1# أرفق هذا السكربت بعقدة في المشهد الرئيسي.
2extends Node
3​
4​
5func _ready() -> void:
6 # التهيئة: التهيئة والاتصال وتسجيل دخول لاعب.
7 var connected = await Horizon.connect_to_server()
8 if not connected:
9 print("Failed to connect to horizOn server")
10 return
11 if not Horizon.auth.isSignedIn():
12 var signed_in: bool
13 if Horizon.auth.hasCachedAnonymousToken():
14 signed_in = await Horizon.auth.restoreAnonymousSession()
15 else:
16 signed_in = await Horizon.auth.signUpAnonymous("StatisticsPlayer")
17 if not signed_in:
18 return
19​
20 # horizOn: تحقق من رمز الهدية واستبدله.
21 # Run from one explicit player action; serialize this handler until it completes.
22 var user_id: String = Horizon.auth.getCurrentUser().userId
23 var project: String = Horizon.getConfig().api_key
24 var scope: String = project + "|" + user_id
25 var path: String = "user://gift_pending_" + scope.sha256_text() + ".bin"
26 var pending: Dictionary
27 if FileAccess.file_exists(path):
28 var file := FileAccess.open(path, FileAccess.READ)
29 if file == null: return
30 var saved: Variant = file.get_var(false)
31 file.close()
32 if not HorizonGiftCodes.validIntent(saved, project, user_id): return
33 pending = saved # Invalid/V1 records stay untouched for reconciliation.
34 else:
35 pending = await Horizon.giftCodes.prepareRedemption("WELCOME")
36 if not HorizonGiftCodes.validIntent(pending, project, user_id) or FileAccess.file_exists(path): return
37 var file := FileAccess.open(path, FileAccess.WRITE)
38 if file == null: return
39 file.store_var(pending, false)
40 file.flush()
41 var saved_ok: bool = file.get_error() == OK
42 file.close()
43 if not saved_ok: return
44 var verify := FileAccess.open(path, FileAccess.READ)
45 if verify == null: return
46 var original: Variant = verify.get_var(false)
47 verify.close()
48 if original != pending: return
49 var result: Dictionary = await Horizon.giftCodes.redeemPrepared(pending)
50 if not result.get("success", false): return # Keep all seven original fields for retry.
51 verify = FileAccess.open(path, FileAccess.READ)
52 if verify == null: return
53 original = verify.get_var(false)
54 verify.close()
55 if original == pending: DirAccess.remove_absolute(ProjectSettings.globalize_path(path))
56 if result.get("playerValues") is Dictionary:
57 print(result.playerValues.values) # Current balances, never add grantedValues locally.
58 # Replay has alreadyApplied=true, giftData=null and empty grantedValues/grantedUnlocks.
فتح مثال SDK الكامل ↗

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

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

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

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

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

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