Stats インターフェース

Online Services の Stats インターフェース では統計情報とデータをオンライン サービスにアップロードし、統計情報クエリを完了します。また、Stats インターフェースの機能は、Online Services のアチーブメントやリーダーボードのインターフェースなど、ユーザー ゲームプレイの統計情報に依存する他のインターフェースによっても使用されます。

API の概要

次の表は、Stats インターフェースに含まれる関数の概要です。

コンフィギュレーション

Stats インターフェースは、対応するプラットフォーム バックエンドまたは StatsNull の実装を介して使用できます。Stats インターフェースを使用するには、最初に「DefaultEngine.ini」ファイル内で Stats インターフェースを設定する必要があります。

DefaultEngine.ini

	[OnlineServices.Stats]
	StatDefinitions=(Name=Stat_Use_Largest, Id=0, ModifyMethod=Largest)
	StatDefinitions=(Name=Stat_Use_Smallest, Id=1, ModifyMethod=Smallest)
	StatDefinitions=(Name=Stat_Use_Set, Id=2, ModifyMethod=Set)
	StatDefinitions=(Name=Stat_Use_Sum, Id=3, ModifyMethod=Sum)

Copy full snippet

Stat Definitions には次のフィールドが含まれます。

• Name:統計情報の名前。
  • UpdateStats と QueryStats でそれぞれ統計情報の更新とクエリに使用される名前です。
• Id:統計情報の ID。
  • プラットフォーム ポータル内の対応する設定済み統計情報 ID です。
• ModifyMethod:統計情報の更新方法を示すメソッド。
  • StatsNull の実装でない場合、Modify Method はプラットフォーム ポータルで設定されます。
  • Modify Method は、定義済みのアンロック ルールをアチーブメントが満たしているかどうかの判断にタイトル管理のアチーブメントが使用される場合に、アチーブメント インターフェースによってすべての実装で使用されます。

アチーブメントをアンロックしてリーダーボードを統計情報で更新するには、「DefaultEngine.ini」ファイルのアチーブメントとリーダーボードの各コンフィグ セクションで、対応する統計情報を指定する必要があります。

例

このセクションには、次の操作に関するさまざまなコード サンプルが用意されています。

• 統計情報のクエリ
• キャッシュ済み統計情報の取得
• イベントのリッスン
• コンソール コマンドの実行

統計情報のクエリ

	UE::Online::IOnlineServicesPtr OnlineServices = UE::Online::GetServices();
	UE::Online::IStatsPtr Stats = OnlineServices->GetStatsInterface();

	UE::Online::FQueryStats::Params Params;
	Params.LocalAccountId = LocalAccountId;
	Params.TargetAccountId = TargetAccountId;
	Params.StatNames = {"StatA", "StatB"};

	// See Note below Walkthrough for more information about this OnComplete call
	Stats->QueryStats(MoveTemp(Params)).OnComplete([](const UE::Online::TOnlineResult<FQueryStats>& Result)
	{
	if (Result.IsError())
		{
			const UE::Online::FOnlineError OnlineError = Result.GetErrorValue();
			// OnlineError を処理する
			return;
		}
		const UE::Online::FQueryStats::Result QueriedStats = Result.GetOkValue();
		// Process QueriedStats
	});
Copy full snippet

ウォークスルー

1. デフォルトのオンライン サービスを使用します。これには、次のようにパラメータを指定することなく GetServices を呼び出します。

            UE::Online::IOnlineServicesPtr OnlineServices = UE::Online::GetServices();
   Copy full snippet

   UE::Online::IOnlineServicesPtr OnlineServices = UE::Online::GetServices();

2. デフォルトのオンライン サービスの Stats インターフェースにアクセスします。

            UE::Online::IStatsPtr Stats = OnlineServices->GetStatsInterface();
   Copy full snippet

   UE::Online::IStatsPtr Stats = OnlineServices->GetStatsInterface();

3. TargetAccountId の StatNames のクエリに必要なパラメータをインスタンス化します。

            UE::Online::FQueryStats::Params Params;
            Params.LocalAccountId = LocalAccountId;
            Params.TargetAccountId = TargetAccountId;
            Params.StatNames = {"StatA", "StatB"};
   		
   Copy full snippet

   UE::Online::FQueryStats::Params Params; Params.LocalAccountId = LocalAccountId; Params.TargetAccountId = TargetAccountId; Params.StatNames = {"StatA", "StatB"};

4. エラーまたはクエリされた統計情報を処理することで、QueryStats.OnComplete コールバックを処理します。

            Stats->QueryStats(MoveTemp(Params)).OnComplete([](const UE::Online::TOnlineResult<FQueryStats>& Result)
            {
                if (Result.IsError())
                {
                    const UE::Online::FOnlineError OnlineError = Result.GetErrorValue();
                    // OnlineError を処理する
                    return;
                }
                const UE::Online::FQueryStats::Result QueriedStats = Result.GetOkValue();
                // QueriedStats を処理する
            });
   Copy full snippet

   Stats->QueryStats(MoveTemp(Params)).OnComplete([](const UE::Online::TOnlineResult<FQueryStats>& Result) { if (Result.IsError()) { const UE::Online::FOnlineError OnlineError = Result.GetErrorValue(); // OnlineError を処理する return; } const UE::Online::FQueryStats::Result QueriedStats = Result.GetOkValue(); // QueriedStats を処理する });

	.OnComplete(this, &MyClass::OnQueryStatsComplete)

Copy full snippet

キャッシュ済み統計情報の取得

	UE::Online::IOnlineServicesPtr OnlineServices = UE::Online::GetServices();
	UE::Online::IStatsPtr Stats = OnlineServices->GetStatsInterface();

	UE::Online::TOnlineResult<FGetCachedStats> CachedStats = Stats->GetCachedStats({});
	if (CachedStats.IsError())
	{
		UE::Online::FOnlineError OnlineError = CachedStats.GetErrorValue();
		// OnlineError を処理する
		return;
	}

	UE::Online::FGetCachedStats::Result& CachedStatsData = CachedStats.GetOkValue();
	// CachedStatsData を処理する
Copy full snippet

ウォークスルー

1. デフォルトのオンライン サービスを使用します。これには、次のようにパラメータを指定することなく GetServices を呼び出して、Stats インターフェースにアクセスします。

            UE::Online::IOnlineServicesPtr OnlineServices = UE::Online::GetServices();
            UE::Online::IStatsPtr Stats = OnlineServices->GetStatsInterface();
   		
   Copy full snippet

   UE::Online::IOnlineServicesPtr OnlineServices = UE::Online::GetServices(); UE::Online::IStatsPtr Stats = OnlineServices->GetStatsInterface();

2. Stats->GetCachedStats を使用して、Stats インターフェースを介してキャッシュ済みの統計情報を取得します。

            UE::Online::TOnlineResult<UE::Online::FGetCachedStats> CachedStats = Stats->GetCachedStats({});
   		
   Copy full snippet

   UE::Online::TOnlineResult<UE::Online::FGetCachedStats> CachedStats = Stats->GetCachedStats({});

3. エラーまたはキャッシュ済みの統計情報データを処理することで、CachedStats を処理します。

            if (CachedStats.IsError())
            {
                UE::Online::FOnlineError OnlineError = CachedStats.GetErrorValue();
                // OnlineError を処理する
                return;
   		
            }
            UE::Online::FGetCachedStats::Result& CachedStatsData = CachedStats.GetOkValue();
            // CachedStatsData を処理する
   		
   Copy full snippet

   if (CachedStats.IsError()) { UE::Online::FOnlineError OnlineError = CachedStats.GetErrorValue(); // OnlineError を処理する return; } UE::Online::FGetCachedStats::Result& CachedStatsData = CachedStats.GetOkValue(); // CachedStatsData を処理する

イベントのリッスン

イベントのリスニングは、同期および非同期の関数とは異なる方法で処理されます。OnStatsUpdated イベントの結果を処理するための FOnlineEventDelegateHandle が作成された後に、適切な破壊を確実にするために、シャットダウン コードで Unbind を呼び出す必要があります。

ウォークスルー

1. クラス内で Stat インターフェースのためのイベント ハンドルを宣言します。

   UE::Online::FOnlineEventDelegateHandle StatEventHandle;

2. init コード内でデフォルトのオンライン サービスを初期化して Stats インターフェースにアクセスし、イベントの発生時に統計情報を処理します。

            UE::Online::IOnlineServicesPtr OnlineServices = UE::Online::GetServices();
            UE::Online::IStatsPtr Stats = OnlineServices->GetStatsInterface();
            StatEventHandle = Stats->OnStatsUpdated().Add([](const UE::Online::FStatsUpdated& StatsUpdated)
            {
                // このラムダ内のカスタムロジック
            });
   		
   Copy full snippet

   UE::Online::IOnlineServicesPtr OnlineServices = UE::Online::GetServices(); UE::Online::IStatsPtr Stats = OnlineServices->GetStatsInterface(); StatEventHandle = Stats->OnStatsUpdated().Add([](const UE::Online::FStatsUpdated& StatsUpdated) { // このラムダ内のカスタムロジック });

3. シャットダウン コード内でイベント ハンドラのバインドを解除します。

            StatEventHandle.Unbind();
   Copy full snippet

   StatEventHandle.Unbind();

コンソール コマンドの実行

コンソール コマンドで非同期インターフェースを実行するための全般的なコマンドラインの構文については、「Online Services の概要」ドキュメントを参照してください。

例

QueryStats 関数を実行するには、次のコンソール コマンドを実行します。

	OnlineServices Index=0 Stats QueryStats 0 0 ["StatA", "StatB"]

Copy full snippet

このコマンドは、ゼロ番目のローカル ユーザーを対象に、デフォルトのオンライン サービスで Stats インターフェースから QueryStats を呼び出します。上記のコマンドでは、デフォルトのオンライン サービスに対してこのユーザーの StatA と StatB をクエリしています。

統計情報データのリセット

開発とテスティングの際には、現在のタイトルに提供されたすべてのプレイヤー統計情報を ResetStats 関数を使ってリセットできます。ポリシーはそれぞれのオンライン サービスで異なりますが、この関数がテスティング環境外でも機能するとは想定しないでください。ResetStats を使用するコードはシッピング ビルドから削除するか、コンパイル時のロジックを使って次のようにコードをマスクしてください。

	#if !UE_BUILD_SHIPPING
	// Code block with call to ResetStats
	#endif

Copy full snippet

詳細情報

ヘッダ ファイル

必要に応じて「Stats.h」ヘッダ ファイルを直接参照してください。Stats インターフェースのヘッダ ファイル「Stats.h」は次の場所にあります。

	UNREAL_ENGINE_ROOT\Engine\Plugins\Online\OnlineServices\Source\OnlineServicesInterface\Public\Online

Copy full snippet

UE のソース コードの入手方法については、「Unreal Engine のソース コードをダウンロードする」のドキュメントを参照してください。

関数パラメータおよび戻り型

関数パラメータおよび戻り型 (パラメータの渡し方、関数が戻す結果の処理など) については、「Online Services の概要」ページの「関数」セクションを参照してください。