Achievements サンプル

Achievements サンプルのリファレンス ページです。

Achievements Sample Main

この Achievements サンプル では、EOS SDK での アチーブメント に関連する以下の操作を紹介します。

  • アチーブメントの定義をクエリする

  • プレイヤーのアチーブメントの進捗状況をクエリする

  • 統計情報を取り込み、アチーブメントの進捗状況を更新する

  • アチーブメントのロックを手動で解除する

このサンプルでは、このような操作をコントロールしたり、ユーザーにデータを直接表示したりできるユーザー インターフェースを提供して、これらの機能について紹介します。

アチーブメントと統計情報の詳細については、「Achievements インターフェース」と「Stats インターフェース」のドキュメントを参照してください。

始める前に

サンプル アプリケーションは実演目的のため Epic Account Services を使用してローカル ユーザーの認証を行います。SDK の初期化に使用したクライアント資格情報が Epic Account Services に使用する アプリケーション に割り当てられていることが要求されます。

実演対象の SDK 機能は、ユーザー認証用にサポートされたどの ID プロバイダーとも使用することができます。

アチーブメントの定義

起動すると、このサンプルでは、デベロッパー ポータル を使用して作成された アチーブメント定義 を取得してリストに表示します。定義名は、次のように、ヘッダの [Definitions (定義)] の下の左側の列に表示されます。

Achievement Definitions

ユーザーがログインしている場合、アチーブメント定義で返されるローカライズされたテキストはユーザーのロケールと一致します。ユーザーがロケールのオーバーライドを設定している場合、このテキストはユーザーのロケールではなくそのロケールのオーバーライドと一致します。ユーザーがログインしていない場合は、デフォルトのテキストを取得します。

アチーブメントを選択する

アチーブメント定義を選択するには、左クリックしてそのアチーブメント定義を選択します。[Selected Definition Info (選択された定義の情報)] セクションには、次のように、そのアチーブメントに関する詳細情報が表示されます。

Definition Info

プレイヤーのアチーブメント データ

ユーザーがログインすると、ウィンドウの上部にある [Unlock (ロックを解除)] ボタンと [Update (更新)] ボタンが有効になります。

Player Achievement Data

これらのボタンの機能は次のとおりです。

ボタン名

説明

Unlock (ロックを解除)

進捗状況1.0 に設定することで、選択されたアチーブメントのロックを解除します。

Update (更新)

プレイヤーのアチーブメント データの取得を要求し、プレイヤーの現在の進捗状況とステータスに関する最新情報を提供します。

通知

アチーブメントのロックが解除されると、以下のように、右上に通知が表示されます。

Achievement Notifications

統計情報

統計情報 はデベロッパー ポータルで作成して、アチーブメントに関連付けることができます。そのため、統計情報はアチーブメントの進捗状況を自動的に更新できます。統計情報を 取り込む には、統計情報の 名前 とその統計情報を取り込む を設定して、次に示す [Ingest Stat (統計情報を取り込む)] ボタンをクリックします。

Ingest Stats

統計情報を取り込んだら、[Update (更新)] ボタンをクリックして、現在のプレイヤーの統計情報をクエリする必要があります。この操作により、その統計情報に関連付けられているアチーブメントの 進捗状況 の変更を確認できます。

コンソール コマンド

このサンプルでは、一般的なコンソール コマンドに加えて、インゲームで入力できる次の追加のコンソール コマンドをサポートしています。

コンソール コマンド

使用方法

説明

GETDEFS

GETDEFS

該当アプリケーションのアチーブメント定義の取得を要求します。ユーザーがログインしている場合、ローカライズされたテキストは、指定されたロケールまたはロケールのオーバーライドに一致します。

GETPLAYER

GETPLAYER

現在のユーザーのアチーブメント データの取得を要求します。

UNLOCK

UNOCK <ACHIEVEMENT_NAME>

<ACHIEVEMENT_NAME> に指定された名前のアチーブメントのロックを解除します。

INGEST

INGEST <STAT_NAME> <INGEST_AMOUNT>

<STAT_NAME> で指定された名前の統計情報を <INGEST_AMOUNT> の取り込み値を使用して取り込みます。

QUERYSTATS

QUERYSTATS

現在のプレイヤーの統計をクエリします。