> ## 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-TW/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode.md)

控制何時執行區域探索和連線品質測量更新的模式。

尚未設定 [PartyOption::RegionUpdateConfiguration](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/enums/partyoption.md) 時，預設值為 [PartyRegionUpdateMode::Immediate](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode.md)。

**`refreshIntervalInSeconds`**   uint32\_t

區域品質測量完成後，必須經過多少秒才能開始新的區域探索和連線品質測量程序。

每當提供 [PartyRegionsChangedStateChange](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange.md) 時，都會使用此重新整理間隔，以判斷在 *mode* 欄位所定義的更新模式下，下一次區域品質測量何時符合開始的資格。\
\
 符合重新整理資格並不保證重新整理會在該確切時間開始。如果 *mode* 欄位設定為 [PartyRegionUpdateMode::Deferred](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode.md)，則在呼叫其中一個適用方法來觸發區域更新之前，不會進行下一次重新整理。程式庫也會等到本機裝置不再位於任何 Party 網路中，並套用少量的隨機延遲，以盡量避免多部無意間同步的裝置對 PlayFab 服務造成負載。\
\
 尚未設定 [PartyOption::RegionUpdateConfiguration](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/enums/partyoption.md) 時，預設值為 28800 (8 小時)。\
\
 值為零會讓 Party 程式庫在未來永遠不會自動重新整理測量。否則，允許的最小值為 30 秒。

## 備註

此結構可與 [PartyOption::RegionUpdateConfiguration](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/enums/partyoption.md) 搭配使用，分別透過 [PartyManager::SetOption()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_setoption.md) 或 [PartyManager::GetOption()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getoption.md) 覆寫或查詢 Party 程式庫目前的設定。它會設定產生 [PartyRegionsChangedStateChange](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange.md) 狀態變更之區域探索和連線品質測量程序的行為。

## 需求

**標頭：** Party.h

## 另請參閱

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


## Related topics

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