PartyRegionUpdateMode

[アーティクル]
02/09/2024

パーティーライブラリが PartyRegionUpdateConfiguration 構造体の一部として自動リージョン検出と接続品質測定を実行する方法を表す構成モード。

構文

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

定数

定数	説明
Immediate	利用可能なリージョンの一覧の取得と、それらに対する接続品質の測定をできるだけ早く自動的に開始します。パーティーライブラリは、PartyManager::Initialize() が最初に呼び出されたときに、使用可能なリージョンを自動的に検出し、接続品質を測定します。パーティーライブラリでは、PartyManager::Cleanup() が呼び出されるまで、リストと品質の測定値も定期的に更新されます。既に接続されている場合、または既存のパーティーネットワークに接続している場合、更新はすべてのパーティーネットワークから切断されるまで遅延されます。定期的な更新間隔は、PartyRegionUpdateConfiguration 構造体を含む refreshIntervalInSeconds フィールドを使用して構成できます。測定操作が完了するたびに、使用可能なリージョンまたは PartyStateChangeResult エラーを示す PartyRegionsChangedStateChange がアプリケーションに自動的に提供されます。このモードは、 PartyOption::RegionUpdateConfiguration が構成されていない場合の既定値です。
延期	新しいパーティーネットワークを作成するか、特定のテキスト音声変換または音声テキスト変換換機能を使用するまで、使用可能なリージョンの一覧の取得と接続品質の測定を遅らせる。アプリケーションがエントリが 0 のリージョンリスト配列を持つ partyManager::CreateNewNetwork() を呼び出し、または既存のネットワークに接続されていない PartyVoiceChatTranscriptionOptions::TranscribeSelfRegardlessOfNetworkState を含むオプションフラグで PartyLocalChatControl::PopulateAvailableTextToSpeechProfiles()、PartyLocalChatControl::SetTextToSpeechProfile()、または PartyLocalChatControl::SetTranscriptionOptions() 呼び出すまで、パーティーライブラリは、使用可能なリージョンを自動的に検出し、それらに対する接続品質を測定することはありません。遅延リージョンの検出と品質の測定が開始されると、PartyRegionsChangedStateChange が、トリガー操作の PartyCreateNewNetworkCompletedStateChange、PartyPopulateAvailableTextToSpeechProfilesCompletedStateChange、PartySetTextToSpeechProfileCompletedStateChange、または PartySetTranscriptionOptionsCompleteChange の前に、利用可能なリージョンまたは失敗を示すPartyStateChangeResult が提供されます。説明したパラメーターを使用した上記の関数への後続の呼び出しでは、最後の測定が正常に実行されてから更新間隔が経過すると、リージョンリストが取得され、再度測定されます。既に接続されている場合、または既存のパーティーネットワークに接続している場合、更新はすべてのパーティーネットワークから切断されるまで遅延されます。更新は、PartyRegionUpdateConfiguration 構造体を含む refreshIntervalInSeconds フィールドを使用して構成できます。チャットコントロールでは、ローカルデバイス領域の待機時間の見積もりを内部的に使用して、テキスト音声変換合成、音声テキスト変換、翻訳のサービス使用量を最適化します。 PartyRegionUpdateMode::Deferred を使用すると、これらの機能の待機時間が長くなる可能性があります。

説明

Immediate

利用可能なリージョンの一覧の取得と、それらに対する接続品質の測定をできるだけ早く自動的に開始します。

パーティーライブラリは、PartyManager::Initialize() が最初に呼び出されたときに、使用可能なリージョンを自動的に検出し、接続品質を測定します。

パーティーライブラリでは、PartyManager::Cleanup() が呼び出されるまで、リストと品質の測定値も定期的に更新されます。既に接続されている場合、または既存のパーティーネットワークに接続している場合、更新はすべてのパーティーネットワークから切断されるまで遅延されます。定期的な更新間隔は、PartyRegionUpdateConfiguration 構造体を含む refreshIntervalInSeconds フィールドを使用して構成できます。

測定操作が完了するたびに、使用可能なリージョンまたは PartyStateChangeResult エラーを示す PartyRegionsChangedStateChange がアプリケーションに自動的に提供されます。

このモードは、 PartyOption::RegionUpdateConfiguration が構成されていない場合の既定値です。

延期

新しいパーティーネットワークを作成するか、特定のテキスト音声変換または音声テキスト変換換機能を使用するまで、使用可能なリージョンの一覧の取得と接続品質の測定を遅らせる。

アプリケーションがエントリが 0 のリージョンリスト配列を持つ partyManager::CreateNewNetwork() を呼び出し、または既存のネットワークに接続されていない PartyVoiceChatTranscriptionOptions::TranscribeSelfRegardlessOfNetworkState を含むオプションフラグで PartyLocalChatControl::PopulateAvailableTextToSpeechProfiles()、PartyLocalChatControl::SetTextToSpeechProfile()、または PartyLocalChatControl::SetTranscriptionOptions() 呼び出すまで、パーティーライブラリは、使用可能なリージョンを自動的に検出し、それらに対する接続品質を測定することはありません。遅延リージョンの検出と品質の測定が開始されると、PartyRegionsChangedStateChange が、トリガー操作の PartyCreateNewNetworkCompletedStateChange、PartyPopulateAvailableTextToSpeechProfilesCompletedStateChange、PartySetTextToSpeechProfileCompletedStateChange、または PartySetTranscriptionOptionsCompleteChange の前に、利用可能なリージョンまたは失敗を示すPartyStateChangeResult が提供されます。

説明したパラメーターを使用した上記の関数への後続の呼び出しでは、最後の測定が正常に実行されてから更新間隔が経過すると、リージョンリストが取得され、再度測定されます。既に接続されている場合、または既存のパーティーネットワークに接続している場合、更新はすべてのパーティーネットワークから切断されるまで遅延されます。更新は、PartyRegionUpdateConfiguration 構造体を含む refreshIntervalInSeconds フィールドを使用して構成できます。

チャットコントロールでは、ローカルデバイス領域の待機時間の見積もりを内部的に使用して、テキスト音声変換合成、音声テキスト変換、翻訳のサービス使用量を最適化します。 PartyRegionUpdateMode::Deferred を使用すると、これらの機能の待機時間が長くなる可能性があります。

要件

ヘッダー: Party.h

次の方法で共有

PartyRegionUpdateMode

構文

定数

要件

関連項目

フィードバック

その他のリソース