Setup Guide

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

下面概括了在产品中配置Epic Games商城成就的过程。如需有关Epic Games商城成就的一般信息，请查看成就概述。

首先，执行下面的步骤，为Epic Games商城成就准备你的产品：

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

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

要阅读并签署协议，你组织的所有者应执行下面的步骤。只有组织所有者可以完成此过程。:

1. 在开发人员门户中，找到 我的产品（Your Product）> 游戏服务（Game Services）> 进度（Progression ）> 成就（Achievements） 。然后，选择 Epic Games商城成就（Epic Games Store Achievements） 。
2. 在“开发人员协议（Developer Agreement）”分段中，点击 查看协议（See Agreement） 。
3. 查看Epic在线服务开发人员协议，并点击 接受（Accept） 。

签署协议后，继续执行下面的步骤2和3。

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

注意 ：要详细了解沙盒与部署，请查看产品管理。

要生成及选择沙盒与部署，请执行下面的步骤：

1. 在开发人员门户中，找到 我的产品（Your Product）> 游戏服务（Game Services）> 进度（Progression ）> 成就（Achievements） 。然后，选择 Epic Games商城成就（Epic Games Store Achievements） 。
2. 在“生成沙盒与部署（Generate Sandboxes and Deployments）”分段中，点击 生成（Generate） 以创建新的Dev和Stage沙盒与关联的部署。
   • 注意 ：如果你的产品已配置了Dev和Stage沙盒，并且每个沙盒中都有一个或多个部署，则可跳过此步骤，并继续执行步骤3。
3. 在“选择每个沙盒的主部署（Select a Primary Deployment per Sandbox）”分段中，为每个沙盒选择一个主部署。此部署将包含你的Epic Games商城成就。
   • 提示 ：对于Dev和Stage，选择你要用于预生产QA的部署。对于Live，选择与已上线的产品关联的部署。
4. 查看你的主部署选择。然后点击 提交（Submit） 完成此过程。

设置过程完成后，你就可以开始创建Epic Games商城成就！

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

• 使用批量导入功能一次性定义多个Epic Games商城成就。
  • 提示 ：如果你已在产品中添加Epic在线服务成就，我们建议你使用此方法。
• 使用开发人员门户界面每次定义一个Epic Games商城成就。

下方小节详细介绍了各个方法。

使用批量导入功能一次性添加多个Epic Games商城成。你必须在下载的文件中定义你的成就，然后将该信息上传到开发人员门户。

注意 ：你必须在Dev沙盒中，为链接到Epic Games商城成就的部署执行此操作。

要开始此过程，请选择以下一种方法来检索开始文件：

• 方法1：将当前Epic在线服务成就从Live部署导出到zip文件。如果你已为产品定义了成就，则建议使用此方法。
• 方法2：下载Epic Games商城成就模板以创建新成就。

文件准备好之后，你可以定义并上传成就。

1. 在开发人员门户中，找到 我的产品（Your Product）> 游戏服务（Game Services）> 进度（Progression ）> 成就（Achievements） 。然后，选择 Epic在线服务成就（Epic Online Services Achievements） 。
2. 在“部署（Deployment）”下拉菜单中，选择你的Live沙盒。
3. 在右上角，点击 批量导入/导出（Bulk Import / Export） 。
4. 在“批量导出（Bulk Export）”表单上，选择 导出当前EOS成就（Export Current EOS Achievements） 以下载文件。然后，关闭表单。

你的zip文件准备好之后，查看下面的定义并上传成就小节，了解后续步骤。

1. 在开发人员门户中，找到 我的产品（Your Product）> 游戏服务（Game Services）> 进度（Progression ）> 成就（Achievements） 。然后，选择 Epic在线服务成就（Epic Online Services Achievements） 。
2. 在“部署（Deployment）”下拉菜单中，选择你的Dev沙盒。
3. 在右上角，点击 批量导入/导出（Bulk Import / Export） 以打开表单。然后，点击 下一步（Next） 。
4. 选择 下载Epic Games商城成就Zip模板（Download Epic Games Store Achievements Zip Template） 以下载文件。然后，关闭表单。
   • 注意 ：如果Epic Games商城成就选项不可用，请确保你已完全完成设置过程。

你的zip文件准备好之后，查看下面的定义并上传成就小节，了解后续步骤。

无论使用上述哪种方法，你现在都必须在下载的文件中定义Epic Games商城成就。更新的文件会上传到开发人员门户，以创建你的Epic Games商城成就。

要定义并上传Epic Games商城成就，请执行下面的过程：

1. 在计算机上，解压已下载的zip文件。
2. 打开 achievementDefinitions.csv。
3. 在CSV文件中，确保最后一列是 user_epic_achievements_xp 。如果没有此列，则添加此列。
4. 使用适当的成就的值填充CSV文件。
   • 确保在文件中包含所有已上线的Epic在线服务成就。如果是从Live沙盒导出成就，那么这些成就应该已经包含在内。
   • 详细了解成就的使用限制。
5. 在 user_epic_achievements_xp 列中，为每个成就添加所需经验值（XP）。
   • 注意 ：XP的值必须遵守相应的XP要求。

CSV文件的示例成就定义。

6. （可选）编辑 achievementLocalizations.csv 文件。在此文件中，你可以添加已本地化的文本并将图像与成就相关联。
   • 详细了解achievementLocalizations.csv。
7. 添加文件（包括修改后的 achievementDefinitions.csv 文件）到新的zip存档中。将所有文件放在zip存档的根级别。
8. 在开发人员门户中，找到 我的产品（Your Product）> 游戏服务（Game Services）> 进度（Progression ）> 成就（Achievements） 。然后，选择 Epic在线服务成就（Epic Online Services Achievements） 。
9. 在“部署（Deployment）”下拉菜单中，选择你的Dev沙盒。
10. 在右上角，点击 批量导入/导出（Bulk Import / Export） 以打开表单。然后，点击 下一步（Next） 进入“批量导入（Bulk Import）”页面。
11. 找到页面底部的“上传成就（Upload Achievement）”分段。然后，查看并接受警告消息。
12. 点击 选择要上传的文件（Choose File to Upload） 并选择你的zip存档。然后，点击 下一步（Next） 上传文件。

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

要检查成就导入，请执行下面的步骤：

1. 在开发人员门户中，找到 我的产品（Your Product）> 游戏服务（Game Services）> 进度（Progression ）> 成就（Achievements） 。然后，选择 Epic Games商城成就（Epic Games Store Achievements） 。
2. 找到屏幕上方，找到 推送到Stage（Push to Stage） 按钮。
   • 如果该按钮已启用，则表示成就已通过验证，这意味着这些成就满足XP要求。
   • 如果该按钮已禁用，则表示成就不满足XP要求。展开消息以查看验证失败的详细信息。常见错误包括XP值缺失或不正确、XP值总数不等于1000、图标文件大小不正确，以及超出字符限制。
3. 如果你的成就中存在一个或多个错误，请解决CSV文件中的问题。然后，更新zip存档，并按照批量导入过程重新上传存档。

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

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

创建Epic Games商城成就时，你需要将其链接到Epic在线服务成就，并为其分配经验值（XP）。如果你没有对应的Epic在线服务成就可用，可以通过开发人员门户创建一个。

**注意：**该小节介绍如何创建并链接单个Epic Games商城成就。如果你的产品中已有Epic在线服务成就，或者你想创建多个成就，强烈推荐执行批量上传Epic Games商城成就。

要创建Epic Games商城成就，你必须首先有对应的Epic在线服务成就可与之关联。有两种方法可以定义Epic在线服务成就：

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

要创建Epic在线服务成就，请执行下面的步骤：

1. 在开发人员门户中，找到 我的产品（Your Product）> 游戏服务（Game Services）> 进度（Progression ）> 成就（Achievements） 。然后，选择 Epic在线服务成就（Epic Online Services Achievements） 。
2. 在“部署（Deployment）”下拉菜单中，选择与Dev沙盒关联的部署。
3. 从右上角的选项中，点击 新建（Create New） 。
4. 如果你希望基于某个统计数据计算此成就，请从下拉菜单中选择该统计数据。然后，输入将解锁成就的统计数据值。
5. 点击 下一步（Next） 。
6. 根据需要完成“创建新成就（Create New Achievement）”表单：
   • 成就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） ：可以在产品中自由使用的附加文本（选填）。
7. 完成表单之后，点击 创建（Create） 保存你的新成就。

当你有Epic在线服务成就可用时，就可以创建Epic Games商城成就，并将这两个成就链接在一起。为此，请按照以下步骤操作：

1. 在开发人员门户中，找到 我的产品（Your Product）> 游戏服务（Game Services）> 进度（Progression ）> 成就（Achievements） 。然后，选择 Epic在线服务成就（Epic Online Services Achievements） 。
2. 在“部署（Deployment）”下拉菜单中，选择与Dev沙盒关联的部署。
3. 在成就列表中，找到你想链接到新的Epic Games商城成就的Epic在线服务成就。
4. 点击成就所在行右侧的 菜单图标（...） ，然后选择 链接成就（Link Achievements） 。
5. 输入成就的XP值。
   • 提示 ：如需指南，请查看成就的XP（经验值）要求。
6. 选择 创建链接（Create Link） ，完成并保存你的新Epic Games商城成就。

在将Epic Games商城成就推送到Live之前，你可以编辑此XP值。成就上线之后，此值无法修改。

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

1. 在开发人员门户中，找到 我的产品（Your Product）> 游戏服务（Game Services）> 进度（Progression ）> 成就（Achievements） 。
2. 在Epic在线服务成就上方的下拉菜单中，选择与Dev沙盒关联的部署。
3. 点击 Epic Games商城成就（Epic Games Store achievements） 。然后，找到你想更新的成就。
4. 在成就所在行的右侧，点击 菜单图标（...） 并选择 编辑XP（Edit XP） 。
5. 输入该成就的所需XP值。
6. 点击 保存（Save） 完成更改。

要删除Epic Games商城成就，请将该成就从关联的Epic在线服务成就取消链接。该操作会从产品中删除Epic Games商城成就。它 不会 删除Epic在线服务成就。

要取消链接并删除Epic Games商城成就，请执行下面的步骤：

1. 在开发人员门户中，找到 我的产品（Your Product）> 游戏服务（Game Services）> 进度（Progression ）> 成就（Achievements） 。
2. 在Epic在线服务成就上方的下拉菜单中，选择与Dev沙盒关联的部署。
3. 点击 Epic Games商城成就（Epic Games Store achievements） 。然后，找到你想删除的成就。
4. 在成就所在行的右侧，点击 菜单图标（...） 并选择 取消链接（Unlink） 。
5. 选择 删除链接（Remove Link） ，取消链接并删除Epic Games商城成就。

在Epic Games商城中，有关成就的信息显示在你的产品详情页面和产品专用成就页面上。要预览此信息，请首先确保：

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

然后，使用以下URL预览产品的成就，再将其推送到Live。将<product-name>替换为你的产品的名称： /store/en-US/achievements/<product-name>

成就示例的详情页面。

要使你的Epic Games商城成就线上并允许用户查看，请执行以下工作流程：

1. 在Dev沙盒中，创建成就。
2. 将成就推送到Stage沙盒，并提交供Epic Games商城团队审核。
3. 批准之后，将成就推送到Live沙盒。

注意 ：

• 当你将Epic Games商城成就从一个沙盒推送到另一个沙盒时，它们会替换部署中的链接到目标沙盒的所有成就。
• Epic Games商城成就上线之后，无法通过开发人员门户调整其XP值或删除该成就。要删除已发布的成就，请联系支持人员。
• 要更新与成就关联的文本或图像，请按此小节中所述执行正常发布流程。

要将成就推送到Stage，请执行下面的步骤：

1. 在开发人员门户中，找到 我的产品（Your Product）> 游戏服务（Game Services）> 进度（Progression ）> 成就（Achievements） 并选择 Epic Games商城成就（Epic Games Store Achievements） 。
2. 从右上角的选项中，点击 推送到Stage（Push to Stage） 。

如果“推送到Stage（Push to Stage）”按钮被禁用，无法点击，这表示你的成就包含一个或多个错误。页面上的警报框会列出所有存在的错误，你必须解决这些问题，才能继续。

将成就推送到Stage之后，Epic Games商城团队会审核成就，确定其中是否有不当内容，例如成人内容、脏话和资产盗用。 请注意，Epic Games不会审核未链接的成就（即Epic在线服务成就），只会审核Epic Games商城成就。Epic Games商城成就必须遵守Epic Games商城内容指南。

如果Epic Games商城团队批准了成就，将在屏幕顶部显示一条消息，并有一个按钮可用于将成就推送到Live。

如果Epic Games商城团队在审核过程中拒绝了你的Epic Games商城成就，将在Stage沙盒中显示拒绝消息，如以下示例所示：

要查看有关拒绝的更多信息，请点击 查看详细信息（See Details） 。

要修复已识别的问题，请切换到Dev沙盒，并完成所有必要的更新。然后将成就重新提交到Stage等待审核。

注意：

• 将更新推送到Stage后，你仍可以在产品得到批准之前随时做出其他更改。需要更改时，先取消到Stage的推送，然后在Dev沙盒中完成所需的更新。准备就绪时，将更新的产品再次推送到Stage。
• 如果你对成就集做出更改，必须将整个成就集重新提交到Stage以待审核。

当你的Epic Games商城成就获得审核和批准后，你可以将其推送到Live，供用户使用。为此，请按照以下步骤操作：

1. 在开发人员门户中，找到 我的产品（Your Product）> 游戏服务（Game Services）> 进度（Progression ）> 成就（Achievements） 并选择 Epic Games商城成就（Epic Games Store Achievements） 。
2. 在“部署（Deployment）”下拉菜单中，选择Stage沙盒。
3. 从右上角的选项中，点击 推送到Live（Push to Live） 。

注意 ：Epic Games商城成就上线之后，无法通过开发人员门户调整其XP值或删除该成就。要删除已发布的成就，请联系支持人员。要更新与成就关联的文本或图像，请执行正常发布流程。

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

• 无论定义多少个成就，每个产品提供的XP总数必须为1,000 XP* 点。你可以在开发人员门户中“我的产品（Your Product）> 游戏服务（Games Services）> 进度（Progression）> 成就（Achievements）> Epic Games商城成就（Epic Games Store Achievements）”中查看当前用于产品的XP总数。
  • 如果在产品中添加的XP值超过或不足1,000点，则会收到一条错误消息。
  • 如果产品的XP总数不是恰好等于1,000，则成就无法从Dev推送到Stage（即，XP总数不能超过或不足1,000点）。
• 每项成就的XP值必须是5的倍数（例如，5、10、15、100、110、200，等等）。
• 单个成就的最低XP值为5点，最高值为200点。
• Epic Games商城成就分为青铜、白银和黄金三个等级，如下所示：
  • 青铜（Bronze） ： 5-45 XP
  • 白银（Silver） ：50-95 XP
  • 黄金（Gold） ：100-200 XP
  • 另有一个白金级成就。产品用户在一个产品中获得的XP总数达到1000时解锁此成就。