You need to enable JavaScript to run this app.
导航

云游戏上传客户端使用指南

最近更新时间2024.01.23 11:27:52

首次发布时间2023.11.21 17:28:10

简介

在火山引擎云游戏平台上架或更新PC游戏时,可使用云游戏上传本地客户端工具打包上传游戏文件。本文介绍云游戏上传工具的使用方法,帮助您更快地安装或更新游戏。

前提条件

  1. 准备需要上传的游戏文件,并确保待上传的游戏在本地安装后可以启动和正常运行,否则游戏上传后可能会适配失败。

  2. 已开通火山引擎云游戏服务,并创建云游戏端游业务(云游戏控制台链接),用于上架游戏。详细操作步骤,可参考 业务管理说明

安装游戏上传工具

通过以下链接下载并安装云游戏上传工具客户端。

操作系统系统架构下载链接
Windowsx64火山云游戏上传工具安装包
ia32火山云游戏上传工具安装包
Macx64火山云游戏上传工具安装包
arm64火山云游戏上传工具安装包

上传游戏

安装完成后,运行云游戏上传工具,准备上传游戏。详细步骤说明如下:

  1. 在云游戏上传工具登录页面,需要输入已注册的火山引擎账号的 Access Key 和 Secret Access Key 用于身份验证。可点击 密钥管理 链接,前往火山引擎官网 API访问密钥 页面获取。参考以下示例:

  2. 输入火山引擎账号的 Access Key 和 Secret Access Key 后,点击 登录

  3. 上传新游戏 页面,支持以下两种上传方式:

当您还未在控制台创建端游业务时,需先将游戏包上传至云端进行适配,游戏包将被创建至「云游戏控制台-云游戏端游-端游包管理」。在后续业务中创建用于启动的游戏 ID,并关联已创建的游戏包和版本,分开创建流程更清晰。

配置项说明
游戏包名输入游戏包名
版本名称输入游戏自定义版本名称
选择游戏打开电脑本地文件浏览器,选择保存游戏文件的路径(非压缩文件)
启动路径打开电脑本地文件浏览器,选择预备上传文件夹下游戏启动程序 EXE 文件,路径将自动填入
启动参数(选填)填写启动游戏需要配置的其他依赖参数,支持中文、大小写字母、数字和特殊符号(注意:提供的启动路径和启动参数信息将用于游戏适配和游戏启动,填写错误可能导致游戏启动失败)
  1. 确认游戏配置信息无误后,点击 开始上传,选择的游戏文件将会被打包(上传游戏前,需确保本地磁盘有一倍游戏文件的空间用于保存压缩包)。在打包过程中如有任何问题,可点击 取消任务,停止打包和后续的游戏上传任务;取消任务后,该任务的进度不会被保存。

  2. 打包完成后,游戏文件将被上传至云游戏平台。

  3. 游戏上传完成后,云游戏平台上会创建游戏包/游戏 ID,游戏进入适配中状态,并需要一定的时间进行适配分发。

    注意

    游戏打包、上传、创建过程中,不可返回到上传新游戏或更新游戏版本页面并行更新其他游戏。

  4. 游戏创建完成后,可点击 前往控制台 查看游戏的上架结果。游戏上架完成后,上架的游戏为该游戏的第一个版本。

更新游戏版本

通过以下步骤,上传新版本游戏安装文件、更新游戏版本:

  1. 运行游戏上传工具并登录。在左侧导航栏中选择 更新游戏版本

  2. 更新游戏版本 页面,提供两种上传方式:

当您准备更新游戏版本但暂时不准备在真实启动的游戏 ID 下同步进行更新时,可以选择仅更新游戏包。上传后版本管理将新增游戏版本但不会影响任何游戏 ID,分开操作流程更清晰。

配置项说明
更新方式选择全量更新或增量更新
游戏包名输入游戏包名
版本名称输入游戏自定义版本名称
选择游戏打开电脑本地文件浏览器,选择保存游戏文件的路径(非压缩文件)
启动路径打开电脑本地文件浏览器,选择预备上传文件夹下游戏启动程序 EXE 文件,路径将自动填入
启动参数(选填)填写启动游戏需要配置的其他依赖参数,支持中文、大小写字母、数字和特殊符号(注意:提供的启动路径和启动参数信息将用于游戏适配和游戏启动,填写错误可能导致游戏启动失败)

我们提供了两种更新方式,您可按需选择:

  1. 全量更新:直接上传一个完整可独立运行的游戏包版本,游戏包整体进行云化适配和更新应用;适用于不知晓游戏包内差异文件内容变更情况下,更为安全稳妥的更新方式,但全量更新耗时相对较长

  2. 增量更新:默认以前一个游戏包版本作为基础,在版本上进行同名文件替换与增量文件补充,适用于知晓游戏包内差异文件内容的情况下,更为轻量快速的更新方式。

    注意

    增量更新时,请您准确打包并谨慎检查,否则可能导致游戏更新后启动失败。

以下为增量文件在本地的文件夹打包方式示例:

  • 全量包V1.0:

    在test_pc_game_v1.0文件目录中
    .
    ├── c.exe
    ├── test_a
    │   └── a.txt
    └── test_b
       └── b
           └── b.dll
    
  • 增量包V1.1:

    • c.exe文件更新了

    • test_a 下面增加了a1.dll文件

    • 新增了test_c/c.so 文件

    在test_pc_game_v1.1文件目录中
    .
    ├── c.exe
    ├── test_a
    │   └── a1.dll
    └── test_c
       └── c.so
    

最终合并后:

.
├── c.exe
├── test_a
│   ├── a.txt
│   └── a1.dll
├── test_b
│   └── b
│       └── b.dll
└── test_c
    └── c.so
  1. 确认游戏版本信息无误后,点击 开始上传。选择的游戏文件将会被打包、上传、创建至云游戏平台(在此过程中如有任何问题,可点击 取消任务,停止打包和后续的游戏上传和创建任务;取消任务后,该任务的进度不会被保存)。

  2. 新版本游戏创建完成后,可点击 前往控制台 查看游戏新版本的上架结果。新版本上架和适配完成后,游戏状态为 上架完成,可在游戏的版本管理页面中查看游戏的版本信息。

启动游戏

游戏上架完成后,启动游戏前还需要为运行游戏配置所需的资源。详细信息,参考 配置部署策略