利用 three.js 开发微信小游戏的尝试

作者:eastecho
2018-01-04
37 25 12

前言

这是一次利用 three.js 开发微信小游戏的尝试,并不能算作是教程,只能算是一篇笔记吧。

微信 WeChat 6.6.1 开始引入了微信小游戏,初期上线了一批质量相当不错的小游戏。我在查阅各处的文章时候,发现其中有几款是基于 three.js 开发的,目前火爆朋友圈的《跳一跳》就是其中之一。这引起了我的注意,想起几年前也做过不少 WebGL 的尝试,于是禁不住想要弄到微信小游戏平台上试试。

准备工作

  1. 最新版本的 three.js
  2. 首先应该具有一定的 three.js 开发经验,有之前写过的简单演示代码;
  3. 最新版本的“微信开发者工具”。

另外补充一点:需要足够的耐心,微信开发者工具问题多多,编辑器也各种问题,我是使用 WebStorm 来编写代码,您不妨也试试。遇到奇怪的问题的时候,可能需要多启动几次开发者工具,非常令人恼火。

找一个之前的 WebGL 演示

我随便找了一个很久以前做过的演示代码,如下:

可以拖动旋转,滚轮缩放

创建微信小游戏项目

好啦,现在可以进入开发者工具尝试移植了。

首先,创建一个标准的小游戏项目。

选择“小游戏”项目进行创建,并选择一个空的目录作为项目目录

点击“确定”就会打开一个模板项目,是一个射击游戏,大致的结构如下:

├── game.js
├── game.json
├── project.config.json
├── README.md
├── js
|   ├── databus.js
|   ├── main.js
|   ├── base
|   |   ├── animation.js
|   |   └── ...
|   ├── libs
|   |   ├── symbol.js
|   |   └── weapp-adapter.js
|   ├── npc
|   |   └── enemy.js
|   ├── player
|   |   ├── bullet.js
|   |   └── ...
|   └── runtime
|       ├── background.js
|       └── ...
├── audio
|   ├── bgm.mp3
|   └── ...
└── images
    ├── Common.png
    └── ...

基于这个模板,我们可以将不需要的内容暂时删除,以便跑我们自己的项目。其中,射击游戏相关的内容都可以移除了,但是我们要保留一些关键的代码和配置文件,清理以后,大概会是这个样子:

├── game.js
├── game.json
├── project.config.json
├── README.md
├── js
|   ├── main.js
|   └── libs
|       ├── symbol.js
|       └── weapp-adapter.js
└── images
  1. 其中,images 目录里面放置我们需要使用到的图片,在这个例子中,我放了粒子图片和 indienova Logo 图片在里面;
  2. 将我们必然会用到的 three.js(使用 three.min.js 也可以,但是后面需要修改这个文件,所以建议使用没有 minified 的版本)放入 js/libs
  3. 如果有其它资源,比如音频文件什么的,也可以自建目录放进去;
  4. 然后需要修改一下配置文件,简单的说,只要修改 project.config.json 中的 projectname 即可;
  5. 保留 game.js 不变,这个是入口,会引入 main.js 并执行;
  6. main.js 清空,我们的新代码会在这里完成。

我们还保留了两个 js 文件,libs 中的 symbol.jsweapp-adapter.js。这里需要注意的是 weapp-adapter.js 很重要,官方解释如下:

小游戏的运行环境在 iOS 上是 JavaScriptCore,在 Android 上是 V8,都是没有 BOM 和 DOM 的运行环境,没有全局的 document 和 window 对象。因此当你希望使用 DOM API 来创建 Canvas 和 Image 等元素的时候,会引发错误。

…………

这些使用 wx API 模拟 BOM 和 DOM 的代码组成的库称之为 Adapter。顾名思义,这是对基于浏览器环境的游戏引擎在小游戏运行环境下的一层适配层,使游戏引擎在调用 DOM API 和访问 DOM 属性时不会产生错误。Adapter 是一个抽象的代码层,并不特指某一个适配小游戏的第三方库,每位开发者都可以根据自己的项目需要实现相应的 Adapter。官方实现了一个 Adapter 名为 weapp-adapter, 并提供了完整的源码,供开发者使用和参考。

…………

除此之外 weapp-adapter 还模拟了以下对象和方法:

  • document.createElement
  • canvas.addEventListener
  • localStorage
  • Audio
  • Image
  • WebSocket
  • XMLHttpRequest
  • 等等...

需要强调的是,weapp-adapter 对浏览器环境的模拟远不完整的,仅仅只针对游戏引擎可能访问的属性和调用的方法进行了模拟,也不保证所有游戏引擎都能通过 weapp-adapter 顺利无缝接入小游戏。直接将 weapp-adapter 提供给开发者,更多地是作为参考,开发者可以根据需要在 weapp-adapter 的基础上进行扩展,以适配自己项目使用的游戏引擎。

原文请参阅:这里

可见,微信团队已经为我们开发游戏做好了一些准备,比如露出的 canvas,我们到时候直接拿来使用就是。

将之前的代码移植到项目中

开始将之前写好的代码移植过来,注意由于要使用 ES 6(EMCAScript 6)标准,所以之前的代码可能要做相应的调整,不过大部分都是语法的调整,有一些方法的使用需要增加 bind(this),具体的还请大家参阅我们提供的链接地址,就算不看书,随便尝试一下也能很快有所了解。

新的 main.js 的主体代码看起来是这样:

import * as THREE from 'libs/three.js'

let ctx   = canvas.getContext('webgl')

let scene
let renderer

// ... 其它变量/常量 ...

/**
 * 游戏主函数
 */
export default class Main {
  constructor() {
    this.start()
  }

  start() {
    // 初始化
    scene     = new THREE.Scene()
    renderer  = new THREE.WebGLRenderer({ context: ctx })

    //... 其它代码块 ...

    // 开始循环
    this.loop()
  }

  // UPDATE 更新
  update() {
    // ... 数据更新代码块 ...
  }

  // RENDER 渲染
  render() {
    // ... 渲染代码块 ...
  }

  // 实现游戏帧循环
  loop() {
    this.update()
    this.render()

    window.requestAnimationFrame( this.loop.bind(this), canvas )
  }
}

一些要点:

由于微信已经为我们准备好了的 canvas,所以我们无需自己再进行创建,只需要取得的 canvascontext 就可以了,这里我们使用的不是 2d,而是 webgl

let ctx = canvas.getContext('webgl')

然后我们在创建 WebGLRenderer 的时候,直接使用这个 context 就可以了。

renderer  = new THREE.WebGLRenderer({ context: ctx })

这两点做到了,基本上就不会有太大问题了。

一切正常的话,开发者工具里面应该就能跑得起来了。

能跑起来并不算完,还需要真机测试

真机调试

真机调试不复杂,微信开发者工具提供了真机预览功能,只要点一下“预览”,就会上传代码,并生成二维码供测试。

开发者用微信扫描这个二维码,就可以打开测试。

如果您没有修改过 three.js 源文件,那么很有可能只看到一个黑屏。

还好,微信小游戏提供了一个调试开关,我们可以选择打开调试:

然后再次扫码进入,就可以查看调试信息了:

可以清晰的得知,createElementNS 不被支持,那么我们可以将所有 createElementNS 改为 createElement(注意,这只是暂时解决方案,此方法并不是理想方案,我们以后应该会有更好的解决方法。通过修改 adapter 应该就可以减少 three.js 源文件的修改。)

document.createElementNS( 'http://www.w3.org/1999/xhtml', 'canvas' );
// 改为 ==>
document.createElement( 'canvas' );

不止这一处,而且也不止是针对 canvas 的创建,还有针对 img 的创建,可以都修改掉。

另外由于真机上跑的是 OpenGL ES 1.x/2.x/3.x,所以还有一句要处理:

var version = parseFloat( /^WebGL\ ([0-9])/.exec(gl.getParameter(gl.VERSION))[ 1 ] );
// 改为 ==>
var version = parseFloat( /^(WebGL|OpenGL ES)\ ([0-9])/.exec(gl.getParameter(gl.VERSION))[ 1 ] );

这样改过后,重新再尝试一下看,是不是已经可以了?

2018-01-08 更新

临时解决方案使用后,我后来尝试修改 weapp-adapter.js,就不需要再对 three.js 进行修改了:

createElementNS: function createElementNS(nameSpace, tagName) {
  return this.createElement(tagName)
}

方法很简单:我们在 document 的定义中添加 createElementNS,然后忽略掉 NameSpace 即可。

结束语

好了,简单的介绍了一下怎么利用 three.js 开发微信小游戏,这并不是一篇教程,只是在目前信息和资料不完善情况下的一种尝试,也希望大家一起参与到开发和研究中来,互相交流。

欢迎加入我们的小组:

微信小游戏小组

indienova 小组 参与

源代码

为了方便大家参考,特提供源代码。其中包括一个微信小游戏项目和原始的 WebGL 项目。

Github

源代码下载 代码

参考链接

这几天研究这部分内容的时候,遇到不少奇怪的问题,这部分内容又很难依靠 Google 和 StackOverflow 来解决,还好找到了交流的 QQ 群,以及群中成员的交流心得,才算完成了这次尝试。

参与的微信小游戏 QQ 群:117844722

参考的文章:在微信小游戏中使用 three.js 显示3D 图形

我完成了另外一篇,针对 Phaser 的引入,请查看这里:

其它相关链接

请先阅读:微信小游戏官方文档

目前,Cocos、Egret、Laya 已经完成了自身引擎及其工具对小游戏的适配和支持,访问对应的官方文档可以更快地接入小游戏的开发

近期点赞的会员

 分享这篇文章

eastecho 

从前的边城浪子,现在的路人乙 

您可能还会对这些文章感兴趣

参与此文章的讨论

  1. 水瓶座阿斌 2018-01-04

    赞动手能力

  2. OTAKU牧师 2018-01-05

    现在的大佬真是太腻害了,给跪了

  3. meme 2018-01-05

    如果能看到其它引擎的接入方式就更好了

  4. eastecho 2018-01-06

    通过修改 adapter 应该就可以减少 three.js 源文件的修改

  5. Shxuai 2018-01-08 微信会员

    很棒的文章!

  6. baibukan 2018-01-12

    怎么加载3D模型,试过没有?

  7. zhangzijian86 2018-01-15

    1.目前实验了 下 加载 3d 模型 threejs 报
    ReferenceError: XMLHttpRequest is not defined
    at FileLoader.load (three.js:29673)
    at THREE.OBJLoader.load (OBJLoader.js? [sm]:48)
    at init (game.js? [sm]:49)
    at game.js? [sm]:17
    at require (WAGame.js:11)
    at gamePage.html:87
    目前这个XMLHttpRequest 没有。
    2.ThreeBSP.js 可以正常应用。

    • eastecho 2018-01-15

      @zhangzijian86:需要在 adapter 中将 XMLHttpRequest 露出,并增加监听方法

    • baibukan 2018-01-15

      @eastecho:是否可以出个加载3D模型教程?

    • @baibukan:需要需要

      最近由 iNSPiRATiON 灵感发现 修改于:2018-01-24 09:43:39
  8. jivin 2018-05-20

    有没有人发现过这样的问题,webgl在刚打开工程的时候还好,但是,点完预览后,canvas.getContext('webgl')就一直报空。。只有重新打开项目才行~

  9. 则栋 2020-07-23

    求问:对代码不是很了解的新手,想用物理引擎做一点东西,是用unity好上手,还是three.js结合physijs物理库做好上手?

您需要登录或者注册后才能发表评论

登录/注册