ゲームのアイデアと機能

次に追加する機能

リーダーボード

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

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

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

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

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

動画を別のタブで開く ↗

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

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

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

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

この機能を実装する

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

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

GDScriptを保存し、メインシーンのノードにアタッチして実行します。Outputを確認してください。

GDScript
res://scripts/leaderboard.gd
horizOn 呼び出し準備
1# このスクリプトをメインシーンのノードにアタッチします。
2extends Node
3​
4​
5func _ready() -> void:
6 # 準備: 初期化、接続、プレイヤーのサインイン。
7 var connected = await Horizon.connect_to_server()
8 if not connected:
9 print("Failed to connect to horizOn server")
10 return
11 if not Horizon.auth.isSignedIn():
12 var signed_in: bool
13 if Horizon.auth.hasCachedAnonymousToken():
14 signed_in = await Horizon.auth.restoreAnonymousSession()
15 else:
16 signed_in = await Horizon.auth.signUpAnonymous("StatisticsPlayer")
17 if not signed_in:
18 return
19​
20 # horizOn: スコアを送信し、ランキングと自分の順位を読む。
21 var submitted: bool = await Horizon.leaderboard.submitScore(12500, "weekly")
22 if not submitted:
23 push_warning(Horizon.leaderboard.getLastErrorCode())
24 return
25 var top = await Horizon.leaderboard.getTop(10, false, "weekly")
26 for entry in top:
27 print("#%d %s: %d" % [entry.position, entry.username, entry.score])
28 var rank = await Horizon.leaderboard.getRank("weekly")
29 if rank != null:
30 print("Your rank: ", rank.position)
完全なSDKサンプルを開く ↗

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

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

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

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