微信小程序小游戏开发文档,小游戏快速上手教程

文件结构


小游戏只有以下两个必要文件:

  1. game.js 小游戏主程序入口
  2. game.json 配置文件

运行环境


  1. 小游戏的运行环境跟小程序类似,运行在 中,因此没有 DOM、BOM API。
  2. 与小程序一样,小游戏每次发布需要经过审核。我们在小程序和小游戏中都移除了动态执行代码的能力,包括以下调用方式: eval 函数 setTimeout、 setInterval 函数第一个参数传入代码字符串执行 使用 Function 传入字符串构造函数 使用 GeneratorFunction 传入字符串构造生成器函数

HTML5 游戏适配指引


现有 HTML5 游戏希望移植到小游戏环境,主要需要针对小游戏做以下适配:

  1. 所有 DOM、BOM API 改成小游戏相应的 API 调用方式
  2. 避免在游戏中使用动态执行代码的能力

前期为了减少游戏移植成本,我们提供了一个 ,它基于小游戏环境模拟封装了一套 BOM、DOM API 暴露到全局。

配置项


游戏小程序开发者通过在根目录编写一个 game.json 文件进行配置,开发者工具和客户端需要读取这个配置,完成相关界面渲染和属性设置。

key 数据类型 说明 默认值 String 支持的屏幕方向 portrait showStatusBar Boolean 是否显示状态栏 false networkTimeout Number 网络请求的超时时间,单位:毫秒 60000 networkTimeout.request Number wx.request 的超时时间,单位:毫秒 60000 networkTimeout.connectSocket Number wx.connectSocket 的超时时间,单位:毫秒 60000 networkTimeout.uploadFile Number wx.uploadFile 的超时时间,单位:毫秒 60000 networkTimeout.downloadFile Number wx.downloadFile 的超时时间,单位:毫秒 60000

deviceOrientation

值 说明 portrait 竖屏 landscape 横屏

示例配置

{
    "deviceOrientation": "portrait",
    "networkTimeout": {
        "request": 5000,
        "connectSocket": 5000,
        "uploadFile": 5000,
        "downloadFile": 5000
    }
}
经验分享 程序员 微信小程序 职场和发展