跳转到主要内容
控制 QoS 区域 ping 操作的选项。向 PFMultiplayerServerPingQosServersAsync 传递 NULL 可使用下文所述的默认值。

语法

成员

timeoutMs uint32_t 每次 ping 的接收超时(以毫秒为单位)。如果某次 ping 在此时间范围内未收到有效回显,则计为失败。默认值为 250。 pingsPerRegion uint32_t 每个区域的 ping 迭代次数。报告的 latencyMs 是成功迭代的算术平均值。默认值为 3。 maxConcurrentRegions uint32_t 同时探测的最大区域数。在探测某个区域期间,会为该区域打开一个 UDP 套接字。默认值为 0,表示“同时探测所有区域”。 includeAllRegions bool 如果为 true,则请求 ListQosServersForTitle 返回每个 Azure 区域的信标,而不仅仅是该 Title 已部署生成的区域。默认值为 false。 routingPreference const char*
is null-terminated
转发给 ListQosServersForTitle 的路由首选项,用于选择服务返回哪些信标 VIP。接受 MultiplayerServer RoutingType 枚举定义的字符串:“Microsoft”(默认值 — 其 Azure 公共 IP 标记为 Microsoft 网络层级路由的信标,路径尽可能多地经过 Azure 主干网)或“Internet”(端到端通过公共 Internet 路由的信标)。NULL 或空值表示不设置该字段,服务将应用其默认值(“Microsoft”)。如果某个 Title 发布了具有两种路由类型的数据平面 VIP,则应调用此 API 两次(每种首选项各一次),并根据玩家实际使用的数据平面对区域进行排名。

要求

头文件: PFMultiplayerServerQoS.h

另请参阅

PFMultiplayerServerQoS 成员
最后修改于 2026年10月16日