抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • 小游戏配置
  • tt
  • 模块化
  • 场景值
  • 基础功能
  • 小游戏配置
    收藏
    我的收藏

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

    配置项说明

    属性
    类型
    必填
    默认值
    描述
    最低版本
    deviceOrientation
    String
    'landscape'
    设置屏幕方向
    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
    menuButtonStyle
    String
    设置小游戏右上角更多面板深浅色模式,具体 UI 效果见下方合法值说明
    3.16.0
    enableIOSHighPerformanceMode
    Boolean
    false
    iOS 操作系统上小游戏是否开启高性能模式,详见 普通小游戏高性能模式
    3.43.0
    plugins
    Object
    -
    插件配置,指定依赖的插件, 可以通过 requirePlugin 能力加载插件。插件功能还在内测中, 声明平台不支持的插件会有编译报错,如不需要,请删除game.json中的 plugins字段
    3.65.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 的超时时间,单位:毫秒。

    menuButtonStyle 的合法值

    说明
    light
    浅色模式。适合用于背景色偏亮。
    dark
    深色模式。适合用于背景色偏暗。

    workers

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

    ttNavigateToMiniGameAppIdList

    注意:基础库 1.23.0 开始支持,低版本需做兼容处理。
    当小游戏需要使用跳转类接口到其他小游戏时,需要先在配置文件中声明需要跳转的小游戏 appId 列表,最多允许填写 10 个。
    该字段涉及接口tt.createMoreGamesButton tt.showMoreGamesModal已废弃,不建议继续使用。

    plugins

    插件配置, 类型是一个 Object,key 是插件别名, value 类型如下:
    属性
    类型
    必填
    默认值
    说明
    provider
    string
    插件id
    version
    string
    插件版本
    示范用例如下:
    { "plugins": { "cocos": { "provider": "ttxxxxxxx", "version": "1.0.0" } } }