游戏创意与功能

你的下一项功能

已验证操作

让服务器验证游戏操作。

SDK:develop 分支需要玩家会话
Unity
已验证操作功能示意图
可见的结果

有效操作被接受,无效操作被拒绝。

验证游戏操作3:12

此教程以英语播放。

单独打开视频 ↗

准备同一个项目

  1. 在仪表盘中选择与游戏配置相同的项目。

    已验证操作 →
  2. 在控制台表单中创建或复用这些测试条目。这些是示例值,并非项目当前数据。

    Key(slug)
    weekly
    只接受已验证游戏局的分数
    true
    最高分
    20000
    最短时长(秒)
    0
    必须提供关卡
    false

    在测试项目中保存这些规则,其他限制留空。固定的quickstart字节仅用于测试请求协议。18250分应被接受。另开一局提交20001分以验证拒绝。实际游戏中应记录真实输入。

    排行榜 →
  3. 运行示例前先保存、重新加载并核对条目。保留其他定义。

实现此功能

你可以预览指南。运行需要有效的项目密钥。 准备项目

已安装 SDK、导入项目配置,且玩家已登录。

此 SDK 示例使用 develop。请检查已安装的 SDK 是否具备所需 API。

保存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

此教程以英语播放。

单独打开视频 ↗