次の方法で共有

PartyManager::GetRegions

  • [アーティクル]

タイトルが構成されているリージョンのセットと、ラウンド トリップ待機時間情報を含む配列を取得します。

構文

PartyError GetRegions(  
    uint32_t* regionCount,  
    const PartyRegion** regions  
)

パラメーター

regionCount uint32_t*
出力

regions で提供されるリージョンの出力数。

regions PartyRegion**
ライブラリに割り当てられたサイズの出力配列*regionCount

リージョンのセットを含む、ライブラリーに割り当てられた出力配列。

戻り値

PartyError

呼び出しが成功した場合は c_partyErrorSuccess、それ以外の場合はエラー コードになります。 人間が判読できる形式のエラー コードは、GetErrorMessage() を介して取得できます。

解説

このメソッドによって提供される配列は、最初の PartyRegionsChangedStateChange が提供されるまで設定されません。 後続の各 PartyRegionsChangedStateChange は、このリージョンのセットの更新を示します。 PartyOption::RegionUpdateConfiguration オプションを使用して PartyRegionUpdateMode::Deferred の更新モードを構成していない限り、initialize() が呼び出されると、このセットを設定するバックグラウンド操作が開始されます。 遅延モードは、アプリケーションがエントリ領域配列が 0 の CreateNewNetwork() を呼び出すまで、リージョンの取得と接続品質の測定が開始されないことを意味します。またはどのネットワークにも接続されておらず、PartyVoiceChatTranscriptionOptions::TranscribeSelfRegardlessOfNetworkState を含むオプション フラグで PartyLocalChatControl::PopulateAvailableTextToSpeechProfiles()、PartyLocalChatControl::SetTextToSpeechProfile()、または PartyLocalChatControl::SetTranscriptionOptions() を呼び出します。 PartyOption::RegionUpdateConfiguration オプションを使用して、リージョン配列を更新する間隔を構成することもできます。

返される配列は、待機時間の増加順に並べ替えられます。 リージョンの待機時間は、UDP データグラムをそのリージョンの PlayFab サービス品質ビーコンに送信して応答を受信するのにかかるエンドツーエンドの時間として定義されます。 ライブラリは、忠実度の高い結果を計算するために、各リージョンの待機時間を数回測定します。 アプリケーションは、 PartyOption::RegionQualityMeasurementConfiguration オプションを使用して、この接続品質測定手順の低レベルの側面を変更できます。

UINT32_MAX と同等の待機時間は、リージョンがサポートされているが、ライブラリー内部の障害のため、またはビーコンからの応答を受信せずに ping タイムアウトに達したため、待機時間情報を判別できなかったことを示します。 これは、診断目的 (すべてのリージョンへの UINT32_MAX 待機時間は、ローカル構成の問題を示している可能性があります) に使用するか、リージョン選択中に実行できる可能性が低いリージョンをフィルターで除外するために使用できます。

PartyRegion 構造体で返される名前は、現在のユーザーの言語にローカライズされていないため、トラブルシューティング以外では、UI に文字列を直接表示することはお勧めしません。

返されるリージョンのセットが、タイトルの存続期間中同じままであると想定しないでください。 PlayFab Party ライブラリは、利用可能なリージョンへの追加と変更を時間の経過とともに自動的に利用して、エンド ユーザーのエクスペリエンスを継続的に改善します。

要件

ヘッダー: Party.h

関連項目

PartyManager
PartyRegionsChangedStateChange
PartyManager::CreateNewNetwork