メインコンテンツまでスキップ

オーバーライド可能なマッチメイキング V2 メソッドのライフサイクル

Last updated on February 4, 2026

注釈:本資料はAI技術を用いて翻訳されています。

オーバーライド可能なAccelByte Gaming Services(AGS)マッチメイキングメソッドのライフサイクルは、マッチメイキングの開始リクエストが送信された後のプレイヤーまたはパーティのデフォルトフローと、オーバーライド可能なマッチメイキングメソッドが呼び出されるタイミングを追跡します。マッチメイキングの詳細については、MatchmakingV2の開始を参照してください。

マッチメイキングライフサイクル

マッチメイキングは、プレイヤーがマッチを見つけるリクエストをしてから、マッチが見つかるかチケットがタイムアウト期間に達するまでのプロセスです。プロセスは2つの部分に分かれています:

  1. マッチチケットライフサイクルは、プレイヤーがマッチチケットを送信してマッチを見つけることから始まり、サービスによってハイドレート、エンリッチ、検証され、新しい洗練されたマッチチケットが作成されてマッチメイキングにエンキューされるまで続きます。

    Image shows the lifecycle for matchTicket

    詳細については、マッチチケットライフサイクルの理解を参照してください。

  2. マッチメイキングライフサイクルは、サービスが洗練されたマッチチケットを取得したときに定期的に更新および開始されます。次に、マッチチケットを他の一致するマッチチケットとペアリングし、マッチが見つかります。

    Image shows matchmaking process lifecycle

オーバーライド可能なマッチメイキングメソッド

マッチメイキングプロセス中に、オーバーライドできる5つのメソッドがあります:

  1. RPC GetStatCodes(GetStatCodesRequest) returns (StatCodesResponse): マッチチケット内のプレイヤー属性に追加されるコードと値のリストをオーバーライドまたは拡張します。このメソッドは、マッチチケットがハイドレートされるときに呼び出されます。

  2. RPC EnrichTicket(EnrichTicketRequest) returns (EnrichTicketResponse): チケット属性に追加の値を追加します。例えば、外部ソースから値を挿入します。このメソッドは、チケットがハイドレートされた後に呼び出されます。

  3. RPC ValidateTicket(ValidateTicketRequest) returns (ValidateTicketResponse): チケットを検証するロジックをオーバーライドまたは拡張します。例えば、ルールセットが有効かどうかを確認します。このメソッドは、チケットがハイドレートおよびエンリッチされた後に呼び出されます。

  4. RPC MakeMatches(stream MakeMatchesRequest) returns (stream MatchResponse): 新しいチケットのキューからチケットをマッチングする実装をオーバーライドします。このメソッドは定期的に呼び出され、キュー内のチケットを入力として受け取ります。間隔は設定可能で、デフォルト時間は最小10秒、最大30秒です。

  5. RPC BackfillMatches(stream BackfillMakeMatchesRequest) returns (stream BackfillResponse): バックフィルチケットを処理するキューからチケットをマッチングする実装をオーバーライドします。これはMakeMatchesが呼び出される前に呼び出されます。