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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

C#
Assets/Scripts/ValidatedActionsDemo.cs
استدعاء horizOnالتهيئة
1using UnityEngine;
2using PM.horizOn.Cloud.Core;
3using PM.horizOn.Cloud.Manager;
4​
5// أرفق هذا السكربت بـ GameObject في المشهد الأول.
6public class ValidatedActionsDemo : 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 byte[] inputLog = System.Text.Encoding.UTF8.GetBytes("quickstart");
22​
23 // horizOn: ابدأ جولة، وسجّل المدخلات، وأرسل النتيجة الموثّقة.
24 // 1. Dashboard: turn on "Validated submissions only" for the board "weekly"
25 var va = ValidatedActionsManager.Instance;
26​
27 // 2. Round start: single-use ticket plus server seed
28 var run = await va.StartRun("weekly");
29 if (run == null) { Debug.Log(va.LastErrorCode); return; } // e.g. RUN_RATE_LIMITED
30 var random = new System.Random(run.seed);
31​
32 // Protocol test input only. Replace it with actual recorded game inputs in your game.
33​
34 // 3. Round end: score plus input log (the SDK sends its SHA-256 hash)
35 var result = await va.SubmitValidated(18250, inputLog);
36 if (result == null)
37 {
38 Debug.Log($"{va.LastErrorCode}, run kept: {va.HasActiveRun}");
39 return;
40 }
41 Debug.Log($"Accepted score={result.score}, rank={result.rank}");
42 }
43}
فتح مثال SDK الكامل ↗

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

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

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

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

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

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

فيديو تعليمي

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

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

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

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

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

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

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