Skip to main content

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_c
XblMultiplayerManagerEstimatedMatchWaitTime
最后修改于 2026年8月13日