XblMultiplayerManagerFindMatch
向服务器提交匹配请求。语法
参数
hopperName _In_z_类型:char* 此请求的 hopper 名称。 attributesJson _In_opt_z_
类型:char* 可选。此请求的匹配票证的属性,采用 JSON 字符串格式。 timeoutInSeconds _In_
类型:uint32_t 等待用户加入匹配的最长时间(以秒为单位)。
返回值
类型:HRESULT 此 API 操作的 HRESULT 返回代码。备注
此函数将大厅会话的匹配请求提交到多人游戏管理器 (MPM)。在使用此函数之前,必须首先在游戏的服务配置中配置 hopper。hopper 定义 SmartMatch 用于匹配玩家的规则。有关 hopper 的详细信息,请参阅匹配概述。如果大厅会话不存在(可能是因为未调用 XblMultiplayerManagerInitialize),或者在调用此函数之前未将本地用户添加到大厅会话,则会发生错误。如果匹配已在进行中,也会发生错误。此函数的结果作为多人游戏事件传递,事件类型设置为
XblMultiplayerEventType::FindMatchCompleted。你可以调用 XblMultiplayerManagerDoWork 检索多人游戏事件。
要求
头文件: multiplayer_manager_c.h 库: Microsoft.Xbox.Services.14x.GDK.C.lib另请参阅
multiplayer_manager_cXblMultiplayerManagerEstimatedMatchWaitTime
