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

# PartyManager::GetRegions

> タイトルが構成されているリージョンのセットと、ラウンドトリップ待機時間情報を含む配列を取得します。

タイトルが構成されているリージョンのセットと、ラウンドトリップ待機時間情報を含む配列を取得します。

## 構文

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

### パラメーター

**`regionCount`**   uint32\_t\*\
*出力*

`regions` に提供されるリージョンの出力数。

**`regions`**   [PartyRegion\*\*](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/structs/partyregion.md)\
*ライブラリによって割り当てられる、サイズ `*regionCount` の出力配列*

リージョンのセットを含む、ライブラリによって割り当てられる出力配列。

### 戻り値

PartyError

呼び出しが成功した場合は `c_partyErrorSuccess`、それ以外の場合はエラー コード。エラー コードの人間が判読可能な形式は、[GetErrorMessage()](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_geterrormessage.md) から取得できます。

## 解説

このメソッドによって提供される配列は、最初の [PartyRegionsChangedStateChange](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange.md) が提供されるまで設定されません。後続の各 PartyRegionsChangedStateChange は、このリージョンのセットに対する更新を示します。このセットを設定するバックグラウンド操作は、[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) に構成されていない限り、[Initialize()](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_initialize.md) が呼び出されたときに開始されます。遅延モードでは、アプリケーションがエントリ 0 のリージョン配列を使用して [CreateNewNetwork()](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createnewnetwork.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)、または [PartyVoiceChatTranscriptionOptions::TranscribeSelfRegardlessOfNetworkState](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/enums/partyvoicechattranscriptionoptions.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) オプションを使用して、リージョン配列を更新する間隔を構成することもできます。\
\
 返される配列は、待機時間が増加する順序でソートされます。リージョンの待機時間は、リージョンの PlayFab Quality of Service ビーコンに UDP データグラムを送信して応答を受信するのにかかるエンドツーエンドの時間として定義されます。ライブラリは、忠実度の高い結果を計算するために、各リージョンの待機時間を数回測定します。アプリケーションは、[PartyOption::RegionQualityMeasurementConfiguration](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/enums/partyoption.md) オプションを使用して、この接続品質測定手順の低レベルの側面を変更できます。   \
\
 UINT32\_MAX に相当する待機時間は、リージョンはサポートされているが、ライブラリの内部で発生した障害のため、またはビーコンからの応答を受信することなくタイムアウトに達したために、待機時間情報を特定できなかったことを示します。これは、診断目的で使用することができ (すべてのリージョンに対する UINT32\_MAX の待機時間は、ローカルの構成の問題を示す可能性が高いです)、またはリージョン選択中に実行できる可能性が低いリージョンを除外するために使用できます。   \
\
 [PartyRegion](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/structs/partyregion.md) 構造体で返される名前は、現在のユーザーの言語にローカライズされておらず、UI で文字列を直接表示することは、トラブルシューティング以外ではお勧めしません。   \
\
 返されるリージョンのセットが、タイトルの有効期間を通じて同じままであると想定しないでください。PlayFab Party ライブラリは、時間の経過に伴う利用可能なリージョンの追加と変更を自動的に活用し、エンド ユーザーのエクスペリエンスを継続的に改善します。

## 要件

**ヘッダー:** Party.h

## 関連項目

[PartyManager](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyManager/partymanager.md)\
[PartyRegionsChangedStateChange](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange.md)\
[PartyManager::CreateNewNetwork](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createnewnetwork.md)


## Related topics

- [PartyRegionsChangedStateChange](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange.md)
- [PlayFab Party の QoS 測定](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/concepts-regions.md)
- [PlayFab Party リリース ノート](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/release-notes.md)
- [PartyManager::GetOption](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getoption.md)
- [PartyManager::GetNetworks](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getnetworks.md)