普通小游戏开发
API
开放能力
数据分析
视频拍摄器
多端支持

小游戏配置

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

配置项说明

属性类型必填默认值描述最低版本
deviceOrientationString'portrait'屏幕选择方向
showStatusBarBooleanfalse是否显示状态栏
networkTimeoutObject-网络请求的超时时间,单位:毫秒
workersString-多线程 Worker 配置项,详细请参考 Worker 文档
ttNavigateToMiniGameAppIdListString Array-需要跳转的小游戏列表1.23.0
openDataContextString-小游戏开放数据域目录,详见 开放数据域1.11.0
subPackagesObject-分包结构配置,详见 分包加载1.88.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"]
}
点击纠错
评价此篇文档