Setup Guide

阅读时间15分钟

如果你在Epic Games商城发布过产品，你可以通过Epic Games商城（Epic Games Store）成就来提升游戏产品的用户体验。Epic Games商城成就扩展了Epic在线服务成就的功能。你可以使用这些成就在Epic Games商城中向用户发放经验值（XP）和其他福利。详细了解Epic Games商城成就。

确保你的组织可以发布内容到Epic Games商城

只有在你的组织可以在Epic Games商城发布产品时，你才能将Epic Games商城成就添加到你的产品之中。如果你的组织还不能发布产品到Epic Games商城，请申请权限。

为你的产品完成使用Epic Games商城成就的准备

在将Epic Games商城成就添加到产品之前，你必须配置产品，以便使用Epic Games商城成就。按照屏幕上的三步流程进行操作：

  1. 签署更新的开发人员协议。
    • 你只需要为你的组织执行一次此操作。
  2. 生成Dev和Stage沙盒与部署。
  3. 在每个沙盒中选择一个供Epic Games商城成就使用的部署。

步骤1：签署更新的开发人员协议

你组织的所有者必须阅读并签署更新的开发人员协议。只有在组织所有者接受此协议之后，你才能使用Epic Games商城成就。只有组织所有者可以执行此程序。

阅读并签署协议：

  1. 作为组织所有者，登录到开发人员门户。
    • 如果你不是组织所有者，请要求他们执行此程序。
  2. 依次点击 我的产品（Your Product）> 游戏服务（Game Services）> 成就（Achievements）> Epic Games商城成就（Epic Games Store achievements）。
  3. 选择 开发人员协议（Developer agreement）。
  4. 阅读并签署更新的开发人员协议。

步骤2和3：生成及选择沙盒与部署

要设置Epic Games商城成就，必须首先在产品中生成Dev和Stage沙盒与部署。此外，你还必须在每个沙盒中选择一个供Epic Games商城使用的部署。Epic在线服务会将包括成就数据在内的产品的全部用户数据关联到指定部署。

生成及选择沙盒与部署：

  1. 在开发人员门户中，依次点击 我的产品（Your Product）> 游戏服务（Game Services）> 成就（Achievements）> Epic Games商城成就（Epic Games Store achievements）。
  2. 如果尚未完成步骤1：签署更新的开发人员协议，你需要先完成该步骤才能继续操作。
  3. 选择 生成（Generate） 以生成新的Dev和Stage沙盒以及相关联的部署。
    • 如果你的产品已配置了Dev和Stage沙盒，并且每个沙盒中都有一个或多个部署，则可以跳过此步骤。
  4. 为每个沙盒选择一个主要部署。此部署将包含你的Epic Games商城成就。
  5. 选择 提交（SUBMIT）。

在产品中创建Epic Games商城成就

如下所示，有两种方法可以在产品中创建Epic Games商城成就：

批量上传Epic Games商城成就

使用批量导入功能一次性添加多个Epic Games商城成就。你必须在Dev沙盒中，为链接到Epic Games商城成就的部署执行此操作。

在此过程开始时，你必须执行以下操作之一：

  • 方法1：将当前Epic在线服务成就从Live部署导出到zip文件。如果你已为产品定义了成就，则建议使用此方法。
  • 方法2：“下载Epic Games商城成就CSV模板”在下方第二个屏幕中显示。

随后，你可以在下载的文件中定义成就并将文件导回到开发人员门户。

方法1：导出当前的Epic在线服务成就

  1. 依次点击 游戏服务（Game Services）> 成就（Achievements）> Epic在线服务成就（Epic Online Services achievements）。
  2. 在 部署（Deployment） 下拉菜单中，切换到Live沙盒。
  3. 选择 批量导入/导出（BULK IMPORT/EXPORT）。
  4. 选择 导出当前成就（EXPORT CURRENT ACHIEVEMENTS）。
  5. 关闭批量导出器。

现在你可以定义并上传成就。

方法2：下载Epic Games商城成就模板

  1. 依次点击 游戏服务（Game Services）> 成就（Achievements）> Epic在线服务成就（Epic Online Services achievements）。
  2. 在 部署（Deployment） 下拉菜单中，切换到Dev沙盒。
  3. 选择 批量导入/导出（BULK IMPORT/EXPORT）。
  4. 选择 下一步（NEXT）。
  5. 选择 下载Epic Games商城成就Zip模板（DOWNLOAD EPIC PROFILE CHIEVEMENTS ZIP TEMPLATE）。
  6. 关闭批量导出器。

现在你可以定义并上传成就。

定义并上传成就

无论使用上述哪种方法，你现在都必须将成就添加到csv文件中，然后上传该文件。

  1. 在计算机上，解压已下载的zip文件。
  2. 打开 achievementDefinitions.csv。
  3. 如果最后一列不是 user_epic_achievements_xp，则添加此列。
  4. 使用适当的成就的值填充文件。
  5. （可选）编辑 achievementLocalizations.csv。在此文件中，你可以添加本地化文本并将图像与成就相关联。
  6. 添加文件（包括修改后的 achievementDefinitions.csv' 文件）到新的zip存档中。将所有文件放在zip存档的根级别。
  7. 在开发人员门户中，依次点击 游戏服务（Game Services）> 成就（Achievements）> Epic在线服务成就（Epic Online Services achievements）。
  8. 在 部署（Deployment） 下拉菜单中，切换到Dev沙盒。
  9. 选择 批量导入/导出（BULK IMPORT/EXPORT）。
  10. 选择 下一步（NEXT）。
  11. 向下滚动以阅读并同意警告消息。
  12. 选择 选择要上传的文件（CHOOSE FILE TO UPLOAD） 并选择生成的zip存档。
Image: Example achievement definition in the CSV file

图片：CSV文件的示例成就定义。

检查成就导入

导入成就后，你可以检查它们是否满足成就的XP（经验值）要求中设定的标准。

要检查成就导入：

  1. 在开发人员门户中，依次点击 我的产品（Your Product）> 游戏服务（Game Services）> 成就（Achievements）> Epic Games商城成就（Epic Profile achievements）。
  2. 在屏幕上方，找到 推送到STAGE（PUSH TO STAGE） 按钮。
    • 如果该按钮已启用，则表示成就已通过验证。这意味着这些成就满足成就的XP（经验值）要求中设定的标准。向前跳到此程序的步骤4。
    • 如果该按钮已禁用，则表示成就未通过条件验证。展开消息以查看你的成未能通过验证的详细原因。常见错误包括XP值缺失或不正确、XP值总数不等于1000、图标文件大小不正确，以及超出字符限制。详细了解XP要求。
  3. 解决文件中的错误，更新zip存档，然后再次使用批量导入过程上传zip存档。

在推送到Stage之前，你可以在产品中验证Epic Games商城成就。为此，请在SDK初始化期间，创建一个使用与成就相关联的Dev沙盒和部署的产品版本。

如果你将成就推送到Live，则可以在产品详情页面和成就详情页面上进行预览。为此，你首先需要将成就推送到Stage以供审核和批准。

创建并链接单个Epic Games商城成就

注意: 本小节介绍如何创建并链接单个Epic Games商城成就。如果你的产品中已有Epic在线服务成就，建议使用批量上传Epic Games商城成就。

在创建Epic Games商城成就时，请将其链接到一个Epic在线服务成就并为其分配XP值。如果没有合适的Epic在线服务成就，可以在开发人员门户中快速创建一个。

创建与Epic Games商城成就对应的Epic在线服务成就

注意: 如果你已经有与Epic Games商城成就对应的Epic在线服务成就，则可以直接创建Epic Games商城成就。

有两种方法可以定义Epic在线服务成就：

  • 在发布前，在产品中添加一些相应的代码。详细了解Epic在线服务成就。
  • 每个Epic在线服务成就都基于统计数据。例如，如果想创建一个用于奖励用户在游戏中完成一定距离的成就，那么你首先需要创建一个统计数据来跟踪玩家的完成距离。然后再基于此统计数据计算成就。

创建Epic在线服务成就：

  1. 依次点击 游戏服务（Game Services）> 成就（Achievements）> Epic在线服务成就（Epic Online Services achievements）。
  2. 在 部署（Deployment） 下拉菜单中，选择与Dev沙盒关联的部署。
  3. 选择 新建（CREATE NEW）。
  4. 如果你希望基于某个统计数据计算此成就，请选择该统计数据。
    • 例如，如果你希望在产品用户收集到一定数量的物品时解锁成就，请选择与收集物品数量相关的统计数据。
  5. 如果你在步骤4中选择了一个统计数据，请输入解锁该成就的统计数据值。
    • 例如，如果你希望在产品用户收集五个护身符时解锁成就，请输入 5。
  6. 单击 下一步（NEXT）。
  7. 输入成就设置如下：
    • 成就ID（Achievement ID）：用于标识成就的唯一值。
    • 选择语言区（Select Locale）：名称和描述适用的语言区。你可以为Epic Games商城支持的每种语言定义一组不同的Epic Games商城成就。
    • 可视性（VISIBILITY）：确定产品用户在解锁成就之前是否能够看到成就。
    • 解锁后图标（UNLOCKED ICON）：上传一个图标，该图标将在产品用户解锁成就后，由Epic Games社交覆层或产品展示。
    • 解锁前图标（LOCKED ICON）：产品用户在解锁成就之前看到的图标。 注意： 此图标不会向你的产品用户展示相关的Epic Games商城成就。相反，用户会看到半透明版本的解锁后图标。
    • 解锁前显示名称（Locked Display Name）：产品用户在解锁成就之前看到的名称。
    • 解锁前描述（Locked Description）：产品用户在解锁成就之前看到的描述。
    • 解锁后显示名称（Unlocked Display Name）：产品用户在解锁成就之后看到的名称。
    • 解锁后描述（Unlocked Description）：产品用户在解锁成就之后看到的描述。
    • 可选风格描述（Flavor Text Optional）：可以在产品中自由使用的附加文本（选填）。
  8. 选择 创建（CREATE）。

创建并链接Epic Games商城成就

注意：你必须将每个Epic Games商城成就链接到一个Epic在线服务成就。如果你还没有合适的Epic在线服务成就，可以快速在开发人员门户中创建一个。

要新建Epic Games商城成就：

  1. 依次点击 游戏服务（Game Services）> 成就（Achievements）> Epic在线服务成就（Epic Online Services achievements）。
  2. 在部署（Deployment）下拉菜单中，选择与Dev沙盒关联的部署。
  3. 在成就列表中，找到要链接到新Epic Games商城成就的Epic在线服务成就。
  4. 选择 … > 链接成就（Link achievement）。
  5. 为成就输入一个经验值。
  6. 选择 创建链接（CREATE LINK）。

编辑Epic Games商城成就的经验数值

你可以编辑Epic Games商城成就奖励的经验。

注意: 将成就推送到Live后，你无法更改Epic Games商城成就的XP值。

编辑Epic Games商城成就奖励的XP值：

  1. 依次点击 游戏服务（Game Services）> 成就（Achievements）> Epic在线服务成就（Epic Online Services achievements）。
  2. 在Epic在线服务成就上方的下拉菜单中，选择与Dev沙盒关联的部署。
  3. 选择 Epic Games商城成就（Epic Profile achievements）。
  4. 找到要修改其XP的成就。
  5. 选择 ... > 编辑XP（Edit XP）。
  6. 输入新的XP值。
  7. 选择 保存（SAVE）。

取消链接并删除Epic Games商城成就

你可以将Epic Games商城成就与关联的Epic在线服务成就取消链接。执行此操作时，将产生以下结果：

  • 你的操作将删除Epic Games商城成就。
  • 你的操作不会删除关联的Epic在线服务成就。

注意: 如果成就已推送到Live，则无法在开发人员门户中取消链接Epic Games商城成就。在这种情况下，要删除成就，请[联系Epic Games支持](https://epicsupport.force. com/epicgamesstoreknowledgebase/s/my-cases)。

取消链接并删除Epic Games商城成就：

  1. 依次点击 游戏服务（Game Services）> 成就（Achievements）> Epic在线服务成就（Epic Online Services achievements）。
  2. 在Epic在线服务成就上方的下拉菜单中，选择与Dev沙盒关联的部署。
  3. 选择 Epic Games商城成就（Epic Profile achievements）。
  4. 找到要取消链接并删除的成就。
  5. 选择 ... > 取消链接（Unlink）。
  6. 选择 删除链接（REMOVE LINK）。

查看你已上线的Epic Games商城成就

要查看产品详情页面和产品的新成就详情页面，请先确保：

  • 已将产品推送到Live。
  • 产品已有目录项目。
  • 产品已有商品。

要查看 成就详情页面，请使用以下URL。将<product-name>替换为你的产品名称。 /store/en-US/achievements/<product-name>

图片：成就示例的详情页面。

你现在可以将成就推送到Stage沙盒。如需了解相关信息，请参阅发布、审核和批准。

发布、审核和批准

注意: 在成就上线后，你无法将其删除或调整其XP的值。要更改文本或图像，请按照本小节中介绍的正常发布流程进行操作。如需删除成就，请[联系Epic Games支持](https://epicsupport.force. com/epicgamesstoreknowledgebase/s/my-cases)。

发布工作流

要使成就上线并允许用户查看，请遵循以下发布工作流进行操作：

  1. 在Dev沙盒中，创建成就。
  2. 将成就推送到Stage沙盒。Epic Games在审核流程中审查成就。
  3. 将成就推送到Live沙盒。

注意： 当你将Epic Games商城成就从一个沙盒推送到另一个时，它们会替换部署中链接到目标沙盒的任何成就。

将成就推送到Stage

要将成就推送到Stage，请选择成就列表上方的 推送到STAGE（PUSH TO STAGE）。如果该按钮未激活，则表示存在必须首先解决的错误。页面上的警告框会列出这些错误。

成就审核

在审核过程中，Epic Games会确认是否存在不当内容，例如成人内容、脏话和资产盗用。

Epic Games不会审核未链接的成就（即，Epic在线服务成就）。Epic Games仅审核Epic Games商城成就。

Epic Games商城成就未通过审核

如果Epic Games拒绝了你的Epic Games商城成就，你将在Stage沙盒中看到以下消息。

要查看更多信息，请选择 查看详细信息（SEE DETAILS）。

要修复问题，请切换到Dev沙盒，进行必要的更改，然后将成就重新提交到Stage等待批准。

注意:

  • 推送到Stage后，你可以在产品得到批准之前随时进行其他更改。需要修改时，先取消到Stage的推送，然后在Dev沙盒中进行更改，再重新将产品推送到Stage。
  • 对成就集进行任何更改后，你必须重新提交整个成就集到Stage以待审核。

成就通过审核后

在Epic Games批准了你的成就后，你将在屏幕顶部看到一条消息以及一个用于将它们推送到Live的按钮。

将成就推送到Live

成就上线后，将应用以下限制：

  • 无法调整已上线成就的XP。
  • 要删除一项已上线成就，必须联系Epic Games支持。
  • 要更改已上线成就的文本或图像，请遵循正常的发布流程进行操作。

将成就推送上线：

  1. 切换到Stage沙盒。
  2. 在成就列表上方，选择 推送到LIVE（PUSH TO LIVE）。

Epic Games商城成就的XP要求

Epic Games商城成就的XP（经验值）必须遵守以下要求：

  • 无论定义多少个成就，每个产品提供的XP总数必须为1000点。
  • 如果在游戏中添加的XP超过或不足1000点，则会收到一条错误消息。
  • 如果产品的XP超过或不足1000点，则无法将成就从Dev推送到Stage。
  • 你可以在 游戏服务（Game Services）> 成就（Achievements）> Epic Games商城成就（Epic Profile achievements） 中成就表的上方查看产品的XP总数。
  • 每项成就的XP值必须是5的倍数（比如5、10、15、100、110或200）。
  • 单个成就的最低XP值为5点，最高值为200点。
  • 注意：如果你打算添加带有成就的DLC，或者成就会超过1000XP，你应该继续使用Epic在线服务成就。对于超过1000XP的成就的支持将在未来的版本中实现。
  • 注意：Epic Games商城成就分为青铜、白银和黄金三个等级，如下所示：
    • 5-45 XP：青铜
    • 50-95 XP：白银
    • 100-200 XP：黄金
    • 另有一个白金级成就。产品用户在一个产品中获得的XP总数达到1000时解锁此成就。