> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PartyRegionUpdateMode

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

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

## 構文

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

## 定数

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

## 要件

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

## 関連項目

[Party メンバー](/services/playfab/multiplayer/networking/reference/party_members)\
[PartyOption::RegionUpdateConfiguration](/services/playfab/multiplayer/networking/reference/enums/partyoption)\
[PartyRegionUpdateConfiguration](/services/playfab/multiplayer/networking/reference/structs/partyregionupdateconfiguration)\
[PartyRegionsChangedStateChange](/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange)\
[PartyCreateNewNetworkCompletedStateChange](/services/playfab/multiplayer/networking/reference/structs/partycreatenewnetworkcompletedstatechange)\
[PartyPopulateAvailableTextToSpeechProfilesCompletedStateChange](/services/playfab/multiplayer/networking/reference/structs/partypopulateavailabletexttospeechprofilescompletedstatechange)\
[PartySetTextToSpeechProfileCompletedStateChange](/services/playfab/multiplayer/networking/reference/structs/partysettexttospeechprofilecompletedstatechange)\
[PartySetTranscriptionOptionsCompletedStateChange](/services/playfab/multiplayer/networking/reference/structs/partysettranscriptionoptionscompletedstatechange)\
[PartyManager::Initialize](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_initialize)\
[PartyManager::CreateNewNetwork](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createnewnetwork)\
[PartyLocalChatControl::PopulateAvailableTextToSpeechProfiles](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_populateavailabletexttospeechprofiles)\
[PartyLocalChatControl::SetTextToSpeechProfile](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settexttospeechprofile)\
[PartyLocalChatControl::SetTranscriptionOptions](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settranscriptionoptions)


## Related topics

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