通过

XblMultiplayerManagerFindMatch

  • 项目

向服务器提交匹配请求。

语法

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

参数

hopperName _In_z_
类型：char*

此请求的 hopper 的名称。

attributesJson _In_opt_z_
类型：char*

可选。 此请求的匹配票证的属性，作为 JSON 字符串。

timeoutInSeconds _In_
类型：uint32_t

等待用户加入匹配的最长时间（以秒计）。

返回值

类型：HRESULT

此 API 操作的 HRESULT 返回代码。

备注

此函数向多人游戏管理器 (MPM) 提交大厅会话的匹配请求。 必须先在游戏的服务配置中配置 hopper，然后才能使用此函数。 漏斗定义 SmartMatch 用于匹配玩家的规则。 有关 hopper 的详细信息，请参阅匹配概述。 如果大厅会话不存在，可能是因为未调用 XblMultiplayerManagerInitialize 或者在调用此函数之前未将本地用户添加到大厅会话，则会发生错误。 如果匹配已在进行，也会发生错误。
此函数的结果作为多人游戏事件传递，事件类型设置为 XblMultiplayerEventType::FindMatchCompleted。 可以调用 XblMultiplayerManagerDoWork 来检索多人游戏事件。

要求

头文件：multiplayer_manager_c.h

图书馆： Microsoft.Xbox.Services.14x.GDK.C.lib

另请参阅

multiplayer_manager_c
XblMultiplayerManagerEstimatedMatchWaitTime