> ## 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.

# PartyRegionUpdateMode

> 組態模式，代表 Party 程式庫如何執行自動區域探索和連線品質測量。

組態模式，代表 Party 程式庫如何在 [PartyRegionUpdateConfiguration](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/structs/partyregionupdateconfiguration.md) 結構中執行自動區域探索和連線品質測量。

## 語法

```cpp theme={null}
enum class PartyRegionUpdateMode    
{  
    Immediate = 0,  
    Deferred = 1,  
}  
```

## 常數

| 常數 | 描述 |
| - | - |
| Immediate | 盡快自動開始擷取可用區域清單並測量與其之間的連線品質。  第一次叫用 PartyManager::Initialize() 時，Party 程式庫會自動探索可用區域並測量與其之間的連線品質。   Party 程式庫也會定期重新整理清單和品質測量，直到呼叫 PartyManager::Cleanup() 為止。如果已連線或正在連線到現有的 Party 網路，則會延遲重新整理，直到與所有 Party 網路中斷連線為止。可以使用所屬 [PartyRegionUpdateConfiguration](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/structs/partyregionupdateconfiguration.md) 結構中的 *refreshIntervalInSeconds* 欄位設定定期重新整理間隔。     每當測量作業完成時，應用程式都會自動收到表示可用區域或失敗 [PartyStateChangeResult](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/enums/partystatechangeresult.md) 的 [PartyRegionsChangedStateChange](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange.md)。     如果未設定 [PartyOption::RegionUpdateConfiguration](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/enums/partyoption.md)，此模式就是預設值。 |
| Deferred | 延後擷取可用區域清單並測量與其之間的連線品質，直到建立新的 Party 網路或使用特定文字轉語音或語音轉文字功能為止。  除非應用程式以零個項目的區域清單陣列呼叫 [PartyManager::CreateNewNetwork()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createnewnetwork.md)，或在未連線到現有網路的情況下呼叫 [PartyLocalChatControl::PopulateAvailableTextToSpeechProfiles()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_populateavailabletexttospeechprofiles.md)、[PartyLocalChatControl::SetTextToSpeechProfile()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settexttospeechprofile.md)，或以包含 [PartyVoiceChatTranscriptionOptions::TranscribeSelfRegardlessOfNetworkState](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/enums/partyvoicechattranscriptionoptions.md) 的選項旗標呼叫 [PartyLocalChatControl::SetTranscriptionOptions()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settranscriptionoptions.md)，否則 Party 程式庫不會自動探索可用區域或測量與其之間的連線品質。一旦開始延後的區域探索和品質測量，就會在觸發作業的 [PartyCreateNewNetworkCompletedStateChange](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/structs/partycreatenewnetworkcompletedstatechange.md)、[PartyPopulateAvailableTextToSpeechProfilesCompletedStateChange](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/structs/partypopulateavailabletexttospeechprofilescompletedstatechange.md)、[PartySetTextToSpeechProfileCompletedStateChange](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/structs/partysettexttospeechprofilecompletedstatechange.md) 或 [PartySetTranscriptionOptionsCompletedStateChange](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/structs/partysettranscriptionoptionscompletedstatechange.md) 完成狀態變更之前，提供表示可用區域或失敗 [PartyStateChangeResult](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/enums/partystatechangeresult.md) 的 [PartyRegionsChangedStateChange](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange.md)。   在後續以上述參數呼叫上述函式時，如果自上次成功執行測量以來已經過重新整理間隔，就會再次擷取並測量區域清單。如果已連線或正在連線到現有的 Party 網路，則會延遲重新整理，直到與所有 Party 網路中斷連線為止。可以使用所屬 [PartyRegionUpdateConfiguration](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/structs/partyregionupdateconfiguration.md) 結構中的 *refreshIntervalInSeconds* 欄位設定重新整理間隔。     聊天控制項在內部會使用本機裝置的區域延遲估計值，以最佳化文字轉語音合成、語音轉文字轉譯和翻譯的服務使用量。使用 PartyRegionUpdateMode::Deferred 可能會導致這些功能的延遲較高。 |

## 需求

**標頭：** 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)\
[PartyRegionUpdateConfiguration](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/structs/partyregionupdateconfiguration.md)\
[PartyRegionsChangedStateChange](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange.md)\
[PartyCreateNewNetworkCompletedStateChange](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/structs/partycreatenewnetworkcompletedstatechange.md)\
[PartyPopulateAvailableTextToSpeechProfilesCompletedStateChange](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/structs/partypopulateavailabletexttospeechprofilescompletedstatechange.md)\
[PartySetTextToSpeechProfileCompletedStateChange](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/structs/partysettexttospeechprofilecompletedstatechange.md)\
[PartySetTranscriptionOptionsCompletedStateChange](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/structs/partysettranscriptionoptionscompletedstatechange.md)\
[PartyManager::Initialize](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_initialize.md)\
[PartyManager::CreateNewNetwork](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createnewnetwork.md)\
[PartyLocalChatControl::PopulateAvailableTextToSpeechProfiles](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_populateavailabletexttospeechprofiles.md)\
[PartyLocalChatControl::SetTextToSpeechProfile](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settexttospeechprofile.md)\
[PartyLocalChatControl::SetTranscriptionOptions](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settranscriptionoptions.md)


## Related topics

- [PartyRegionUpdateConfiguration](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/structs/partyregionupdateconfiguration.md)
- [PartyRegionsChangedStateChange](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange.md)
- [PartyLocalChatControl::PopulateAvailableTextToSpeechProfiles](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_populateavailabletexttospeechprofiles.md)
- [PartyManager::GetRegions](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getregions.md)
- [PartyLocalChatControl::SetTranscriptionOptions](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settranscriptionoptions.md)