> ## 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-CN/services/playfab/multiplayer/networking/reference/structs/partyregionupdateconfiguration.md) 结构的一部分。

## Syntax

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

## Constants

| Constant | Description |
| - | - |
| Immediate | 尽快自动开始检索可用区域列表并测量到这些区域的连接质量。  首次调用 PartyManager::Initialize() 时，Party 库会自动发现可用区域并测量到这些区域的连接质量。  Party 库还会定期刷新列表和质量测量，直到调用 PartyManager::Cleanup()。如果已连接到或正在连接到现有 Party 网络，则刷新会推迟到从所有 Party 网络断开连接后。可以使用所含 [PartyRegionUpdateConfiguration](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/structs/partyregionupdateconfiguration.md) 结构中的 *refreshIntervalInSeconds* 字段配置定期刷新间隔。     每当测量操作完成时，都会自动向应用程序提供指示可用区域的 [PartyRegionsChangedStateChange](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange.md) 或失败 [PartyStateChangeResult](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/enums/partystatechangeresult.md)。     当 [PartyOption::RegionUpdateConfiguration](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/enums/partyoption.md) 尚未配置时，此模式为默认值。 |
| Deferred | 推迟检索可用区域列表和测量到这些区域的连接质量，直到创建新的 Party 网络或使用某些文本转语音或语音转文本功能时才执行。  Party 库不会自动发现可用区域或测量到这些区域的连接质量，除非应用程序使用零条目的区域列表数组调用 [PartyManager::CreateNewNetwork()](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createnewnetwork.md)，或者未连接到现有网络但调用 [PartyLocalChatControl::PopulateAvailableTextToSpeechProfiles()](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_populateavailabletexttospeechprofiles.md)、[PartyLocalChatControl::SetTextToSpeechProfile()](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settexttospeechprofile.md) 或使用包含 [PartyVoiceChatTranscriptionOptions::TranscribeSelfRegardlessOfNetworkState](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/enums/partyvoicechattranscriptionoptions.md) 的选项标志调用 [PartyLocalChatControl::SetTranscriptionOptions()](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settranscriptionoptions.md)。一旦推迟的区域发现和质量测量启动，在触发操作的 [PartyCreateNewNetworkCompletedStateChange](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/structs/partycreatenewnetworkcompletedstatechange.md)、[PartyPopulateAvailableTextToSpeechProfilesCompletedStateChange](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/structs/partypopulateavailabletexttospeechprofilescompletedstatechange.md)、[PartySetTextToSpeechProfileCompletedStateChange](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/structs/partysettexttospeechprofilecompletedstatechange.md) 或 [PartySetTranscriptionOptionsCompletedStateChange](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/structs/partysettranscriptionoptionscompletedstatechange.md) 完成状态更改之前，会提供指示可用区域的 [PartyRegionsChangedStateChange](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange.md) 或失败 [PartyStateChangeResult](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/enums/partystatechangeresult.md)。  在后续使用所述参数调用上述函数时，如果自上次成功执行测量以来已经过了刷新间隔，则会再次检索并测量区域列表。如果已连接到或正在连接到现有 Party 网络，则刷新会推迟到从所有 Party 网络断开连接后。可以使用所含 [PartyRegionUpdateConfiguration](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/structs/partyregionupdateconfiguration.md) 结构中的 *refreshIntervalInSeconds* 字段配置刷新间隔。     聊天控件在内部使用本地设备区域延迟估计，以优化文本转语音合成、语音转文本转录和翻译的服务使用。使用 PartyRegionUpdateMode::Deferred 可能导致这些功能出现更高的延迟。 |

## Requirements

**Header:** Party.h

## See also

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


## Related topics

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