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

前言

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

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

准备工作

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

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

找一个之前的 WebGL 演示

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

(无法嵌入,如要查看请看原文)可以拖动旋转,滚轮缩放

利用 three.js 开发微信小游戏的尝试​indienova.com图标

创建微信小游戏项目

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

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

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

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

├── 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.js 和 weapp-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,所以我们无需自己再进行创建,只需要取得的 canvas 的 context 就可以了,这里我们使用的不是 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 独立游戏​indienova.com

源代码

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

Github 源代码下载

eastecho/WeChatGame-three-js​github.com图标

参考链接

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

其它相关链接

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

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

 

您可能感兴趣的

 

原文链接:https://zhuanlan.zhihu.com/p/32648805

转载于:https://www.cnblogs.com/curationFE/p/wegame_threejs_development.html

微信小游戏、three.js、真机调试,出现锯齿的解决办法 更正: 原文是基于微信小游戏,在微信开发者工具、手机端微信小游戏,该方案没问题。 我今天尝试移植到普通web,该方案出现新问题: 1)不使用该方案,则出现锯齿。 2)使用该方案,则正圆变成椭圆。 暂时解决不了。 说明 我原先的尝试是错误的,正确的方法见这位大牛的博客:https://blog.csdn.net/sakurallj/article/details/80263494... 阅读详情

相关推荐

在微信小程序中使用Three.js的尝试

  在indienova上看到大佬发了这样的文章,于是学着也用了一下,结论是可以的。 因为懒,所以在WebGL中文网拷了一份代码下来。(这个网站学three.js还真的是挺好的,有条件的朋友可以过去买几节课,支持一下。)   好了,我们现在来开始: 1.首先你要注册,并创建一个小程序,要注意,类型要是游戏类型的,因为只有这个类型才有暴露出来的canvas 2.打开刚刚下的微信开发者工具...

黑猫拉面 1万+

微信3D小游戏系列一:在微信小游戏中使用threejs

本文基于微信开发者工具,在微信小游戏环境中使用threejs

qq_37987033的博客 4771

一个使用threejs 的简单赛车游戏_JavaScript_代码_下载

一个使用threejs的简单赛车游戏

分享 10 个基于 Three.js 实现的小游戏

今天给大家分享10个基于Three.js 实现的小游戏。只需一个浏览器,就可以「打开下方链接,部分支持移动端」在线玩耍,简直不要泰裤辣!该学的学、想玩的玩,今天星期五,祝大家周末愉快。《Slow Roads》3D赛车游戏01Slow Roads是一款程序生成的休闲驾驶游戏,可让您暂时脱离生活,无休止地奔向遥远的地平线。设置适合您心情的风景,播放一些音乐,然后开车就行了。只需一个浏览器,就能驾车从森...

前端达人 1万+

告别信号干扰!用Altium Designer 19搞定4层/6层PCB叠层设计的保姆级流程

本文详细介绍了如何使用Altium Designer 19进行4层/6层PCB叠层设计,解决信号干扰问题。通过实际案例和系统方法论,涵盖高速数字电路、混合信号系统等典型场景的设计优化,帮助硬件工程师和学生掌握电磁兼容(EMC)与信号完整性(SI)的核心技术。

weixin_27076351的博客 208

在URP中正确写入Sprite深度以使用DOF

我准备在文字冒险中加入景深的效果,但是因为unity内置shader的缘故,sprite是不会写入深度的,而如果要使用PostProcessing的DOF效果的话,是必须要将半透明物体的深度正确写入Depth Buffer的,这篇消耗了我大量精力的文章就是要介绍正确写入的方法。 其实,如果只是要在2D游戏中实现类似于景深的效果,不写入深度其实也是可以的,我找到的有两种方案:一种是实时对Sprite进行模糊计算;二是直接使用离线预模糊的图片,根据强度进行混合。 离线预模糊 虽然这两种方法都可以比较简

FREEstriker的博客 2732

使用THREE.js制作一款3D游戏

使用THREE.js制作一款3D游戏 本文是基于某位大神使用three.js设计游戏的学习心得与知识分享 The Making of “The Aviator”: Animating a Basic 3D Scene with Three.js 前言 这个学期选修了一门计算机图形学的课程,课程选用的教材是基于WebGL。在此之前我对计算机图形学是没有任何概念的,只知道如果想要设计一款游戏具有图形学...

weixin_33717298的博客 5239

从ISCXTor2016到CICIDS2017:手把手教你下载和使用UNB的网络安全数据集

本文详细介绍了UNB大学发布的ISCXTor2016和CICIDS2017等网络安全数据集的下载与使用方法,特别适合加密流量识别和网络行为分析研究。文章提供了多种高效获取路径、文件结构解析及实战分析示例,帮助研究者快速上手这些真实场景捕获的精细标注数据集。

weixin_42524945的博客 643

在微信小游戏中使用three.js显示3D图形

年前,微信发布了一个重磅消息:微信小程序的小游戏功能,千呼万唤始出来! 笔者之前从未接触过微信小程序和WebGL的开发,但是却一直有留意相关技术的发展,大概听说原来微信小程序是不支持WebGL 3D技术的。这次借着微信大力推广小游戏,看了一下API文档,发现小游戏是可以使用WebGL进行开发的。而最近正好又有点时间,就随便搞搞,试试小游戏的效果。因为小游戏“跳一跳”是用three.js制作的,所

czy_csd的专栏 3万+

IoT 平台架构全景图:从设备到 AI 的完整技术体系深度解析

随着物联网设备规模进入百万级时代,IoT 平台架构已经从简单的设备接入系统演变为完整的数据平台。本文从系统架构师视角,深度解析 IoT 平台的完整技术体系,包括设备接入、MQTT 通信、消息流平台、数据平台与 AI 决策系统,并结合主流云平台实践,构建从设备到 AI 的完整 AIoT 架构认知。

moton2017的博客 860

DIY必备:如何用N-MOS管搭建低成本DC有刷电机驱动电路(附原理图+避坑指南)

本文详细介绍了如何使用N-MOS管搭建低成本、高可靠性的DC有刷电机驱动电路。针对DIY爱好者,从核心原理、电路设计、元件选型到焊接调试,提供了完整的实战指南,并重点解析了续流二极管选型、栅极驱动设计等关键避坑要点,帮助读者成功驱动电机并确保电路稳定运行。

delta的博客 781

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

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

一入編程深似海! 1402

3、硬件工程师笔试面试学习汇总——器件篇目录(2025版本)

硬件工程师笔试面试学习

XU157303764的博客 7634

探索《微信小游戏 - Three.js 实现》:打造沉浸式互动体验

探索《微信小游戏 - Three.js 实现》:打造沉浸式互动体验 在这个链接中,您会发现一个激动人心的开源项目,它是一个基于Three.js的微信小游戏开发框架。该项目旨在为微信小程序开发者提供一个便捷的途径,让他们能够创建出具有3D效果和交互性的游戏或应用。 项目简介 WeChatGame-three-js 是一个将 Three.js 集成到微信小游戏平台的库。Three.js 是一款流行的J...

gitblog_00088的博客 870

【数据集实例】CMIP6气候模式数据下载-以河东地区为例

以河东地区为例,介绍CMIP6数据下载及处理

WW、forever的博客 4964

iStoreOS等软路由插件卸载的残留?分享一款软路由高级卸载工具,自定义卸载,轻松解决卸载残留问题

iStoreOS用户看过来!👀 还在被插件包残留困扰吗?本文分享一款“高级卸载”的插件,助你深度清理iStoreOS系统,彻底解决软件卸载不净的痛点,告别频繁恢复出厂设置的烦恼!🚀

XiaoqiangClub的博客 1566

探索创新:微信小游戏开发框架 - WeChatGame

探索创新:微信小游戏开发框架 - WeChatGame 去发现同类优质开源项目:https://gitcode.com/ 项目简介 是一个基于JavaScript和Web技术构建微信小游戏的开源框架。该项目旨在简化微信小游戏的开发流程,为开发者提供一种更高效、灵活的方式来创建互动丰富的游戏体验。通过利用Web技术的优势,它让开发者能够在多个平台上运行他们的作品,包括但不限于微信小游戏平台。 技术分...

gitblog_00096的博客 1068

VC中sqlite的使用

在VC中对sqlite的使用,实现数据库大批数据的快速插入,读取数据库中的数据在ListCtrl中显示

使用IVX来创造一个自己的3D小游戏【后台和中台、React Core、three.js、Pixi.js、Krpano、antD......】

容器内部塞入gif动态图,容器里面基本上什么都能塞,可以动动小手尝试尝试奥,文末链接都已经准备好了。可以说变量是所有编程语言的关键,也可以将它们当作存储数据的容器。数组可以定位二维、三维坐标。

qq_46906413的博客 5288

RU DOS版、EFI版32bit/64bit BIOS常用工具

DOS版、EFI版的RU工具,可用来查看IO、MEM、PCI、SMBIOS等资源。亲测在EFI SHELL下可用。

迈瑞BS系列全自动生化分析仪LIS协议接口手册(内含HL7和ASTM)

迈瑞BS系列全自动生化分析仪LIS协议接口手册,内含HL7和ASTM)

探秘`wxgame-threejs`:在微信小游戏上构建3D世界的利器

探秘wxgame-threejs:在微信小游戏上构建3D世界的利器 项目简介 是一个开源项目,它让开发者能够在微信小游戏平台上利用Three.js库创建引人入胜的3D游戏和应用。Three.js是JavaScript的一个知名库,用于处理WebGL,使开发者能够轻松地在浏览器中创建三维图形。通过结合微信小游戏API与Three.js的强大功能,该项目为微信小游戏开发者提供了更广阔的创作空间。 技术...

gitblog_00013的博客 772

visio安装包

Microsoft Office Visio 是一款专业的制图软件。利用经过更新的形状、协作工具和数据链接图表,创建专业级图表以简化复杂的信息。

微信小程序3D开发革命:Three.js MiniProgram快速入门指南

想在微信小程序中实现惊艳的3D效果却苦于技术门槛太高?Three.js MiniProgram正是你寻找的解决方案!这个专为微信小程序环境优化的Three.js适配版本,让开发者能够在小程序中轻松构建沉浸式3D体验,无需从零学习复杂的WebGL API。 ## 🎯 为什么选择Three.js MiniProgram? 对于大多数开发者来说,微信小程序的3D开发一直是个难题。原生的WebGL

gitblog_01191的博客 465

分享53个微信游戏,总有一款适合您

龙潭老鼠,微信小游戏,1V1匹配赛马,前端cocos creator,后端netty,数据库Redi仿写微信跳一跳游戏,可以运行在所有 web 端用threejs写的模仿微信跳一跳游戏。功能丰富的微信机器人框架 AI对话、对接Dify、积分系统、游戏互动、每日新闻、天气查询。小游戏框架,基于Cocos Creator 集成某度,微信,头条等主要平台的接入。科沃兹H5游戏,微信端横版烧脑游戏,使用Cocos Creator制作。学习知识费力气,收集整理更不易。全名吃鸡微信小游戏 cocos creator。

weixin_47730343的博客 750

使用three-platformize实现跨平台3D互动体验:微信小程序实战

使用three-platformize实现跨平台3D互动体验:微信小程序实战 去发现同类优质开源项目:https://gitcode.com/ 本文将向您介绍一个精彩的开源项目:。这是一个基于Three.js和微信小程序的项目,旨在展示如何在微信小程序中创建高质量、交互式的3D场景。 项目简介 three-platformize-demo-wechat是一个实践性的教程和示例,它演示了如何将Thr...

gitblog_00031的博客 1762

Renovate 升级 Swift 依赖全解析:从 Package.swift 解析到 Package.resolved 锁文件同步

凌晨的值班群里,你的 Swift 仓库收到一条 Renovate 自动开出的 PR,描述写着 `from: 1.2.3 => 2.0.0`。清单里明明写的是 `from: "1.2.3"` 这种区间约束,为什么 PR 展示的不是"版本号 => 版本号",而是带着 `from:` 前缀?答案藏在 Renovate 处理 Swift Package Manager 依赖的整条链路里:先找到 `Pack

gitblog_00942的博客 349
上一篇: 微信小游戏开发之四:使用three.js引擎
下一篇: [小游戏资源] 微信小游戏开发资源目录
aifupi7268
博客等级 码龄11年 0粉丝 0原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符  | 博主筛选后可见
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值