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

微信小游戏快速上手教程

文件结构

---

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

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

运行环境

---

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

HTML5 游戏适配指引

---

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

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

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

配置项

---

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

key	数据类型	说明	默认值
deviceOrientation	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
    }
}