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

由 ✎﹏๓₯㎕ζั͡❦﹏﹏♛ 创建, 最后一次修改 2017-12-28

已更新:查看最新版小游戏快速上手教程


微信小游戏快速上手教程

文件结构


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

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

运行环境


  1. 小游戏的运行环境跟小程序类似,运行在 JavaScriptCore 中,因此没有 DOM、BOM API。
  2. 与小程序一样,小游戏每次发布需要经过审核。我们在小程序和小游戏中都移除了动态执行代码的能力,包括以下调用方式:
    • eval 函数
    • setTimeoutsetInterval 函数第一个参数传入代码字符串执行
    • 使用 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
    }
}


W3Cschool app 编程微课功能上线
二维码
建议反馈
二维码