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

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

الإجراءات الموثّقة

اجعل الخادم يتحقّق من إجراءات اللعبة.

SDK: فرع developتتطلب جلسة لاعب
Godot
رسم توضيحي لميزة الإجراءات الموثّقة
النتيجة المرئية

يُقبل الإجراء الصحيح ويُرفض الإجراء غير الصحيح.

التحقق من إجراءات اللعبة3:12

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

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

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

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

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

    المفتاح (Slug)
    weekly
    قبول النتائج من الجولات الموثّقة فقط
    true
    أعلى نتيجة
    20000
    أقل مدة (بالثواني)
    0
    المرحلة إلزامية
    false

    احفظوا هذه القواعد في مشروع اختبار واتركوا الحدود الأخرى فارغة. تختبر بايتات quickstart الثابتة بروتوكول الطلب. يفترض قبول 18250 نقطة. ابدؤوا جولة جديدة بقيمة 20001 لاختبار الرفض. سجّلوا المدخلات الحقيقية داخل اللعبة.

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

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

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

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

يستخدم مثال SDK هذا فرع develop. تحقّق من وجود واجهات API المطلوبة في SDK المثبّت.

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

GDScript
res://scripts/validated_actions.gd
استدعاء horizOnالتهيئة
1# أرفق هذا السكربت بعقدة في المشهد الرئيسي.
2extends Node
3​
4var input_log: PackedByteArray = "quickstart".to_utf8_buffer()
5​
6​
7func _ready() -> void:
8 # التهيئة: التهيئة والاتصال وتسجيل دخول لاعب.
9 var connected = await Horizon.connect_to_server()
10 if not connected:
11 print("Failed to connect to horizOn server")
12 return
13 if not Horizon.auth.isSignedIn():
14 var signed_in: bool
15 if Horizon.auth.hasCachedAnonymousToken():
16 signed_in = await Horizon.auth.restoreAnonymousSession()
17 else:
18 signed_in = await Horizon.auth.signUpAnonymous("StatisticsPlayer")
19 if not signed_in:
20 return
21​
22 # horizOn: ابدأ جولة، وسجّل المدخلات، وأرسل النتيجة الموثّقة.
23 # 1. Dashboard: turn on "Validated submissions only" for the board "weekly"
24​
25 # 2. Round start: single-use ticket plus server seed
26 var run: Dictionary = await Horizon.validatedActions.startRun("weekly")
27 if run.is_empty():
28 print(Horizon.validatedActions.getLastErrorCode()) # e.g. RUN_RATE_LIMITED
29 return
30 var rng := RandomNumberGenerator.new()
31 rng.seed = run["seed"]
32​
33 # Protocol test input only. Replace it with actual recorded game inputs in your game.
34​
35 # 3. Round end: score plus input log (the SDK sends its SHA-256 hash)
36 var result: Dictionary = await Horizon.validatedActions.submitValidated(18250, input_log)
37 if result.is_empty():
38 print(Horizon.validatedActions.getLastErrorCode())
39 return
40 print("Accepted score=", result.get("score"), ", rank=", result.get("rank"))
فتح مثال SDK الكامل ↗

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

يُقبل الإجراء الصحيح ويُرفض الإجراء غير الصحيح.

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

نقاط النهاية
  • POST/validated-actions/runs
  • POST/validated-actions/submit
كل نقاط النهاية في مرجع API
رسم توضيحي لميزة لوحات المتصدرين
اقتراحنا لخطوتك التالية

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

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

فيديو تعليمي

الإجراءات الموثّقةGodot6:05

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

فتح الفيديو بشكل منفصل ↗
القيم التي يديرها الخادمGodot4:58

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

فتح الفيديو بشكل منفصل ↗
سجل الإدخالGodot5:45

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

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