阅读(282)
赞(9)
QQ小游戏 小游戏配置
2020-07-13 17:05:44 更新
小游戏根目录下的 game.json 文件用来对小游戏进行配置,开发者工具和客户端需要读取这个配置,完成相关界面渲染和属性设置。
配置示例
{
"deviceOrientation": "portrait",
"networkTimeout": {
"request": 5000,
"connectSocket": 5000,
"uploadFile": 5000,
"downloadFile": 5000
}
}
game.json 配置项列表
属性 | 类型 | 必填 | 默认值 | 描述 | 最低版本 |
---|---|---|---|---|---|
deviceOrientation | String | 否 | 'portrait' | 屏幕选择方向 | |
showStatusBar | Boolean | 否 | false | 是否显示状态栏 | |
networkTimeout | Object | 否 | - | 网络请求的超时时间,单位:毫秒 | |
workers | String | 否 | - | 多线程 Worker 配置项,详细请参考 Worker文档 | |
subpackages | Object Array | 否 | - | 分包结构配置 | |
permission | Object | 否 | - | 小游戏接口权限相关设置 |
deviceOrientation 的合法值
值 | 说明 | 最低版本 |
---|---|---|
portrait | 竖屏。不随用户手机的旋转而旋转。 | |
landscape | home 键在屏幕右侧的横屏。当用户的手机没有锁定屏幕方向时,横屏的方向会随着手机的旋转而旋转。 | |
landscapeLeft | home 键在屏幕左侧的横屏 | |
landscapeRight | home 键在屏幕右侧的横屏 |
networkTimeout
各类网络请求的超时时间,单位均为毫秒。
属性 | 类型 | 必填 | 默认值 | 说明 |
---|---|---|---|---|
request | Number | 否 | 60000 | qq.request 的超时时间,单位:毫秒。 |
connectSocket | Number | 否 | 60000 | qq.connectSocket 的超时时间,单位:毫秒。 |
uploadFile | Number | 否 | 60000 | qq.uploadFile 的超时时间,单位:毫秒。 |
downloadFile | Number | 否 | 60000 | qq.downloadFile 的超时时间,单位:毫秒。 |
workers
使用 Worker 处理多线程任务时,设置 Worker 代码放置的目录
subpackages
启用分包加载时,声明项目分包结构。
写成 subPackages 也支持。
permission
小游戏接口权限相关设置。字段类型为 Object,结构为:
|属性|类型|必填|默认值|描述| |scope.userLocation|PermissionObject|否||位置相关权限声明|
PermissionObject 结构
属性 | 类型 | 必填 | 默认值 | 说明 |
---|---|---|---|---|
desc | string | 是 | 小程序获取权限时展示的接口用途说明。最长30个字符 |
如:
{
"permission": {
"scope.userLocation": {
"desc": "你的位置信息将用于小游戏位置接口的效果展示"
}
}
}