Files
hexo-blog/source/_posts/egret粒子系统官方文档的那些坑.md
T
2020-11-25 10:27:30 +08:00

83 lines
3.4 KiB
Markdown

---
title: egret粒子系统官方文档的那些坑
id: '200'
categories:
- 分享
tags:
- egret
- 粒子系统
- RES
date: 2017-10-20 16:33:15
---
最近体验了一下[egret粒子系统](http://edn.egret.com/cn/article/index/id/178), 看了官方文档后,照着文档写,发现各种报错,不知道是原来文档就是错误的,还是egret版本多次迭代后,文档没有及时更新,而且在[egret开发者中心](http://developer.egret.com/)提供的QQ群加了也没有回应,或许是egret官方太忙了,但是不管怎样,这种错误的官方文档对新手很不友好。
下面我来说说我在体验[egret粒子系统](http://edn.egret.com/cn/article/index/id/178)踩的一些坑
说到egret的粒子系统,egret官方提供了一个制作粒子素材的工具——[Egret Feather](http://developer.egret.com/cn/github/egret-docs/tools/Feather/manual/index.html)
有兴趣的可以移步到相关的官方文档查看,因为我使用[Egret Feather](http://developer.egret.com/cn/github/egret-docs/tools/Feather/manual/index.html)的时候没有遇到什么问题,所以这里就不做赘述了,大家看官方文档就好了
### egret粒子系统官方文档的错误?
在egret的粒子系统文档中([传送门](http://edn.egret.com/cn/article/index/id/178)),在创建粒子示例的地方是这样的
![egret粒子系统创建示例](https://image.dengtongyu.com/blog/2017/10/QQ截图20171020160019.png)
按照示例的代码在egret 4.0.3版本中,编译就会报错
```
error TS2339: Property 'system' does not exist on type 'Main'.
```
'system'这个属性不属于'Main',新人们在这里会懵逼一会儿,但是代码是死的,人是活的,我直接用个变量来保存particle对象嘛。我把代码改一下
```
let texture = RES.getRes("funny");
let config = RES.getRes("funny_json");
let funny = new particle.GravityParticleSystem(texture, config);
funny.start();
this.addChild(funny);
```
我用个变量funny来保存particle对象,然后我再编译一下,没有报错,但是刷新浏览器的时候报错了
```
Uncaught TypeError: Cannot read property 'textureWidth' of null
```
无法读取纹理的宽度,其值为null。出现这种报错一般就是纹理加载不成功,所以要看看加载素材的地方
```
let texture = RES.getRes("funny");
let config = RES.getRes("funny_json");
```
上面的纹理加载很明显与egret的素材加载方式有点不一样,不知道官方文档为什么会这样写,所以我改了一下,把纹理的后缀加上
```
let texture = RES.getRes("funny_png");
let config = RES.getRes("funny_json");
```
编译没有报错,刷新浏览器,粒子效果完美呈现。[demo传送门](https://demo.dengtongyu.com/featherfunuy/)
![egret粒子系统demo](https://image.dengtongyu.com/blog/2017/10/下载.png)
### egret粒子系统库的引入,另一个坑?
egret粒子系统库的引入也是一个小坑,我从[egret第三方库的GitHub](https://github.com/egret-labs/egret-game-library)上下载了particle粒子库,然后放到项目里引入,结果编译时间很久,而且会各种报错,经过一系列的Google 百度后,结果是:
**第三方库必须放到项目外面!**
**第三方库必须放到项目外面!**
**第三方库必须放到项目外面!**
重要的事情说三遍