抖音开放平台Logo
开发者文档
小游戏
控制台
  • 小游戏配置
  • 模块化
  • 场景值

    • 小游戏配置
    收藏
    我的收藏

    小游戏根目录下的 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

    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已废弃，不建议再使用。
    ​