# 小游戏配置

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

# 配置项

属性 类型 必填 默认值 描述 最低版本
deviceOrientation String 'portrait' 屏幕选择方向
desktopDeviceOrientation String - 在 Windows、Mac 端的屏幕选择方向。如未填,则在 Windows、Mac 端取 deviceOrientation 的值
showStatusBar Boolean false 是否显示状态栏
networkTimeout Object - 网络请求的超时时间,单位:毫秒
workers String - 多线程 Worker 配置项,详细请参考 Worker 文档
subpackages Object Array - 分包结构配置
parallelPreloadSubpackages Object Array - 并行下载能力
navigateToMiniProgramAppIdList String Array - 需要跳转的小程序列表,详见 wx.navigateToMiniProgram 2.4.0
permission Object - 小游戏接口权限相关设置 微信客户端 7.0.0
openDataContext String - 小游戏开放数据域目录,详见 关系链数据
resizable Boolean false 是否开启大屏支持。如果开启,在 PC 端用户可以固定比例拖动窗口大小,也可以将窗口置为全屏;在 iPad 上则开启屏幕旋转支持
displayMode String - 设置初始化分辨率,是否可拉伸
disableSetUserStorageFromMiniProgram Boolean false 是否禁止开放数据域接口 wx.setUserCloudStorage 写入托管数据,设置为 true 之后,只能通过后台接口写用户托管数据
lockStepOptions Object 帧同步游戏服务 配置对象
lockStepOptions.gameTick Number 33 游戏帧下发周期,单位 ms 2.8.0
lockStepOptions.heartBeatTick Number 2000 帧同步心跳周期,单位 ms 2.8.0
lockStepOptions.offlineTimeLength Number 100000 帧同步心跳超时时长,单位 ms 2.8.0
lockStepOptions.UDPReliabilityStrategy Number 3 帧冗余策略,表示每次下发帧时总共下发的帧数量 2.8.0
lockStepOptions.dataType String "String" actionList 的数据类型,有效值:"String" 字符串;"ArrayBuffer" 二进制数据 2.8.0
iOSHighPerformance Boolean false 是否开启 iOS 高性能模式。需要在 MP 后台开通后才可用,详情高性能模式
iOSHighPerformance+ Boolean false 是否开启 iOS 高性能+模式。需要同时开启高性能模式,详情高性能模式
plugins Object - 小游戏插件,插件介绍

deviceOrientation、desktopDeviceOrientation 的合法值

说明 最低版本
portrait 竖屏。不随用户手机的旋转而旋转。
landscape home 键在屏幕右侧的横屏。当用户的手机没有锁定屏幕方向时,横屏的方向会随着手机的旋转而旋转。
landscapeLeft home 键在屏幕左侧的横屏 微信客户端 7.0.0
landscapeRight home 键在屏幕右侧的横屏 微信客户端 7.0.0

# networkTimeout

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

属性 类型 必填 默认值 说明
request Number 60000 wx.request 的超时时间,单位:毫秒。
connectSocket Number 60000 wx.connectSocket 的超时时间,单位:毫秒。
uploadFile Number 60000 wx.uploadFile 的超时时间,单位:毫秒。
downloadFile Number 60000 wx.downloadFile 的超时时间,单位:毫秒。

displayMode 的合法值

分辨率 是否可拉伸
mobile 736x414
pad 1024x768
desktop 1024x768 是,且仅支持等比例拉伸

# workers

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

# subpackages

微信客户端 6.6.7 ,基础库 2.1.0 及以上版本支持

启用分包加载时,声明项目分包结构。

写成 subPackages 也支持。

基础库 2.4.0 开始支持,低版本需做兼容处理

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

# permission

微信客户端 7.0.0 及以上版本支持

小游戏接口权限相关设置。字段类型为 Object,结构为:

属性 类型 必填 默认值 描述
scope.userFuzzyLocation PermissionObject 模糊地理位置相关权限声明

PermissionObject 结构

属性 类型 必填 默认值 说明
desc string 小程序获取权限时展示的接口用途说明。最长30个字符

如:

{
  "permission": {
    "scope.userFuzzyLocation": {
      "desc":"你的位置信息将用于小游戏位置接口的效果展示"
    }
  }
}

permission-desc

# 配置示例

{
  "deviceOrientation": "portrait",
  "networkTimeout": {
    "request": 5000,
    "connectSocket": 5000,
    "uploadFile": 5000,
    "downloadFile": 5000
  },
  "navigateToMiniProgramAppIdList": [
    "wxe5f52902cf4de896"
  ]
}
点击咨询小助手