小游戏根目录下的 game.json
文件用来对小游戏进行配置,开发者工具和客户端需要读取这个配置,完成相关界面渲染和属性设置。
配置示例
{
"version": "1.0.1",
"appId": "biligameXXXXX",
"deviceOrientation": "portrait",
"networkTimeout": {
"request": 5000,
"connectSocket": 5000,
"uploadFile": 5000,
"downloadFile": 5000
},
"navigateToMiniProgramAppIdList": ["biligameXXXXXXXX"],
"test": {
"update": {
"enable": true,
"mode": "success"
}
}
}
game.json 配置项列表
属性 | 类型 | 必填 | 默认值 | 描述 |
version | String | 是 | | 当前小游戏版本号 |
appId | String | 是 | | 在 bilibili 小游戏后台注册的 APPID |
deviceOrientation | String | 否 | 'portrait' | 支持的屏幕方向。portrait 为竖屏,landscape 为横屏 |
showStatusBar | Boolean | 否 | false | 是否显示状态栏 |
networkTimeout | Object | 否 | - | 网络请求的超时时间,单位:毫秒 |
navigateToMiniProgramAppIdList | Array | 否 | [] | 需要跳转的小游戏列表,详见bl.navigateToMiniProgram,最多 10 个 |
test | Object | 否 | {} | 模块调试开关 |
networkTimeout
各类网络请求的超时时间,单位均为毫秒。
test
测试一些内置模块的开关,比如更新等,具体模块支持情况请参看具体 API 说明。
属性 | 类型 | 必填 | 默认值 | 说明 |
模块名称 | Object | 是 | | 同时提供了 API 对模块的测试行为进行模拟,参见 setEnableDebug ,test 支持的模块如下: |
test 支持的模块
名称 | 说明 | 示例 | 最低版本 |
update | 系统更新。由于系统更新方法需要上线后才能使用,因此开发时可以启用此开关来进行模拟测试。本开关会对 UpdateManager 生效 | 参见系统更新文档 | 3.6.0 |