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

# PartyRegionUpdateMode

> 構造体の一部として Party ライブラリが自動リージョン検出と接続品質測定をどのように実行するかを表す構成モード。

[PartyRegionUpdateConfiguration](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/structs/partyregionupdateconfiguration.md) 構造体の一部として Party ライブラリが自動リージョン検出と接続品質測定をどのように実行するかを表す構成モード。

## 構文

```cpp theme={null}
enum class PartyRegionUpdateMode    
{  
    Immediate = 0,  
    Deferred = 1,  
}  
```

## 定数

| 定数 | 説明 |
| - | - |
| Immediate | 利用可能なリージョンのリストの取得と、それらへの接続品質の測定を可能な限り早く自動的に開始します。  Party ライブラリは、PartyManager::Initialize() が最初に呼び出されたときに、利用可能なリージョンを自動的に検出し、それらへの接続品質を測定します。  Party ライブラリはまた、PartyManager::Cleanup() が呼び出されるまで、リストと品質測定を定期的に更新します。既存の Party ネットワークに接続している場合、または接続処理中の場合、更新はすべての Party ネットワークから切断されるまで遅延されます。定期的な更新間隔は、包含する [PartyRegionUpdateConfiguration](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/structs/partyregionupdateconfiguration.md) 構造体の *refreshIntervalInSeconds* フィールドを使用して構成できます。     測定操作が完了するたびに、利用可能なリージョンを示す [PartyRegionsChangedStateChange](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange.md) または失敗を示す [PartyStateChangeResult](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/enums/partystatechangeresult.md) がアプリケーションに自動的に提供されます。     このモードは、[PartyOption::RegionUpdateConfiguration](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/enums/partyoption.md) が構成されていない場合の既定値です。 |
| Deferred | 新しい Party ネットワークを作成するか、特定のテキスト読み上げまたは音声テキスト変換機能を使用するまで、利用可能なリージョンのリストの取得と、それらへの接続品質の測定を遅延します。  アプリケーションがリージョン リスト配列にゼロ エントリを指定して [PartyManager::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) を呼び出さない限り、Party ライブラリは自動的に利用可能なリージョンを検出したり、それらへの接続品質を測定したりしません。遅延リージョン検出および品質測定が開始されると、利用可能なリージョンを示す [PartyRegionsChangedStateChange](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange.md) または失敗を示す [PartyStateChangeResult](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/enums/partystatechangeresult.md) が、トリガーとなる操作の [PartyCreateNewNetworkCompletedStateChange](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/structs/partycreatenewnetworkcompletedstatechange.md)、[PartyPopulateAvailableTextToSpeechProfilesCompletedStateChange](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/structs/partypopulateavailabletexttospeechprofilescompletedstatechange.md)、[PartySetTextToSpeechProfileCompletedStateChange](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/structs/partysettexttospeechprofilecompletedstatechange.md)、または [PartySetTranscriptionOptionsCompletedStateChange](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/structs/partysettranscriptionoptionscompletedstatechange.md) 完了状態変更の前に提供されます。  記載のパラメーターで上記の関数を後続して呼び出す場合、最後の測定が正常に実行されてから更新間隔が経過していれば、リージョン リストが再取得されて測定されます。既存の Party ネットワークに接続している場合、または接続処理中の場合、更新はすべての Party ネットワークから切断されるまで遅延されます。更新間隔は、包含する [PartyRegionUpdateConfiguration](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/structs/partyregionupdateconfiguration.md) 構造体の *refreshIntervalInSeconds* フィールドを使用して構成できます。     チャット コントロールは、テキスト読み上げ合成、音声認識、および翻訳のサービス使用を最適化するために、内部的にローカル デバイスのリージョン レイテンシー推定値を使用します。PartyRegionUpdateMode::Deferred を使用すると、これらの機能でレイテンシーが高くなる場合があります。 |

## 要件

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

## 関連項目

[Party メンバー](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)\
[PartyRegionUpdateConfiguration](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/structs/partyregionupdateconfiguration.md)\
[PartyRegionsChangedStateChange](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange.md)\
[PartyCreateNewNetworkCompletedStateChange](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/structs/partycreatenewnetworkcompletedstatechange.md)\
[PartyPopulateAvailableTextToSpeechProfilesCompletedStateChange](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/structs/partypopulateavailabletexttospeechprofilescompletedstatechange.md)\
[PartySetTextToSpeechProfileCompletedStateChange](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/structs/partysettexttospeechprofilecompletedstatechange.md)\
[PartySetTranscriptionOptionsCompletedStateChange](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/structs/partysettranscriptionoptionscompletedstatechange.md)\
[PartyManager::Initialize](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_initialize.md)\
[PartyManager::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)\
[PartyLocalChatControl::SetTranscriptionOptions](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settranscriptionoptions.md)


## Related topics

- [PartyRegionUpdateConfiguration](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/structs/partyregionupdateconfiguration.md)
- [PartyRegionsChangedStateChange](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange.md)
- [PartyLocalChatControl::PopulateAvailableTextToSpeechProfiles](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_populateavailabletexttospeechprofiles.md)
- [PartyManager::GetRegions](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getregions.md)
- [PartyLocalChatControl::SetTranscriptionOptions](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settranscriptionoptions.md)