ゲームのアイデアと機能

次に追加する機能

マッチ

明示的なリビジョン、不透明な状態、個別の結果報告を使うターン制ゲーム。

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

二人のプレイヤーセッションでロビー、交互のターン、独立した最終レポートを調整します。

動画は後日公開

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

ターン制マッチ

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

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

    マッチ →
  2. 最初のリクエストに追加の定義は不要です。対応するゲームデータがなければ、空の結果も正常です。

    別々の二人のセッションでロビー作成、参加、順序指定の開始、交互のバイト状態送信を行い、同じ最終結果をそれぞれ報告します。

    最初の例はデータの読み取りです。グループ、マッチ、オブジェクトは作成しません。空のリストも正常な初回応答です。

この機能を実装する

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

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

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

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

GDScript
res://scripts/matches.gd
horizOn 呼び出し
1extends Node
2​
3# Explicit action after restoring the SAME existing player identity.
4func read_my_matches() -> void:
5 var user = Horizon.auth.getCurrentUser()
6 if user == null:
7 return
8 var result = await Horizon.matches.getMatches(user.userId)
9 if not result.success:
10 push_warning(result.errorCode)
11 return
12 print("Ledger revision: ", result.data.revision)
13 for row in result.data.recent:
14 print(row.id, " ", row.status) # May still be active after this player's forfeit.
15 # Respect result.data.pollAfterSeconds. No background poll.
16# Full two-player, durable-original example in the verified SDK:
17# addons/horizon_sdk/examples/features/matches_example.gd
18# read_matches()/create_reviewed(options), read_match(id), perform_reviewed(kind, body).
19# Each is an explicit player action. Original project+player intent survives host changes.
20# SDK methods: joinMatch(userId,id,originalRevision), startMatch(userId,id,originalRevision,order),
21# submitTurn(userId,id,originalRevision,PackedByteArray,finish),
22# reportResult(userId,id,originalFinalRevision,PackedByteArray,sortedWinnerIds).
23# Unknown create: recovery reads and explicit reconciliation, never a replacement create.
24# Report agreement is ordinary consensus, not validated combat or an automatic reward.
完全なSDKサンプルを開く ↗

二人のプレイヤーと元のターン

別々の二人のセッションでロビー作成、参加、順序指定の開始、交互のバイト状態送信を行い、同じ最終結果をそれぞれ報告します。

送信前に正確なリクエストを保存します。タイムアウト後は状態を読み照合します。リビジョンや元の意図を黙って置き換えません。

報告には不変の最終リビジョンを使います。一致は信頼できる勝利の証明ではなく、不一致や報告不足で勝者を推測しません。

ランク実行には確認済みランクマッチと既存のValidated Actions処理が必要です。通常の報告は報酬を付与しません。

PHPは通常のマッチRESTルートに対応します。ランク検証とリアルタイムは利用できず、必要に応じてFEATURE_NOT_SUPPORTEDを返します。

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

二人のプレイヤーセッションでロビー、交互のターン、独立した最終レポートを調整します。

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

エンドポイント
  • GET/matches
  • GET/matches/limits
  • GET/matches/open
  • GET/matches/{matchId}
  • POST/matches
  • POST/matches/{matchId}/join
  • POST/matches/{matchId}/decline
  • POST/matches/{matchId}/start
  • POST/matches/{matchId}/turn
  • POST/matches/{matchId}/timeout
  • POST/matches/{matchId}/leave
  • POST/matches/{matchId}/cancel
  • POST/matches/{matchId}/result
  • POST/matches/{matchId}/ranked-run
API リファレンスのすべてのエンドポイント
リーダーボードのイラスト
次のステップへのおすすめ

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

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