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() 检索此错误详细信息的可读形式。

会自动在后台检索可用区域列表并测量它们的连接质量。此操作首先在 PartyManager::Initialize() 被调用时启动，除非使用 PartyOption::RegionUpdateConfiguration 选项来配置 PartyRegionUpdateMode::Deferred 的更新模式，在这种情况下，可能根本不会进行区域更新。只有当应用程序在有零条目区域数组的情况下调用 PartyManager::CreateNewNetwork()，或者未连接到现有网络，但在选项标记包含 PartyVoiceChatTranscriptionOptions::TranscribeSelfRegardlessOfNetworkState 的情况下调用 PartyLocalChatControl::PopulateAvailableTextToSpeechProfiles()、PartyLocalChatControl::SetTextToSpeechProfile() 或 PartyLocalChatControl::SetTranscriptionOptions() 时，区域更新才会延迟。 PartyOption::RegionUpdateConfiguration 选项还可用于配置区域刷新的间隔。

检索可用区域列表和测量到它们的连接质量所需的时间取决于许多环境因素和动态因素，还取决于 PartyOption::RegionQualityMeasurementConfiguration 选项是否用于修改低级别测量设置。 PartyRegionQualityMeasurementConfiguration 结构中的 totalMeasurementTimeoutInMilliseconds 字段用于配置在将所有测量视为已完成并生成此状态更改之前的最坏情况最大超时。

标题： Party.h