小游戏配置
收藏
我的收藏

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

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

该文档是否有帮助？

本页导读

配置项说明

deviceOrientation 的合法值

networkTimeout

menuButtonStyle 的合法值

workers

ttNavigateToMiniGameAppIdList