PartyRegionUpdateConfiguration

Party 库用于控制其执行自动区域发现和连接质量度量更新的方式的配置。

语法

struct PartyRegionUpdateConfiguration {  
    PartyRegionUpdateMode mode;  
    uint32_t refreshIntervalInSeconds;  
}  

成员

mode PartyRegionUpdateMode

控制何时执行区域发现和连接质量度量更新的模式。

如果尚未配置 PartyOption::RegionUpdateConfiguration，默认值为 PartyRegionUpdateMode::Immediate。

refreshIntervalInSeconds uint32_t

在区域质量测量完成后允许经过的秒数，然后才能开始新的区域发现和连接质量测量过程。

每当提供 PartyRegionsChangedStateChange 来确定下一个区域质量度量何时有资格在模式字段定义的更新模式下启动时，就会使用此刷新间隔。

符合刷新条件并不能保证刷新在该时间开始。 如果模式字段设置为 PartyRegionUpdateMode::Deferred，则在调用其中一个适用的方法来触发区域更新之前，不会进行下一次刷新。 库还会等待本地设备不再位于任何 Party 网络中，并应用少量随机延迟，以避免来自多个无意中同步的多个设备的 PlayFab 服务负载。

如果尚未配置 PartyOption::RegionUpdateConfiguration，默认值为 28800（8 小时）。

值为零会导致 Party 库以后永远不会自动刷新度量值。 否则，允许的最小值为 30 秒。

备注

此结构可与 PartyOption::RegionUpdateConfiguration 一起使用，分别通过 PartyManager::SetOption() 和 PartyManager::GetOption() 替代或查询 Party 库的当前配置。 它配置区域发现和连接质量测量进程的行为，该进程会产生 PartyRegionsChangedStateChange 状态变化。

要求

标题： Party.h

另请参阅

群成员
PartyOption::RegionUpdateConfiguration
PartyRegionUpdateMode
PartyRegionsChangedStateChange
PartyManager::SetOption
PartyManager::GetOption