> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode.md)

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

当未配置 [PartyOption::RegionUpdateConfiguration](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/enums/partyoption.md) 时,默认值为 [PartyRegionUpdateMode::Immediate](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode.md)。

**`refreshIntervalInSeconds`**   uint32\_t

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

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

## 备注

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

## 要求

**头文件:** Party.h

## 另请参阅

[Party 成员](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/party_members.md)\
[PartyOption::RegionUpdateConfiguration](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/enums/partyoption.md)\
[PartyRegionUpdateMode](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode.md)\
[PartyRegionsChangedStateChange](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange.md)\
[PartyManager::SetOption](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_setoption.md)\
[PartyManager::GetOption](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getoption.md)


## Related topics

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