ゲームのアイデアと機能

次に追加する機能

検証済みアクション

ゲーム内のアクションをサーバーで検証する。

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

この動画は英語で再生されます。

動画を別のタブで開く ↗