構文
パラメーター
regionCount uint32_t*出力
regions に提供されるリージョンの出力数。
regions PartyRegion**ライブラリによって割り当てられる、サイズ
*regionCount の出力配列
リージョンのセットを含む、ライブラリによって割り当てられる出力配列。
戻り値
PartyError 呼び出しが成功した場合はc_partyErrorSuccess、それ以外の場合はエラー コード。エラー コードの人間が判読可能な形式は、GetErrorMessage() から取得できます。
解説
このメソッドによって提供される配列は、最初の PartyRegionsChangedStateChange が提供されるまで設定されません。後続の各 PartyRegionsChangedStateChange は、このリージョンのセットに対する更新を示します。このセットを設定するバックグラウンド操作は、PartyOption::RegionUpdateConfiguration オプションを使用して更新モードが PartyRegionUpdateMode::Deferred に構成されていない限り、Initialize() が呼び出されたときに開始されます。遅延モードでは、アプリケーションがエントリ 0 のリージョン配列を使用して CreateNewNetwork() を呼び出すまで、またはどのネットワークにも接続されておらず PartyLocalChatControl::PopulateAvailableTextToSpeechProfiles()、PartyLocalChatControl::SetTextToSpeechProfile()、または PartyVoiceChatTranscriptionOptions::TranscribeSelfRegardlessOfNetworkState を含むオプション フラグを持つ PartyLocalChatControl::SetTranscriptionOptions() を呼び出すまで、リージョンの取得と接続品質の測定が開始されないことを意味します。PartyOption::RegionUpdateConfiguration オプションを使用して、リージョン配列を更新する間隔を構成することもできます。返される配列は、待機時間が増加する順序でソートされます。リージョンの待機時間は、リージョンの PlayFab Quality of Service ビーコンに UDP データグラムを送信して応答を受信するのにかかるエンドツーエンドの時間として定義されます。ライブラリは、忠実度の高い結果を計算するために、各リージョンの待機時間を数回測定します。アプリケーションは、PartyOption::RegionQualityMeasurementConfiguration オプションを使用して、この接続品質測定手順の低レベルの側面を変更できます。
UINT32_MAX に相当する待機時間は、リージョンはサポートされているが、ライブラリの内部で発生した障害のため、またはビーコンからの応答を受信することなくタイムアウトに達したために、待機時間情報を特定できなかったことを示します。これは、診断目的で使用することができ (すべてのリージョンに対する UINT32_MAX の待機時間は、ローカルの構成の問題を示す可能性が高いです)、またはリージョン選択中に実行できる可能性が低いリージョンを除外するために使用できます。
PartyRegion 構造体で返される名前は、現在のユーザーの言語にローカライズされておらず、UI で文字列を直接表示することは、トラブルシューティング以外ではお勧めしません。
返されるリージョンのセットが、タイトルの有効期間を通じて同じままであると想定しないでください。PlayFab Party ライブラリは、時間の経過に伴う利用可能なリージョンの追加と変更を自動的に活用し、エンド ユーザーのエクスペリエンスを継続的に改善します。
要件
ヘッダー: Party.h関連項目
PartyManagerPartyRegionsChangedStateChange
PartyManager::CreateNewNetwork