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

# PartyRegionUpdateMode

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

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

## 語法

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

## 常數

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

## 需求

**標頭：** Party.h

## 另請參閱

[Party 成員](/zh-TW/services/playfab/multiplayer/networking/reference/party_members)\
[PartyOption::RegionUpdateConfiguration](/zh-TW/services/playfab/multiplayer/networking/reference/enums/partyoption)\
[PartyRegionUpdateConfiguration](/zh-TW/services/playfab/multiplayer/networking/reference/structs/partyregionupdateconfiguration)\
[PartyRegionsChangedStateChange](/zh-TW/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange)\
[PartyCreateNewNetworkCompletedStateChange](/zh-TW/services/playfab/multiplayer/networking/reference/structs/partycreatenewnetworkcompletedstatechange)\
[PartyPopulateAvailableTextToSpeechProfilesCompletedStateChange](/zh-TW/services/playfab/multiplayer/networking/reference/structs/partypopulateavailabletexttospeechprofilescompletedstatechange)\
[PartySetTextToSpeechProfileCompletedStateChange](/zh-TW/services/playfab/multiplayer/networking/reference/structs/partysettexttospeechprofilecompletedstatechange)\
[PartySetTranscriptionOptionsCompletedStateChange](/zh-TW/services/playfab/multiplayer/networking/reference/structs/partysettranscriptionoptionscompletedstatechange)\
[PartyManager::Initialize](/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_initialize)\
[PartyManager::CreateNewNetwork](/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createnewnetwork)\
[PartyLocalChatControl::PopulateAvailableTextToSpeechProfiles](/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_populateavailabletexttospeechprofiles)\
[PartyLocalChatControl::SetTextToSpeechProfile](/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settexttospeechprofile)\
[PartyLocalChatControl::SetTranscriptionOptions](/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settranscriptionoptions)


## Related topics

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