ゲームのアイデアと機能

次に追加する機能

プレイヤー統計

ラウンド数、撃破数、最高記録をセッション単位でまとめて報告し、合計・最大・最小・最新値で集計します。

SDK:developプレイヤーセッションが必要
Godot
プレイヤー統計のイラスト
確認できる結果

ゲームは1回のセッション全体をまとめて報告し、現在のカウンターと期間を表示します。

動画は後日公開

この手順の動画はまだありません。ガイドとMCPへの依頼は利用できます。

プレイヤー統計

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

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

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

    統計の定義
    kills: mode=sum, reset=none; best_score: mode=max, reset=none

    合計は各報告を加算します。最大・最小は極値を保持し、最新値は置き換えます。最大・最小・最新値は最初の報告で初期化されます。値は安全な範囲内の符号付き整数です。

  3. 実行前に保存、再読み込み、確認を行います。他の定義は保持してください。

この機能を実装する

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

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

この SDK サンプルは develop を使用します。必要な API がインストール済みの SDK にあるか確認してください。

クイックスタートで対象プレイヤーを接続します。ボタンやシーンの明示的な操作からrun_reviewed_action()を呼び出してください。ファイルを開くだけではリクエストは送信されません。

GDScript
res://scripts/statistics.gd
horizOn 呼び出し
1extends Node
2​
3# Existing configured SDK and authenticated player session required.
4# Invoke run_reviewed_action explicitly after reviewing this example.
5# This explicit action reports the shown persisted batch.
6func run_reviewed_action() -> void:
7 if not Horizon.auth.isSignedIn():
8 return
9 var snapshot: Dictionary = await Horizon.statistics.getStatistics()
10 if snapshot.is_empty():
11 push_error(Horizon.statistics.getLastErrorCode())
12 return
13 var pending_path: String = "user://statistics_" + snapshot.userId + ".dat"
14 var pending: Dictionary
15 if FileAccess.file_exists(pending_path):
16 var file := FileAccess.open(pending_path, FileAccess.READ)
17 if file == null:
18 return
19 var saved: Variant = file.get_var()
20 file.close()
21 if not saved is Dictionary:
22 return
23 pending = saved
24 else:
25 pending = {"operationId": Horizon.statistics.createOperationId(),
26 "updates": [{"key": "kills", "value": 3}, {"key": "best_score", "value": 250}]}
27 var file := FileAccess.open(pending_path, FileAccess.WRITE)
28 if file == null:
29 return
30 file.store_var(pending, false) # Variant storage preserves int64 values.
31 file.flush()
32 var saved_ok: bool = file.get_error() == OK
33 file.close()
34 if not saved_ok:
35 return
36 var original_bytes: PackedByteArray = FileAccess.get_file_as_bytes(pending_path)
37 if original_bytes.is_empty():
38 return
39 var result: Dictionary = await Horizon.statistics.updateStatistics(pending.updates, pending.operationId)
40 if result.is_empty():
41 # Keep the file and original ID, including after timeout or OPERATION_EXPIRED.
42 push_error(Horizon.statistics.getLastErrorCode())
43 return
44 # A delayed O1 success cannot remove another action's O2 original.
45 if FileAccess.get_file_as_bytes(pending_path) == original_bytes:
46 DirAccess.remove_absolute(ProjectSettings.globalize_path(pending_path))
47 print(result.values)
完全なSDKサンプルを開く ↗

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

ゲームは1回のセッション全体をまとめて報告し、現在のカウンターと期間を表示します。

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

エンドポイント
  • GET/statistics
  • GET/statistics/definitions
  • POST/statistics
API リファレンスのすべてのエンドポイント
リーダーボードのイラスト
次のステップへのおすすめ

毎ラウンドにハイスコアを。

ラウンド終了後にスコアを保存し、上位のプレイヤーを表示します。現在の接続とプレイヤーセッションを引き続き使用します。