> ## 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.

# PartyRegionsChangedStateChange

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

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

## 语法

```cpp theme={null}
struct PartyRegionsChangedStateChange : PartyStateChange {  
    PartyStateChangeResult result;  
    PartyError errorDetail;  
}  
```

### 成员

**`result`**   [PartyStateChangeResult](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/enums/partystatechangeresult.md)

指示查询受支持区域列表以及到每个区域延迟的后台操作是否成功,或提供其失败的原因。

当结果为 [PartyStateChangeResult::Succeeded](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/enums/partystatechangeresult.md) 时,[PartyManager::GetRegions()](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getregions.md) 提供的区域列表将填充为操作结果。失败时,PartyManager::GetRegions() 提供的区域列表为空。\
\
 如果结果为 [PartyStateChangeResult::FailedToBindToLocalUdpSocket](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/enums/partystatechangeresult.md),则库无法绑定到在 [PartyOption::LocalUdpSocketBindAddress](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/enums/partyoption.md) 选项中指定的本地 UDP 套接字。游戏必须清理其库实例,将 [PartyOption::LocalUdpSocketBindAddress](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/enums/partyoption.md) 选项更新为有效可用的绑定地址,然后重新初始化库。

**`errorDetail`**   PartyError

一个诊断值,提供有关任何潜在错误情况的更多故障排除信息。

此错误详情的可读形式可通过 [PartyManager::GetErrorMessage()](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_geterrormessage.md) 获取。

## 备注

检索可用区域列表并测量与其的连接质量会在后台自动进行。除非使用 [PartyOption::RegionUpdateConfiguration](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/enums/partyoption.md) 选项将更新模式配置为 [PartyRegionUpdateMode::Deferred](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode.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) 且选项标志包含 [PartyVoiceChatTranscriptionOptions::TranscribeSelfRegardlessOfNetworkState](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/enums/partyvoicechattranscriptionoptions.md) 时,才会发生延迟的区域更新。[PartyOption::RegionUpdateConfiguration](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/enums/partyoption.md) 选项还可用于配置刷新区域的时间间隔。\
\
 检索可用区域列表并测量与其的连接质量所花费的时间取决于诸多环境或动态因素,以及是否使用 [PartyOption::RegionQualityMeasurementConfiguration](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/enums/partyoption.md) 选项修改了底层测量设置。[PartyRegionQualityMeasurementConfiguration](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/structs/partyregionqualitymeasurementconfiguration.md) 结构中的 *totalMeasurementTimeoutInMilliseconds* 字段用于配置在认为所有测量完成并生成此状态更改之前的最坏情况最大超时。

## 要求

**头文件:** Party.h

## 另请参阅

[Party 成员](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/party_members.md)\
[PartyManager::GetRegions](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getregions.md)


## Related topics

- [PartyManager::GetRegions](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getregions.md)
- [PartyRegionUpdateConfiguration](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/structs/partyregionupdateconfiguration.md)
- [PartyRegionQualityMeasurementConfiguration](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/structs/partyregionqualitymeasurementconfiguration.md)
- [PartyRegionUpdateMode](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode.md)
- [PlayFab Party QoS 测量](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/concepts-regions.md)