Epic Online Services achievements sample

关于Epic在线服务成就示例的参考页面

阅读时间3分钟

成就示例 展示了 EOS SDK 中与 EOS成就 相关的操作，其中包括：

本示例提供了进行这些操作的用户接口，并将数据直接对用户显示，从而展示出这些功能。

欲知成就和统计数据的更多内容，请参见成就接口及统计数据接口文档。

出于演示目的，示例应用使用 Epic账户服务 验证本地用户。这需要先将用于初始化SDK的客户端凭证指定给使用 Epic账户服务 的应用。

演示的SDK功能可以和任何支持的身份供应商配合使用，以用于用户验证。

本示例开始时，其将获取通过 开发者门户（Developer Portal） 创建的 成就定义，并将其显示在列表中。定义名将出现在左侧 定义（Definitions） 标题下的列中。如下图所示：

如用户已登录，EOS成就定义中返回的本地化文本将匹配用户的地区。如用户拥有地区重载设置，则将匹配此设置。如用户未登录，则其将获取默认文本。

左键点击某个EOS成就定义将其选中。已选定义信息（Selected Definition Info） 部分将显示关于该EOS成就的更多信息，如下图所示：

用户登录后，窗口顶部的 解锁（Unlock） 和 更新（Update） 按钮将被激活。

它们的功能如下：

按钮名称	描述
解锁	将选定的EOS成就的进度设为 1.0，将其解锁。
更新	请求获取玩家成就数据，提供玩家当前进度与状态的最新信息。

在解锁EOS成就时，将在右上角显示一条通知，如：

统计数据（Stats）可以在开发者门户中创建并与EOS成就关联，使其自动更新EOS成就进度。摄取统计数据的方法是设置统计数据的名称以及需要摄取的量，然后点击 摄取统计数据（Ingest Stat） 按钮。具体操作如下图所示：

摄取统计数据之后，需要点击 更新（Update） 按钮来查询当前玩家的统计数据。之后，与此统计数据关联的EOS成就的进度就会发生变化。

除常见控制台命令外，此示例还支持下列控制台命令，可在游戏中进行输入：

控制台命令	用法	描述
GETDEFS	`GETDEFS`	请求获取此应用程序的EOS成就定义。如用户已登录，本地化文本将匹配其特定地区或地区重载。
GETPLAYER	`GETPLAYER`	请求获取当前用户的EOS成就数据。
UNLOCK	`UNLOCK <ACHIEVEMENT_NAME>`	解锁名称为 `<ACHIEVEMENT_NAME>` 的EOS成就。
INGEST	`INGEST <STAT_NAME> <INGEST_AMOUNT>`	摄取名称为 `<STAT_NAME>` 的统计数据，摄取值为 `<INGEST_AMOUNT>`。
QUERYSTATS	`QUERYSTATS`	当前玩家的查询统计数据。