> ## 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-TW/services/playfab/multiplayer/networking/reference/enums/partystatechangeresult.md)

表示查詢支援區域清單及每個區域延遲的背景作業是否成功，或提供其失敗的原因。

當結果為 [PartyStateChangeResult::Succeeded](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/enums/partystatechangeresult.md) 時，[PartyManager::GetRegions()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getregions.md) 所提供的區域清單會填入作業的結果。失敗時，PartyManager::GetRegions() 所提供的區域清單會是空的。\
\
 如果結果為 [PartyStateChangeResult::FailedToBindToLocalUdpSocket](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/enums/partystatechangeresult.md)，表示程式庫無法繫結至 [PartyOption::LocalUdpSocketBindAddress](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/enums/partyoption.md) 選項中指定的本機 UDP 通訊端。遊戲必須清除其程式庫執行個體，將 [PartyOption::LocalUdpSocketBindAddress](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/enums/partyoption.md) 選項更新為有效且可用的繫結位址，然後重新初始化程式庫。

**`errorDetail`**   PartyError

診斷值，提供有關任何潛在錯誤狀況的更多疑難排解資訊。

可透過 [PartyManager::GetErrorMessage()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_geterrormessage.md) 擷取此錯誤詳細資料的人類可讀形式。

## 備註

擷取可用區域清單並測量與其連線品質的作業會在背景自動進行。此作業會在呼叫 [PartyManager::Initialize()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_initialize.md) 時首次起始，除非使用 [PartyOption::RegionUpdateConfiguration](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/enums/partyoption.md) 選項將更新模式設定為 [PartyRegionUpdateMode::Deferred](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode.md)，在此情況下可能完全不會進行區域更新。只有在應用程式以零項目的區域陣列呼叫 [PartyManager::CreateNewNetwork()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createnewnetwork.md)，或未連線至現有網路但以包含 [PartyVoiceChatTranscriptionOptions::TranscribeSelfRegardlessOfNetworkState](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/enums/partyvoicechattranscriptionoptions.md) 的選項旗標呼叫 [PartyLocalChatControl::PopulateAvailableTextToSpeechProfiles()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_populateavailabletexttospeechprofiles.md)、[PartyLocalChatControl::SetTextToSpeechProfile()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settexttospeechprofile.md) 或 [PartyLocalChatControl::SetTranscriptionOptions()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settranscriptionoptions.md) 時，才會進行延遲的區域更新。[PartyOption::RegionUpdateConfiguration](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/enums/partyoption.md) 選項也可用來設定重新整理區域的間隔。\
\
 擷取可用區域清單並測量與其連線品質所需的時間，取決於許多環境或動態因素，以及是否使用了 [PartyOption::RegionQualityMeasurementConfiguration](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/enums/partyoption.md) 選項來修改低階測量設定。[PartyRegionQualityMeasurementConfiguration](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/structs/partyregionqualitymeasurementconfiguration.md) 結構中的 *totalMeasurementTimeoutInMilliseconds* 欄位用來設定最壞情況下的最長逾時，超過此時間後就會將所有測量視為完成並產生此狀態變更。

## 需求

**標頭：** Party.h

## 另請參閱

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


## Related topics

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