阅读(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": "你的位置信息将用于小游戏位置接口的效果展示"
    }
  }
}