PartyRegionUpdateMode - XBOX Game Development Documentation

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

構文

enum class PartyRegionUpdateMode    
{  
    Immediate = 0,  
    Deferred = 1,  
}  

定数

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

要件

ヘッダー: Party.h

関連項目

Party メンバー
PartyOption::RegionUpdateConfiguration
PartyRegionUpdateConfiguration
PartyRegionsChangedStateChange
PartyCreateNewNetworkCompletedStateChange
PartyPopulateAvailableTextToSpeechProfilesCompletedStateChange
PartySetTextToSpeechProfileCompletedStateChange
PartySetTranscriptionOptionsCompletedStateChange
PartyManager::Initialize
PartyManager::CreateNewNetwork
PartyLocalChatControl::PopulateAvailableTextToSpeechProfiles
PartyLocalChatControl::SetTextToSpeechProfile
PartyLocalChatControl::SetTranscriptionOptions

最終更新日 2026年8月13日

関連トピック

PartyRegionUpdateConfiguration PartyRegionsChangedStateChange PartyLocalChatControl::PopulateAvailableTextToSpeechProfiles PartyManager::GetRegions PartyLocalChatControl::SetTranscriptionOptions

⌘I