ゲームのアイデアと機能

次に追加する機能

実績

各キーはプレイヤーごとに一度だけ解除されます。手動ルールはゲームを信頼し、統計しきい値は対象報告と同じトランザクションで評価します。

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

操作後、同じプレイヤーのfirst_stepsが解除されます。同じキーを再実行しても追加の実績や報酬は得られません。

動画は後日公開

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

実績

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

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

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

    キー
    first_steps
    名前
    First steps
    解除ルール
    manual
    有効
    true
    解除まで非表示
    false
    報酬なし
    []

    各キーはプレイヤーごとに一度だけ解除されます。手動ルールはゲームを信頼し、統計しきい値は対象報告と同じトランザクションで評価します。

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

この機能を実装する

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

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

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

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

GDScript
res://scripts/achievements.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 unlocks the shown configured achievement key.
6func run_reviewed_action() -> void:
7 if not Horizon.auth.isSignedIn():
8 return
9 var user_id: String = Horizon.auth.getCurrentUser().userId
10 var loaded: Dictionary = await Horizon.achievements.getAchievements(user_id, "")
11 if not loaded.success:
12 push_warning(loaded.errorCode)
13 return
14 for progress in loaded.data.progress:
15 print(progress.key, ": ", progress.rewardState)
16​
17 # Configure manual first_steps; invoke on the corresponding game action.
18 var unlocked: Dictionary = await Horizon.achievements.unlock(user_id, "first_steps")
19 if not unlocked.success:
20 push_warning(unlocked.errorCode) # After timeout retry the same key.
21 return
22 # Complete progress has no unlock date or pending reward payload.
23 # Values were credited atomically. Refresh playerValues when displaying balances.
24 # No Inbox claim or local value addition. Retry the original key after an uncertain reply.
完全なSDKサンプルを開く ↗

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

操作後、同じプレイヤーのfirst_stepsが解除されます。同じキーを再実行しても追加の実績や報酬は得られません。

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

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

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

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