XblMultiplayerManagerFindMatch

  • [アーティクル]

マッチメイキング要求をサーバーに送信します。

構文

HRESULT XblMultiplayerManagerFindMatch(  
         const char* hopperName,  
         const char* attributesJson,  
         uint32_t timeoutInSeconds  
)

パラメーター

hopperName _In_z_
型: char*

この要求のホッパーの名前。

attributesJson_In_opt_z_
型: char*

省略可能。 JSON 文字列としての、この要求のマッチ チケットの属性。

timeoutInSeconds_In_
型: uint32_t

ユーザーがマッチに参加するまで待機する最長時間 (秒)。

戻り値

型: HRESULT

この API 操作の HRESULT 結果コード。

解説

この関数は、ロビー セッションのマッチメイキング要求をマルチプレイヤー マネージャー (MPM) に送信します。 この関数を使用するには、まずタイトルのサービス構成でホッパーを構成する必要があります。 Hopper は、SmartMatch がプレイヤーのマッチングに使用する規則を定義します。 ホッパーの詳細については、「マッチメイキングの概要」を参照してください。 ロビー セッションが存在しない場合は、XblMultiplayerManagerInitialize が呼び出されなかった可能性があります。またはこの関数を呼び出す前にローカル ユーザーがロビー セッションに追加されなかった場合は、エラーが発生します。 マッチメイキングが既に進行中の場合にも、エラーが発生します。
この関数の結果は、イベントの種類が XblMultiplayerEventType::FindMatchCompleted に設定されたマルチプレイヤー イベントとして配信されます。 XblMultiplayerManagerDoWork を呼び出して、マルチプレイヤー イベントを取得できます。

要件

ヘッダー: multiplayer_manager_c.h

図書館： Microsoft.Xbox.Services.14x.GDK.C.lib

関連項目

multiplayer_manager_c
XblMultiplayerManagerEstimatedMatchWaitTime