Skip to main content
Party 库用于控制其如何执行自动区域发现和连接质量测量更新的配置。

语法

成员

mode   PartyRegionUpdateMode 控制何时执行区域发现和连接质量测量更新的模式。 当未配置 PartyOption::RegionUpdateConfiguration 时,默认值为 PartyRegionUpdateMode::Immediate refreshIntervalInSeconds   uint32_t 在区域质量测量完成后,允许经过的秒数,之后才可开始新一轮的区域发现和连接质量测量过程。 每当提供 PartyRegionsChangedStateChange 时,都会使用此刷新间隔来确定在 mode 字段定义的更新模式下下一次区域质量测量何时可以开始。

达到刷新条件并不保证刷新会在精确时间点开始。如果 mode 字段设置为 PartyRegionUpdateMode::Deferred,则在调用某个适用方法触发区域更新之前,下一次刷新不会发生。库还会等待直到本地设备不再位于任何 Party 网络中,并应用少量随机化延迟以尽量避免多个非有意同步的设备对 PlayFab 服务造成负载。

当未配置 PartyOption::RegionUpdateConfiguration 时,默认值为 28800(8 小时)。

值为零会导致 Party 库将来永远不会自动刷新测量。否则,允许的最小值为 30 秒。

备注

此结构可与 PartyOption::RegionUpdateConfiguration 一起使用,通过 PartyManager::SetOption()PartyManager::GetOption() 分别覆盖或查询 Party 库的当前配置。它配置的是产生 PartyRegionsChangedStateChange 状态更改的区域发现和连接质量测量过程的行为。

要求

头文件: Party.h

另请参阅

Party 成员
PartyOption::RegionUpdateConfiguration
PartyRegionUpdateMode
PartyRegionsChangedStateChange
PartyManager::SetOption
PartyManager::GetOption
最后修改于 2026年8月25日