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

# PartyManager::GetRegions

> 获取一个数组，其中包含为你的标题配置的区域集以及往返延迟信息。

获取一个数组，其中包含为你的标题配置的区域集以及往返延迟信息。

## Syntax

```cpp theme={null}
PartyError GetRegions(  
    uint32_t* regionCount,  
    const PartyRegion** regions  
)  
```

### Parameters

**`regionCount`**   uint32\_t\*\
*output*

在 `regions` 中提供的区域的输出数量。

**`regions`**   [PartyRegion\*\*](/services/playfab/multiplayer/networking/reference/structs/partyregion)\
*library-allocated output array of size `*regionCount`*

库分配的输出数组，包含区域集。

### Return value

PartyError

如果调用成功，则返回 `c_partyErrorSuccess`；否则返回错误代码。可通过 [GetErrorMessage()](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_geterrormessage) 检索错误代码的可读形式。

## Remarks

在提供第一个 [PartyRegionsChangedStateChange](/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange) 之前，此方法提供的数组不会被填充。每个后续的 PartyRegionsChangedStateChange 都指示对该区域集的更新。填充此集合的后台操作在调用 [Initialize()](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_initialize) 时开始，除非使用 [PartyOption::RegionUpdateConfiguration](/services/playfab/multiplayer/networking/reference/enums/partyoption) 选项配置了 [PartyRegionUpdateMode::Deferred](/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode) 的更新模式。延迟模式意味着直到应用程序使用零条目区域数组调用 [CreateNewNetwork()](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createnewnetwork)，或者未连接到任何网络并使用包括 [PartyVoiceChatTranscriptionOptions::TranscribeSelfRegardlessOfNetworkState](/services/playfab/multiplayer/networking/reference/enums/partyvoicechattranscriptionoptions) 的选项标志调用 [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) 之前，才会开始区域检索和连接质量测量。也可以使用 [PartyOption::RegionUpdateConfiguration](/services/playfab/multiplayer/networking/reference/enums/partyoption) 选项配置刷新区域数组的时间间隔。<br /><br /> 返回的数组按延迟递增的顺序排序。区域的延迟定义为向该区域的 PlayFab 服务质量信标发送 UDP 数据报并接收响应所需的端到端时间。库会为每个区域多次测量延迟，以便计算高保真度结果。应用程序可以使用 [PartyOption::RegionQualityMeasurementConfiguration](/services/playfab/multiplayer/networking/reference/enums/partyoption) 选项更改此连接质量测量过程的低级方面。   <br /><br /> 等效于 UINT32\_MAX 的延迟表示该区域受支持，但由于库内部故障或未收到信标响应而达到超时，无法确定延迟信息。这可用于诊断目的（对每个区域的 UINT32\_MAX 延迟可能表明存在本地配置问题）或在区域选择期间过滤掉不太可能可行的区域。   <br /><br /> [PartyRegion](/services/playfab/multiplayer/networking/reference/structs/partyregion) 结构中返回的名称未本地化为当前用户的语言，除非用于故障排除，否则不建议直接在 UI 中显示这些字符串。   <br /><br /> 不要假定返回的区域集在标题的整个生命周期内保持不变。PlayFab Party 库将随着时间推移自动利用可用区域的添加和更改，以不断改进最终用户的体验。

## Requirements

**Header:** Party.h

## See also

[PartyManager](/services/playfab/multiplayer/networking/reference/classes/PartyManager/partymanager)\
[PartyRegionsChangedStateChange](/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange)\
[PartyManager::CreateNewNetwork](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createnewnetwork)


## Related topics

- [PartyRegionsChangedStateChange](/zh-CN/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange.md)
- [PlayFab Party QoS 测量](/zh-CN/services/playfab/multiplayer/networking/concepts-regions.md)
- [PlayFab Party 发行说明](/zh-CN/services/playfab/multiplayer/networking/release-notes.md)
- [PartyManager::GetOption](/zh-CN/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getoption.md)
- [PartyManager::GetSingleton](/zh-CN/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getsingleton.md)