PartyRegionsChangedStateChange

特定于 RegionsChanged 类型状态更改的信息。

语法

struct PartyRegionsChangedStateChange : PartyStateChange {  
    PartyStateChangeResult result;  
    PartyError errorDetail;  
}  

result PartyStateChangeResult 指示查询受支持区域列表以及到每个区域延迟的后台操作是否成功,或提供其失败的原因。当结果为 PartyStateChangeResult::Succeeded 时,PartyManager::GetRegions() 提供的区域列表将填充为操作结果。失败时,PartyManager::GetRegions() 提供的区域列表为空。

如果结果为 PartyStateChangeResult::FailedToBindToLocalUdpSocket,则库无法绑定到在 PartyOption::LocalUdpSocketBindAddress 选项中指定的本地 UDP 套接字。游戏必须清理其库实例,将 PartyOption::LocalUdpSocketBindAddress 选项更新为有效可用的绑定地址,然后重新初始化库。 errorDetail PartyError 一个诊断值,提供有关任何潜在错误情况的更多故障排除信息。此错误详情的可读形式可通过 PartyManager::GetErrorMessage() 获取。

检索可用区域列表并测量与其的连接质量会在后台自动进行。除非使用 PartyOption::RegionUpdateConfiguration 选项将更新模式配置为 PartyRegionUpdateMode::Deferred(在这种情况下,区域更新可能根本不会发生),否则此操作首次是在调用 PartyManager::Initialize() 时启动的。仅当应用程序调用 PartyManager::CreateNewNetwork() 且传入零条目区域数组,或未连接到现有网络但调用 PartyLocalChatControl::PopulateAvailableTextToSpeechProfiles()、PartyLocalChatControl::SetTextToSpeechProfile() 或 PartyLocalChatControl::SetTranscriptionOptions() 且选项标志包含 PartyVoiceChatTranscriptionOptions::TranscribeSelfRegardlessOfNetworkState 时,才会发生延迟的区域更新。PartyOption::RegionUpdateConfiguration 选项还可用于配置刷新区域的时间间隔。

检索可用区域列表并测量与其的连接质量所花费的时间取决于诸多环境或动态因素,以及是否使用 PartyOption::RegionQualityMeasurementConfiguration 选项修改了底层测量设置。PartyRegionQualityMeasurementConfiguration 结构中的 totalMeasurementTimeoutInMilliseconds 字段用于配置在认为所有测量完成并生成此状态更改之前的最坏情况最大超时。

头文件: Party.h