配置 - 《QQ 小游戏 v1.5.1 框架文档》

小游戏配置
- 配置示例
game.json 配置项列表

小游戏配置

小游戏根目录下的 game.json 文件用来对小游戏进行配置，开发者工具和客户端需要读取这个配置，完成相关界面渲染和属性设置。

配置示例

{
  "deviceOrientation": "portrait",
  "networkTimeout": {
    "request": 5000,
    "connectSocket": 5000,
    "uploadFile": 5000,
    "downloadFile": 5000
  },
  "navigateToMiniProgramAppIdList": ["qqe5f52902cf4de896"]
}

game.json 配置项列表

属性	类型	必填	默认值	描述
deviceOrientation	String	否	'portrait'	屏幕选择方向
showStatusBar	Boolean	否	false	是否显示状态栏
networkTimeout	Object	否	-	网络请求的超时时间，单位：毫秒
workers	String	否	-	多线程 Worker 配置项，详细请参考 Worker文档
subpackages	Object Array	否	-	分包结构配置
navigateToMiniProgramAppIdList	String Array	否	-	需要跳转的小程序列表，详见 qq.navigateToMiniProgram
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 也支持。

navigateToMiniProgramAppIdList

当小程序需要使用 qq.navigateToMiniProgram 接口跳转到其他小程序时，需要先在配置文件中声明需要跳转的小程序 appId 列表，最多允许填写 10 个。

permission

小游戏接口权限相关设置。字段类型为 Object，结构为：

属性	类型	必填	默认值	描述
scope.userLocation	PermissionObject	否		位置相关权限声明

PermissionObject 结构

属性	类型	必填	默认值	说明
desc	string	是		小程序获取权限时展示的接口用途说明。最长30个字符

如：

{
  "permission": {
    "scope.userLocation": {
      "desc": "你的位置信息将用于小游戏位置接口的效果展示"
    }
  }
}