PartyRegionUpdateMode - XBOX Game Development Documentation

配置模式，表示 Party 库如何执行自动区域发现和连接质量测量，作为 PartyRegionUpdateConfiguration 结构的一部分。

Syntax

enum class PartyRegionUpdateMode    
{  
    Immediate = 0,  
    Deferred = 1,  
}  

Constants

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

Requirements

Header: Party.h

See also

Party members
PartyOption::RegionUpdateConfiguration
PartyRegionUpdateConfiguration
PartyRegionsChangedStateChange
PartyCreateNewNetworkCompletedStateChange
PartyPopulateAvailableTextToSpeechProfilesCompletedStateChange
PartySetTextToSpeechProfileCompletedStateChange
PartySetTranscriptionOptionsCompletedStateChange
PartyManager::Initialize
PartyManager::CreateNewNetwork
PartyLocalChatControl::PopulateAvailableTextToSpeechProfiles
PartyLocalChatControl::SetTextToSpeechProfile
PartyLocalChatControl::SetTranscriptionOptions

最后修改于 2026年8月13日

相关主题

PartyRegionUpdateConfiguration PartyRegionsChangedStateChange PartyLocalChatControl::PopulateAvailableTextToSpeechProfiles PartyManager::GetRegions PartyLocalChatControl::SetTranscriptionOptions

⌘I