研发指南

要求

• 哔哩哔哩客户端 >= 8.77.0
• 哔哩哔哩开发者工具 >= 2.0.7
• 命令行工具 >= 2.1.4
• 包体最大15M，不支持分包

工具准备

哔哩哔哩开发者工具

下载&安装

• Windows 系统 https://activity.hdslb.com/blackboard/maxfiles/db36e5b831975bae903bb1922252a269/1766996263851.zip
• Mac 系统 https://activity.hdslb.com/blackboard/maxfiles/db36e5b831975bae903bb1922252a269/1766996273681.zip

如何使用

1. 导入试玩小游戏：
2. 根据游戏引擎，选择对应的导入方式：

• Unity 引擎，若未转换过，选择“Unity 小游戏转 bilibili 小游戏并导入”
• 其他游戏，选择“直接导入”

3. 导入试玩小游戏后，根据开发&测试情况，选择预览，或上传。

命令行工具

安装命令行工具：

npm i -g bili-sgame-cli@latest

查看命令行工具版本，确保其版本 >= 2.1.4:

bili-sgame-cli -v

预览试玩小游戏

命令行工具的预览指令，等同于开发者工具的预览功能。 预览试玩小游戏，执行如下指令：

bili-sgame-cli serve <UID> --playable 1

上传试玩小游戏

命令行工具的上传指令，等同于开发者工具的上传功能。 上传试玩小游戏，执行如下指令：

bili-sgame-cli upload <UID> <DESC> --playable 1

游戏准备

如何生成试玩小游戏

哔哩哔哩试玩小游戏生成方式与非试玩小游戏生成方式并无差别，详细参考： https://miniapp.bilibili.com/small-game-doc/engine/support

Cocos/Laya/Egret

https://miniapp.bilibili.com/small-game-doc/engine/common

Unity

https://miniapp.bilibili.com/small-game-doc/engine/unity 注：使用 CLI 工具，将 Unity 试玩小游戏转成哔哩哔哩试玩小游戏时，命令参数有区别： 追加 “--playable 1”

bili-sgame-cli unity [version] [appid] --playable 1

Webgl2 小游戏

目前，Webgl2 版本的小游戏尚在内测中。若游戏是基于 Webgl2 能力开发的，需要确保“game.json”文件中，存在如下配置，否则，游戏会启动异常：

{
  "iosHighPerformance": true,
  "androidHighPerformance": true
}