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

## Syntax

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

## Constants

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

## Requirements

**Header:** Party.h

## See also

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


## Related topics

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