普通小游戏开发
开放能力(必读)
社交转发裂变
数据分析
视频拍摄器
API
多端支持
自2022年9月6日起,本文档站不再更新内容,相关文档已迁移至全新“抖音开放平台”前往

小游戏配置

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

配置项说明

属性

类型

必填

默认值

描述

最低版本

deviceOrientation

String

'portrait'

屏幕选择方向

showStatusBar

Boolean

false

是否显示状态栏

networkTimeout

Object

网络请求的超时时间,单位:毫秒

workers

String

多线程 Worker 配置项,详细请参考 Worker 文档

ttNavigateToMiniGameAppIdList

String Array

需要跳转的小游戏列表

1.23.0

openDataContext

String

小游戏开放数据域目录,详见 开放数据域

1.11.0

subPackages

Object

分包结构配置,详见 分包加载

1.88.0

deviceOrientation 的合法值

说明

portrait

竖屏。不随用户手机的旋转而旋转。

landscape

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

networkTimeout

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

属性

类型

必填

默认值

说明

request

Number

60000

tt.request 的超时时间,单位:毫秒。

connectSocket

Number

60000

tt.connectSocket 的超时时间,单位:毫秒。

uploadFile

Number

60000

tt.uploadFile 的超时时间,单位:毫秒。

downloadFile

Number

60000

tt.downloadFile 的超时时间,单位:毫秒。

workers

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

ttNavigateToMiniGameAppIdList

注意:基础库 1.23.0 开始支持,低版本需做兼容处理。

当小游戏需要使用互跳接口跳转到其他小游戏时,需要先在配置文件中声明需要跳转的小游戏 appId 列表,最多允许填写 10 个。

配置示例

{
  "deviceOrientation": "portrait",
  "networkTimeout": {
    "request": 5000,
    "connectSocket": 5000,
    "uploadFile": 5000,
    "downloadFile": 5000
  },
  "ttNavigateToMiniGameAppIdList": ["ttXXXXXXXXXXX"]
}
点击纠错
该文档是否对你的开发有所帮助?
有帮助
没帮助
该文档是否对你的开发有所帮助?
有帮助
没帮助