> ## 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* タイプの状態変更に固有の情報です。

## Syntax

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

### Members

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

サポートされているリージョンのリストと各リージョンへのレイテンシを照会するバックグラウンド操作が成功したかどうかを示します。または失敗の理由を提供します。

結果が [PartyStateChangeResult::Succeeded](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/enums/partystatechangeresult.md) の場合、[PartyManager::GetRegions()](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getregions.md) が提供するリージョン リストには操作の結果が入力されます。失敗した場合、PartyManager::GetRegions() が提供するリージョン リストは空です。 \
\
 結果が [PartyStateChangeResult::FailedToBindToLocalUdpSocket](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/enums/partystatechangeresult.md) の場合、ライブラリは [PartyOption::LocalUdpSocketBindAddress](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/enums/partyoption.md) オプションで指定されたローカル UDP ソケットにバインドできませんでした。タイトルはライブラリのインスタンスをクリーンアップし、[PartyOption::LocalUdpSocketBindAddress](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/enums/partyoption.md) オプションを有効で利用可能なバインド アドレスに更新し、ライブラリを再初期化する必要があります。

**`errorDetail`**   PartyError

潜在的なエラー状態に関する追加のトラブルシューティング情報を提供する診断値です。

このエラーの詳細を人間が読める形式で取得するには、[PartyManager::GetErrorMessage()](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_geterrormessage.md) を使用します。

## Remarks

利用可能なリージョンのリストを取得し、それらへの接続品質を測定する処理は、バックグラウンドで自動的に行われます。この操作は、[PartyOption::RegionUpdateConfiguration](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/enums/partyoption.md) オプションを使用して更新モードが [PartyRegionUpdateMode::Deferred](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode.md) に設定されていない限り、[PartyManager::Initialize()](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_initialize.md) が呼び出されたときに最初に開始されます。設定されている場合、リージョン更新はまったく発生しない可能性があります。遅延リージョン更新は、アプリケーションが 0 エントリのリージョン配列で [PartyManager::CreateNewNetwork()](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createnewnetwork.md) を呼び出す場合、または既存のネットワークに接続していないが [PartyVoiceChatTranscriptionOptions::TranscribeSelfRegardlessOfNetworkState](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/enums/partyvoicechattranscriptionoptions.md) を含むオプション フラグを指定して [PartyLocalChatControl::PopulateAvailableTextToSpeechProfiles()](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_populateavailabletexttospeechprofiles.md)、[PartyLocalChatControl::SetTextToSpeechProfile()](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settexttospeechprofile.md)、または [PartyLocalChatControl::SetTranscriptionOptions()](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settranscriptionoptions.md) を呼び出す場合にのみ発生します。[PartyOption::RegionUpdateConfiguration](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/enums/partyoption.md) オプションは、リージョンが更新される間隔を構成するためにも使用できます。 \
\
 利用可能なリージョンのリストを取得し、それらへの接続品質を測定するのにかかる時間は、多くの環境的または動的な要因、および [PartyOption::RegionQualityMeasurementConfiguration](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/enums/partyoption.md) オプションを使用して低レベル測定設定を変更したかどうかに依存します。[PartyRegionQualityMeasurementConfiguration](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/structs/partyregionqualitymeasurementconfiguration.md) 構造体の *totalMeasurementTimeoutInMilliseconds* フィールドは、すべての測定が完了したとみなしてこの状態変更を生成するまでの最悪ケースの最大タイムアウトを構成するために使用されます。

## Requirements

**Header:** Party.h

## See also

[Party members](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/party_members.md)\
[PartyManager::GetRegions](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getregions.md)


## Related topics

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