PartyRegionsChangedStateChange
状態変更の RegionsChanged 型に固有の情報。
構文
struct PartyRegionsChangedStateChange : PartyStateChange {
PartyStateChangeResult result;
PartyError errorDetail;
}
メンバー
result
PartyStateChangeResult
サポートされているリージョンの一覧と各リージョンの待機時間を照会するバックグラウンド操作が成功したことを示すか、失敗した場合はその理由を示します。
結果が PartyStateChangeResult::Succeeded の場合、PartyManager::GetRegions() が提供されるリージョン リストに操作の結果が入力されます。 失敗した場合、PartyManager::GetRegions() が提供されるリージョン一覧は空になります。
結果が PartyStateChangeResult::FailedToBindToLocalUdpSocket である場合、PartyOption::LocalUdpSocketBindAddress オプションで指定されたローカル UDP ソケットにライブラリがバインドできませんでした。 タイトルは、ライブラリのインスタンスをクリーンアップし、PartyOption::LocalUdpSocketBindAddress オプションを有効で、アドレスをバインドでき、ライブラリを再初期化するよう更新します。
errorDetail PartyError
潜在的なエラー状態に関する追加のトラブルシューティング情報を提供する診断値。
人間が読める形式のエラー詳細情報は、PartyManager::GetErrorMessage() を介して取得できます。
解説
使用可能なリージョンの一覧を取得し、それらの接続品質を測定は、バックグラウンドで自動的に実行されます。 この操作は、PartyOption::RegionUpdateConfiguration オプションを使用して PartyRegionUpdateMode::D eferred の更新モードを構成しない限り、PartyManager::Initialize() が呼び出されたときに最初に開始されます。この場合、リージョンの更新はまったく行われません。 遅延リージョンの更新は、アプリケーションが PartyManager::CreateNewNetwork() をゼロ エントリ領域配列で呼び出した場合にのみ発生します。またはは既存のネットワークに接続されていませんが、PartyLocalChatControl::P opulateAvailableTextToSpeechProfiles()、PartyLocalChatControl::SetTextToSpeechProfile()、または PartyLocalChatControl::SetTranscriptionOptions() を PartyVoiceChatTranscriptionOptions::TranscribeSelfRegardlessOfNetworkState を含むオプション フラグを使用して呼び出します。
PartyOption::RegionUpdateConfiguration オプションを使用して、リージョンが更新される間隔を構成することもできます。
使用可能なリージョンの一覧を取得して接続品質を測定するのにかかる時間は、多くの環境または動的要因と、PartyOption::RegionQualityMeasurementConfiguration オプションを使用して低レベルの測定設定を変更したかどうかによって異なります。
PartyRegionQualityMeasurementConfiguration 構造体の totalMeasurementTimeoutInMilliseconds フィールドは、すべての測定値が完了し、この状態変更を生成する前に、最悪の場合の最大タイムアウトを構成するために使用されます。
要件
ヘッダー: Party.h