ゲームのアイデアと機能

次に追加する機能

リーダーボード

毎ラウンドのスコアを保存し、上位のプレイヤーを表示する。

プレイヤーセッションが必要
Unity
リーダーボードのイラスト
確認できる結果

ラウンド終了後にテストスコアがランキングに表示されます。

リーダーボードの順位を見る3:54

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

動画を別のタブで開く ↗

同じプロジェクトを準備する

  1. ゲームの設定と同じプロジェクトをダッシュボードで選択してください。

    リーダーボード →
  2. ダッシュボードのフォームで次のテスト項目を作成するか、既存の項目を使います。表示値は例であり、現在のプロジェクトのデータではありません。

    キー (slug)
    weekly
    並び順
    DESC
    検証済みプレイのスコアだけを受け付ける
    false
  3. 実行前に保存、再読み込み、確認を行います。他の定義は保持してください。

この機能を実装する

ガイドは閲覧できます。実行には有効なプロジェクトキーが必要です。 プロジェクトを準備する

SDK をインストールし、プロジェクト設定をインポート済みで、プレイヤーがログインしていること。

C#ファイルを保存し、GameObjectにアタッチしてPlayを開始します。Consoleを確認してください。

C#
Assets/Scripts/LeaderboardDemo.cs
horizOn 呼び出し準備
1using UnityEngine;
2using PM.horizOn.Cloud.Core;
3using PM.horizOn.Cloud.Manager;
4​
5// このスクリプトを最初のシーンの GameObject にアタッチします。
6public class LeaderboardDemo : 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 // horizOn: スコアを送信し、ランキングと自分の順位を読む。
22 var boards = LeaderboardManager.Instance;
23 bool submitted = await boards.SubmitScore(12500, boardKey: "weekly");
24 if (!submitted) { Debug.LogWarning(boards.LastErrorCode); return; }
25 var top = await boards.GetTop(10, useCache: false, boardKey: "weekly");
26 if (top == null) return;
27 foreach (var entry in top) Debug.Log($"#{entry.position} {entry.username}: {entry.score}");
28 var rank = await boards.GetRank(boardKey: "weekly");
29 if (rank != null) Debug.Log($"Your rank: {rank.position}");
30 }
31}
完全なSDKサンプルを開く ↗

新しい機能をテストしましょう。

ラウンド終了後にテストスコアがランキングに表示されます。

ゲームの設定と同じプロジェクトをダッシュボードで選択してください。

エンドポイント
  • POST/leaderboard/submit
  • GET/leaderboards/{boardKey}/top
  • GET/leaderboards/{boardKey}/rank
  • GET/leaderboards/{boardKey}/around
API リファレンスのすべてのエンドポイント