如何将启动器集成到Epic游戏商城

运行机制

您可以在Epic游戏商城(EGS)中将游戏与启动器集成，这样可以通过艾克索拉启动器来推广您的其他EGS游戏。

前提条件

要设置Epic游戏商城集成，您需要：

• Epic应用ID（构件ID）
• Epic Games开发者门户上具有管理员角色和游戏应用程序的帐户
• 用于在Epic游戏商城发布的游戏编译版本
• 已在发布商帐户中配置完成的启动器
• 最新版本的BuildPatch Tool

获取Epic应用ID（构件ID）

查找Epic应用ID的方法：

1. 登录Epic游戏开发者门户。
2. 前往您的游戏产品。
3. 在游戏卡片中，选择Epic Games Store选项。

4. 在侧边栏中，单击Artifacts and Binaries，选择沙盒和构件。

5. 单击构件名称查看Epic应用ID

集成步骤

设置身份认证

1. 如果没有客户端策略，请创建一个：
   1. 登录Epic游戏开发者门户。
   2. 在产品（游戏）设置中，前往Product Settings > Clients > Add new client policy部分。
   3. 在Client policy字段中添加策略名称。
   4. 从Client policy type下拉列表中选择GameClient策略。
   5. 单击Add new policy。

2. 创建登录客户端：
   1. 在产品设置中，前往Product Settings > Clients > Add new client部分。
   2. 在Client name字段中添加客户端名称。
   3. 从Client policy下拉列表中选择新创建的客户端策略。

3. 单击Create Application。

4. 分配已创建的客户端：
   1. 在右上角单击Linked Clients。
   2. 从Select Clients下拉列表中选择之前创建的客户端。

5. 确保权限已配置，单击Permissions导航栏。如果标记为Not configured，请启用然后禁用任意选项，然后保存更改。

6. 2. 在您的发布商帐户项目中，前往登录管理器部分。
7. 选择登录选项，然后前往身份认证 > 发布平台 > Epic Games部分。
8. 填写应用程序ID和应用程序密钥字段。您可以从Epic游戏开发者门户（Product Settings > Clients > Edit client部分）复制字段值。
9. 单击保存更改。

设置EGS平台并下载文件

1. 在您的发布商帐户项目中，前往启动器部分。
2. 在仪表板中找到启动器，然后单击编辑启动器。
3. 前往设置部分，然后单击Epic Games平台Logo右侧的设置。

4. 输入您游戏的Epic应用ID。
5. 要确保用户各项权利正常工作，请指定Audience Item ID。执行以下步骤获取该ID：
   1. 在产品设置中，前往Epic游戏商城 > 商品(Offers)部分。
   2. 确定启动器将用于检查权利的商品。如果用户拥有您选择的权利商品，启动器将认为该用户拥有游戏。
   单击Edit offer以查看Audience Item ID。

7. 单击下载启动器host文件下载适用于Windows或macOS的LauncherHost.zip压缩包。
8. 单击下载配置下载适用于Windows或macOS的hostArgs.json配置文件。

生成并下载启动器安装程序

准备EGS的游戏编译版本

1. 将LauncherHost.zip压缩包（应在上一步下载）解压到您选择的任意文件夹。此压缩包包含GameBuild目录，该目录用于准备将上传到Epic开发者门户的游戏编译版本。

• LauncherHost.exe — LauncherHost工具的可执行文件
• Qt5Core.dll vcruntime140-140_1.dll、msvcp140-140_1.dll — LauncherHost.exe工具的服务库
• installer — 包含启动器安装程序的目录

对于MacOS，目录结构为：

• LauncherHost — LauncherHost工具的可执行文件
• Frameworks — LauncherHost工具库的系统文件夹
• installer — 包含启动器安装程序的文件夹

2. 在GameBuild文件夹中创建一个新文件夹。
3. 将游戏编译版本复制粘贴到该文件夹
4. 在游戏 > 编译版本 > 可执行文件部分设置游戏可执行文件的名称(Windows / macOS)，并指定游戏可执行文件的相对路径。

5. 将启动器安装程序和hostArgs.json文件复制到GameBuild目录。完成后，GameBuild目录的结构如下：
   • 对于Windows：

\---GameBuild
    |   hostArgs.json
    |   LauncherHost.exe
    |   msvcp140.dll
    |   msvcp140_1.dll
    |   Qt5Core.dll
    |   vcruntime140.dll
    |   vcruntime140_1.dll
    |
    \---installer
            installer.exe

2. • 对于macOS：

\---GameBuild
    |   hostArgs.json
    |   LauncherHost
    |
    +---Frameworks
    |   \---QtCore.framework
    |       \---Versions
    |           \---5
    |               |   QtCore
    |               |
    |               \---Resources
    |                       Info.plist
    |                       QtCore.prl
    |
    \---installer
            Launcher.pkg

将游戏编译版本上传至EGS

1. 解压之前下载的BuildPatch Tool。
2. 创建一个目录作为BuildPatch Tool的游戏编译版本缓存目录。
3. 前往解压后的目录BuildPatchTool_x.y.z/Engine/Binaries/Win64（具体路径因BuildPatch Tool版本和操作系统而异）。
4. 在此目录中打开终端，运行以下命令上传游戏二进制文件。更详细的说明请参阅相关文档。

.\BuildPatchTool.exe
  -ClientId="<YourClientId>"
  -ClientSecret="<secret>"
  -mode=UploadBinary
  -OrganizationId="<YourOrg>"
  -ProductId="<YourProduct>"
  -ArtifactId="<YourArtifact>"
  -BuildRoot="<absolute-path-to-GameBuild-directory>"
  -CloudDir="<absolute-path-to-cache-directory>"
  -BuildVersion="1.0.2-launcher-win"
  -AppLaunch="LauncherHost.exe"
  -AppArgs=""

命令参数：

• ClientId和ClientSecret可在Epic开发者门户的Product Settings > BPT Credentials部分获取。

• OrganizationId可在Organization > Settings选项卡的General Settings部分获取。

• ProductId可在Product Settings > SDK Download & Credentials选项卡的EOS SDK Credentials部分获取。

• 关于ArtifactId和BuildVersion参数的值，请参考相关说明。BuildVersion参数的值也可在Epic Games启动器中游戏卡片的操作菜单里找到。

• AppLaunch — 相对于BuildRoot的主可执行文件路径，格式如下：
  • LauncherHost.exe — 对于Windows LauncherHost — 对于MacOS

• AppArgs — 额外启动参数。可以为空字符串。

向构件分配平台

1. 前往构件页面。
2. 在右侧，滚动至Inactive binaries部分，单击操作菜单按钮(...)，单击Assign platforms，选择相应的平台。

在EGS启动器中获取游戏的开发者访问权限

1. 添加新用户到组：
   1. 前往Product Settings > Player Groups部分。
   2. 在特定玩家组上单击操作菜单按钮(...)，然后单击Edit Group。
   3. 前往Add accounts选项卡，选择Epic Games作为身份提供商并指定帐户ID。

2. 生成访问密钥：
   1. 前往项目设置的Epic Games Store > Access keys部分。
   2. 在右上角单击Generate keys。

2. 3. 选择沙盒和要生成密钥的商品。

2. 4. 在Batch name字段中输入密钥名称。
   5. 选择Testing类型。
   6. 指定数量。

2. 5. 密钥创建完成后，下载密钥。单击操作菜单按钮(...)并单击Download。

5. 在EGS启动器右上角单击个人资料按钮，然后单击Redeem Code选项。
6. 兑换已下载的密钥。成功兑换商品的密钥后，用户将获得该商品的权利。

更新游戏编译版本

要更新现有游戏编译版本，请重复准备游戏编译版本、上传至EGS和分配至构件的步骤。