Version: 1.7
语言 : 中文
平台能力接入
调试运行

打包及上传

通过 Unity 小游戏宿主插件,可以实现 Unity 宿主小游戏的构建及上传。

通过小游戏宿主后台创建小游戏

在打包和上传之前,需要先在小游戏宿主后台创建一个新的小游戏。该小游戏会通过 Game ID 与上传的游戏进行匹配,以确保正确关联。详见 Unity小游戏宿主官方文档

打包及上传

  • 通过 File -> Build Settings -> MiniGame 切换到小游戏平台。

  • 参考快速入门小游戏构建配置文件配置 小游戏宿主 对应的 Build Profile。

  • Build Profile 的 Inspector 中可以配置以下设置

配置 描述
Game Id 登录小游戏宿主控制台创建并查看您的Game ID。详见 Unity小游戏宿主官方文档
启动背景图 配置游戏启动封面。
首包资源加载方式 小游戏包内:首包资源集成在构建的游戏包内,跟随游戏包上传到宿主平台。CDN: 首包资源需要上传到CDN。
游戏方向 纵向或横向。
CDN地址 游戏资源拉取的CDN地址。当首包资源加载方式为CDN时,首包资源也将从该地址拉取。如果使用InstantGame AutoStreaming, 该地址将会被自动填充为AutoStreaming 里的 AutoStreaming Path
版本 游戏版本。
描述 游戏版本描述。
预分配堆大小 单位MB,预分配内存值,超休闲游戏256/中轻度496/重度游戏768,需预估游戏最大UnityHeap值以防止内存自动扩容带来的峰值尖刺。
IOSHighPerformance+ 是否在iOS平台使用 Tuanjie 小游戏宿主的高性能+渲染方案,有助于提升渲染兼容性、降低WebContent进程内存。
自动上传至宿主平台 构建完成后是否自动将构建结果上传至小游戏宿主平台。
  • (可选) 如果使用了 StreamingAssets,请上传 StreamingAssets 到 UOS,并填写 UOS 使用的 CDN URL。(AutoStreaming 里的 AutoStreaming Path )具体步骤如下:

    • 将构建目录的 StreamingAssets 目录拷贝到 ${项目目录}/CustomCloudAssets 目录下。
    • 使用 Instant Game 插件将 StreamingAssets 上传到 UOS。具体细节请参考 UOS文件上传和下载
  • Build Settings 点击 Build,插件会自动构建项目,并分析相关的 js,wasm 等文件后上传到 CDN 服务器上。

  • 如果勾选了 Build Profile 的 自动上传至宿主平台 配置,在构建完成后会自动打开 小游戏宿主上传记录 窗口,自动将构建好的游戏包上传至宿主平台。

  • 如果未勾选了 Build Profile 的 自动上传至宿主平台 配置,可以通过菜单栏 小游戏宿主->上传历史 打开 小游戏宿主上传记录 窗口,并点击右下角 上传 按钮手动上传构建好的游戏包(位于构建目录下的game.zip文件)

  • 上传完成后可以点击 查看 按钮查看上传游戏包的具体信息,并可以通过使用 Connect App 扫码二维码体验游戏。

  • 点击上传信息右上角图标可以跳转至该游戏包的小游戏宿主控制台。

分包加载

随着小游戏玩法的不断拓展,开发者对于更大包体的需求日益增加。为了解决启动时的加载压力,我们引入了 分包加载 机制,使游戏资源可以按需下载,从而提升整体流畅度和用户体验。

分包加载的本质是 将游戏内容拆分成多个独立包。在玩家首次启动游戏时,系统只下载 核心资源(即 主包 ),确保游戏能够尽快进入可交互状态。其他非必要资源则可以在游戏运行过程中按需下载,从而分散初始加载压力,减少等待时间。

Unity 小游戏宿主平台提供将上传至平台的小游戏包进行分包的功能。

基本流程

  • 启动分包,平台生成采集包。

  • 运行采集包采集首包函数,数据发送至服务端。

  • 通过采集到的首包函数生成分包后的小游戏包,子包自动部署到 CDN 服务端。

  • 发布后会持续收集运行时数据来完善首包函数。

分包需要在小游戏宿主后台进行操作。具体步骤请参考分包操作流程

平台能力接入
调试运行