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