阅读(3248) (10)

小游戏配置

2020-02-13 17:03:20 更新

小游戏根目录下的 game.json 文件用来对小游戏进行配置。文件内容为一个 JSON 对象,有以下属性:


配置项说明

注意:subpackages 分包加载暂不支持。属性类型必填默认值描述最低版本
属性类型必填默认值描述最低版本
deviceOrientationString'portrait'屏幕选择方向
showStatusBarBooleanfalse是否显示状态栏
networkTimeoutObject-网络请求的超时时间,单位:毫秒
workersString-多线程 Worker 配置项,详细请参考 Worker 文档
ttNavigateToMiniGameAppIdListString Array-需要跳转的小游戏列表1.23.0+
openDataContextString-小游戏开放数据域目录,详见 开放数据域1.11.0+


deviceOrientation 的合法值

说明
portrait竖屏。不随用户手机的旋转而旋转。
landscapehome 键在屏幕右侧的横屏。当用户的手机没有锁定屏幕方向时,横屏的方向会随着手机的旋转而旋转。


networkTimeout

各类网络请求的超时时间,单位均为毫秒。

属性类型必填默认值说明
requestNumber60000tt.request 的超时时间,单位:毫秒。
connectSocketNumber60000tt.connectSocket 的超时时间,单位:毫秒。
uploadFileNumber60000tt.uploadFile 的超时时间,单位:毫秒。
downloadFileNumber60000tt.downloadFile 的超时时间,单位:毫秒。


workers

使用 Worker 处理多线程任务时,设置 Worker 代码放置的目录


ttNavigateToMiniGameAppIdList

注意:基础库 1.23.0 开始支持,低版本需做兼容处理。当小游戏需要使用互跳接口跳转到其他小游戏时,需要先在配置文件中声明需要跳转的小游戏 appId 列表,最多允许填写 10 个。


配置示例

{
  "deviceOrientation": "portrait",
  "networkTimeout": {
    "request": 5000,
    "connectSocket": 5000,
    "uploadFile": 5000,
    "downloadFile": 5000
  },
  "ttNavigateToMiniGameAppIdList": ["ttXXXXXXXXXXX"]
}