> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PartyRegionUpdateConfiguration

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

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

## 语法

```cpp theme={null}
struct PartyRegionUpdateConfiguration {  
    PartyRegionUpdateMode mode;  
    uint32_t refreshIntervalInSeconds;  
}  
```

### 成员

**`mode`**   [PartyRegionUpdateMode](/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode)

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

当未配置 [PartyOption::RegionUpdateConfiguration](/services/playfab/multiplayer/networking/reference/enums/partyoption) 时,默认值为 [PartyRegionUpdateMode::Immediate](/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode)。

**`refreshIntervalInSeconds`**   uint32\_t

在区域质量测量完成后,允许经过的秒数,之后才可开始新一轮的区域发现和连接质量测量过程。

每当提供 [PartyRegionsChangedStateChange](/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange) 时,都会使用此刷新间隔来确定在 *mode* 字段定义的更新模式下下一次区域质量测量何时可以开始。<br /><br /> 达到刷新条件并不保证刷新会在精确时间点开始。如果 *mode* 字段设置为 [PartyRegionUpdateMode::Deferred](/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode),则在调用某个适用方法触发区域更新之前,下一次刷新不会发生。库还会等待直到本地设备不再位于任何 Party 网络中,并应用少量随机化延迟以尽量避免多个非有意同步的设备对 PlayFab 服务造成负载。<br /><br /> 当未配置 [PartyOption::RegionUpdateConfiguration](/services/playfab/multiplayer/networking/reference/enums/partyoption) 时,默认值为 28800(8 小时)。<br /><br /> 值为零会导致 Party 库将来永远不会自动刷新测量。否则,允许的最小值为 30 秒。

## 备注

此结构可与 [PartyOption::RegionUpdateConfiguration](/services/playfab/multiplayer/networking/reference/enums/partyoption) 一起使用,通过 [PartyManager::SetOption()](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_setoption) 或 [PartyManager::GetOption()](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getoption) 分别覆盖或查询 Party 库的当前配置。它配置的是产生 [PartyRegionsChangedStateChange](/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange) 状态更改的区域发现和连接质量测量过程的行为。

## 要求

**头文件:** Party.h

## 另请参阅

[Party 成员](/services/playfab/multiplayer/networking/reference/party_members)\
[PartyOption::RegionUpdateConfiguration](/services/playfab/multiplayer/networking/reference/enums/partyoption)\
[PartyRegionUpdateMode](/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode)\
[PartyRegionsChangedStateChange](/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange)\
[PartyManager::SetOption](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_setoption)\
[PartyManager::GetOption](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getoption)


## Related topics

- [PartyRegionUpdateMode](/zh-CN/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode.md)
- [PartyOption](/zh-CN/services/playfab/multiplayer/networking/reference/enums/partyoption.md)
- [Party C/C++ API 概述](/zh-CN/services/playfab/multiplayer/networking/reference/party_members.md)
- [PartyRegionQualityMeasurementConfiguration](/zh-CN/services/playfab/multiplayer/networking/reference/structs/partyregionqualitymeasurementconfiguration.md)
- [PartyRegionsChangedStateChange](/zh-CN/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange.md)