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

# PartyRegionUpdateConfiguration

> Party ライブラリが自動的なリージョン検出と接続品質測定の更新を実行する方法を制御するために使用する構成です。

Party ライブラリが自動的なリージョン検出と接続品質測定の更新を実行する方法を制御するために使用する構成です。

## Syntax

```cpp theme={null}
struct PartyRegionUpdateConfiguration {  
    PartyRegionUpdateMode mode;  
    uint32_t refreshIntervalInSeconds;  
}  
```

### Members

**`mode`**   [PartyRegionUpdateMode](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode.md)

リージョン検出と接続品質測定の更新をいつ実行するかを制御するモードです。

[PartyOption::RegionUpdateConfiguration](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/enums/partyoption.md) が構成されていない場合の既定値は [PartyRegionUpdateMode::Immediate](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode.md) です。

**`refreshIntervalInSeconds`**   uint32\_t

リージョン品質測定が完了した後、新しいリージョン検出と接続品質測定プロセスを開始できるようになるまでに経過することが許可される秒数です。

このリフレッシュ間隔は、[PartyRegionsChangedStateChange](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange.md) が提供されるたびに使用され、*mode* フィールドで定義された更新モードで次のリージョン品質測定を開始できるようになるタイミングを決定します。 \
\
 リフレッシュの対象になっても、そのタイミングで正確にリフレッシュが開始されるとは限りません。*mode* フィールドが [PartyRegionUpdateMode::Deferred](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode.md) に設定されている場合、リージョン更新をトリガーするための該当するメソッドのいずれかが呼び出されるまで、次のリフレッシュは発生しません。ライブラリは、ローカル デバイスが Party ネットワークに参加していない状態になるまで待機し、意図せず同期された複数のデバイスによる PlayFab サービスの負荷を回避するために、少量のランダム遅延を適用します。   \
\
 [PartyOption::RegionUpdateConfiguration](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/enums/partyoption.md) が構成されていない場合の既定値は 28800 (8 時間) です。   \
\
 ゼロの値を指定すると、Party ライブラリは今後測定を自動的にリフレッシュしません。それ以外の場合、許可される最小値は 30 秒です。

## Remarks

この構造体は [PartyOption::RegionUpdateConfiguration](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/enums/partyoption.md) と一緒に使用して、[PartyManager::SetOption()](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_setoption.md) または [PartyManager::GetOption()](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getoption.md) を介して、それぞれ Party ライブラリの現在の構成を上書きまたはクエリすることができます。これは、[PartyRegionsChangedStateChange](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange.md) 状態変更を生成するリージョン検出と接続品質測定プロセスの動作を構成します。

## Requirements

**Header:** Party.h

## See also

[Party members](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/party_members.md)\
[PartyOption::RegionUpdateConfiguration](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/enums/partyoption.md)\
[PartyRegionUpdateMode](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode.md)\
[PartyRegionsChangedStateChange](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange.md)\
[PartyManager::SetOption](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_setoption.md)\
[PartyManager::GetOption](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getoption.md)


## Related topics

- [PartyRegionUpdateMode](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode.md)
- [PartyOption](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/enums/partyoption.md)
- [Party C/C++ API の概要](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/party_members.md)
- [PartyRegionQualityMeasurementConfiguration](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/structs/partyregionqualitymeasurementconfiguration.md)
- [PartyRegionsChangedStateChange](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange.md)