跳到主要内容

游戏下载器

迅雷平台的游戏下载器负责游戏首次启动的下载、解压流程，下载器确保每一款游戏都能解压到正确的路径。建议接入通用下载器实现游戏的首次下载流程。

准备工作​

游戏方将启动游戏的文件夹打包为一个 zip 压缩包，上传到游戏方自己或迅雷的 CDN，从而获得一个下载链接。

首包限制

由于平台的通用下载器不支持下载大小超过 1000M 的文件，因此请将 zip 压缩包大小控制在 1000M 以内。

下载通用下载器​

首先，下载通用下载器的原始文件。然后解压缩，得到一个文件夹。打开文件夹，目录结构如下：

下载器文件结构包含以下内容
  1. 主程序 XLGameDownloader.exe。
  2. 主程序依赖的动态链接库 libcrypto-1_1.dll libcurl.dll libexpat.dll libssl-1_1.dll minizip.dll zlib1.dll。
  3. 配置文件夹 config。内含一个 JSON 文件。
  4. 资源文件夹 resource。内含一张背景图片。

上述文件会在后续进行封包，最后得到 1 个 exe 文件。

编辑配置文件​

打开 config 文件夹，编辑里面的 config.json 文件。

// config.json 文件内容示例
{
  "GameInfo": {
    "start_path": "game.exe",
    "background": "./resource/image/background.png",
    "game_url": "https://cdn.example.com/download/game-package.zip",
    "file_size": 100774140,
    "game_id": "cdef01234567890123456"
  }
}

配置内容参数说明​

参数含义示例说明
start_path游戏压缩包解压后的游戏启动路径game.exe参数说明
background下载器界面的背景图片./resource/image/background.png背景图片规范
game_url游戏压缩包下载链接 ziphttps://cdn.example.com/download/game-package.zip
file_size游戏压缩包大小 字节100774140单位是 字节
game_id平台的游戏 IDcdef01234567890123456由平台提供

start_path 参数说明​

请先前往迅雷游戏客户端查询游戏下载路径。

在迅雷游戏客户端点击开始 Windows 端游，首先会将游戏的下载器下载到 游戏下载路径/xlgame/download/平台的游戏 ID/ 目录。

接着，迅雷游戏客户端启动游戏下载器，游戏方的 zip 压缩包会被下载到 Game 文件夹（即 游戏下载路径/xlgame/download/平台的游戏 ID/Game/ 目录），并将压缩包解压到同一目录下。

然后，迅雷客户端会根据 start_path 打开游戏 exe 文件，即 start_path 是指向游戏主程序的相对路径。

举个例子
  • 游戏主程序在游戏方的 zip 压缩包的根目录，且文件名为 game.exe，那么 start_path 就是 game.exe。
  • 游戏主程序在游戏方的 zip 压缩包的 bin 文件夹下，且文件名为 game.exe，那么 start_path 就是 bin/game.exe。

替换资源文件​

打开 resource 文件夹，再打开 image 文件夹，替换里面的 background.png 为游戏方需要的背景图片。

提示

如您变更了配置文件 config.json 中 background 指向的路径，请将背景图片存放到 background 指向的路径。

背景图片规范​

格式： png / jpg

尺寸： 712 * 412

内容： 图片应包含游戏 LOGO。

布局：

参考示例：

封包​

下载封包工具​

下载 Enigma 文件打包工具（Enigma Virtual Box） 安装包，前往官网下载或点此下载。

安装封包工具​

执行封包工具的安装包 enigmavb.exe，按照安装程序完成安装流程。

启动封包工具​

启动打包程序，可以看见如下界面：

填写输入程序路径​

将 XLGameDownloader.exe 文件拖拽到 Enter Input File Name 输入框，亦可点击右侧的 Browse... 按钮选择输入文件。

填写输出程序路径​

在 Enter Output File Name 输入框填写输出程序路径，输出程序的路径可自定义，此处示例为 XLGameDownloader_boxed.exe 。

添加程序依赖​

将除 XLGameDownloader.exe 主程序的所有文件拖拽到封包工具的 Files 区域内。

弹出 Select Folder 弹窗，使用默认值 %DEFAULT_FOLDER%，点击 OK 按钮。

封包工具的 Files 区域将会展示刚才选择的所有文件。

执行封包​

点击封包工具右下方的 Process 按钮，执行封包。

封包完成后，之前填写的输出程序路径将会出现一个 exe 文件，点击 Run 按钮可以测试执行封包完成的程序。

提示

封包得到的文件通常不小于 5M，如果您封包得到的文件小于大小，请检查是否正确添加程序依赖。

签名加白​

将封包完成的 exe 程序提供给平台人员，平台对 exe 程序进行签名加白，然后待平台侧审核上线测试。