この アチーブメント サンプル では、EOS SDK での Epic Online Services アチーブメント に関連する以下の操作を紹介します。
- Epic Online Services アチーブメント サンプルの定義をクエリする
- プレイヤーの Epic Online Services アチーブメントの進捗状況をクエリする
- 統計情報を取り込み、Epic Online Services アチーブメントの進捗状況を更新する
- Epic Online Services アチーブメントのロックを手動で解除する
このサンプルでは、このような操作をコントロールしたり、ユーザーにデータを直接表示したりできるユーザー インターフェースを提供して、これらの機能について紹介します。
アチーブメントと統計情報の詳細については、「Achievements インターフェース」と「Stats インターフェース」のドキュメントを参照してください。
始める前に
サンプル アプリケーションは実演目的のため Epic Account Services を使用してローカル ユーザーの認証を行います。SDK の初期化に使用したクライアント資格情報が Epic Account Services に使用する アプリケーション に割り当てられていることが要求されます。
デモで示されている SDK の機能は、サポートされている ID プロバイダのいずれでもユーザー認証に使用できます。
Epic Online Services アチーブメント サンプルの定義をクエリする
起動すると、このサンプルでは、デベロッパー ポータル を使用して作成された Epic Online Services アチーブメント定義 を取得してリストに表示します。定義名は、次のように、ヘッダの [Definitions (定義)] の下の左側の列に表示されます。
ユーザーがログインしている場合、Epic Online Services アチーブメント定義で返されるローカライズされたテキストはユーザーのロケールと一致します。ユーザーがロケールのオーバーライドを設定している場合、このテキストはユーザーのロケールではなくそのロケールのオーバーライドと一致します。ユーザーがログインしていない場合は、デフォルトのテキストを取得します。
Epic Online Services アチーブメントを選択する
Epic Online Services アチーブメントの定義を選択するには、左クリックしてそのアチーブメント定義を選択します。[Selected Definition Info (選択された定義の情報)] セクションには、次のように、その Epic Online Services アチーブメントに関する詳細情報が表示されます。
プレイヤーのアチーブメント データ
ユーザーがログインすると、ウィンドウの上部にある [Unlock (ロックを解除)] ボタンと [Update (更新)] ボタンが有効になります。
これらのボタンの機能は次のとおりです。
| ボタン名 | 説明 |
|---|---|
| Unlock (ロックを解除) | 進捗状況 を 1.0 に設定することで、選択された Epic Online Services アチーブメントのロックを解除します。 |
| Update (更新) | プレイヤーのアチーブメント データの取得を要求し、プレイヤーの現在の進捗状況とステータスに関する最新情報を提供します。 |
通知
Epic Online Services アチーブメントのロックが解除されると、以下のように、右上に通知が表示されます。
統計情報
統計情報 はデベロッパー ポータルで作成して、Epic Online Services アチーブメントに関連付けることができます。そのため、統計情報はアチーブメントの進捗状況を自動的に更新できます。統計情報を 取り込む には、統計情報の 名前 とその統計情報を取り込む 量 を設定して、次に示す [Ingest Stat (統計情報を取り込む)] ボタンをクリックします。
統計情報を取り込んだら、[Update (更新)] ボタンをクリックして、現在のプレイヤーの統計情報をクエリする必要があります。この操作により、その統計情報に関連付けられている Epic Online Services アチーブメントの 進捗状況 の変更を確認できます。
コンソール コマンド
このサンプルでは、一般的なコンソール コマンドに加えて、インゲームで入力できる次の追加のコンソール コマンドをサポートしています。
| コンソール コマンド | 使用方法 | 説明 |
|---|---|---|
| GETDEFS | GETDEFS | 該当アプリケーションの Epic Online Services アチーブメント定義の取得を要求します。ユーザーがログインしている場合、ローカライズされたテキストは、指定されたロケールまたはロケールのオーバーライドに一致します。 |
| GETPLAYER | GETPLAYER | 現在のユーザーの Epic Online Services アチーブメント データの取得を要求します。 |
| UNLOCK | UNLOCK <ACHIEVEMENT_NAME> | <ACHIEVEMENT_NAME> に指定された名前の Epic Online Services アチーブメントのロックを解除します。 |
| INGEST | INGEST <STAT_NAME> <INGEST_AMOUNT> | <STAT_NAME> で指定された名前の統計情報を <INGEST_AMOUNT> の取り込み値を使用して取り込みます。 |
| QUERYSTATS | QUERYSTATS | 現在のプレイヤーの統計をクエリします。 |