收集用户读 api 范例 文档 时遇到的问题

这个已经修复了,下次更新的话就是正确的了 :joy:

这个也修复了

:cold_sweat: 抱歉,写错了,会尽快修复

这个我会测试一下,如果是会修复

好的,辛苦了:wink:

应该的,这些会在下个更新都修复或者完善掉

animationClip里面的events属性

既然是个数组,这个写法看着有点不对吧?数组的元素是什么类型?看样子是对象类型,如果是对象类型,应该有大括号{}吧?

嗯,是错的
目前正确是

[
    { frame: 0, func: 'onAnimationEvent1', params:['param-1', 'param-2'] },
    { frame: 2, func: 'onAnimationEvent3', params:['param-1', 'param-2'] },
    { frame: 3, func: 'onAnimationEvent2', params:['param-1'] },
    // The second event at frame 3
    { frame: 3, func: 'onAnimationEvent4', params:['param-1'] },
    { frame: 4, func: 'onAnimationEvent4', params:['param-1'] }
]

还有个小建议哦,希望做cc.AnimationClip.createWithSpriteFrame的文档的时候,帧事件的创建和添加也做进去哦,我耗了十多分钟才知道怎么加事件,可能是我太笨了:joy:

这个会写在 scripting-animation 文档里面

好的,谢谢:watermelon:

我也遇到了这个问题

链接失效问题
比如说吧我想要查看vec2的具体属性


然后里边木有x,y这两个明显属于他的属性,然后我找到ValueType

里边依然没有我要的东西,但是我看到了里边有一个“定义于:url” 的链接

然后就是这个了,不光是这个 基本我找到的所有这种链接全部失效了。

我还有个疑惑例如:


明明moveBy传入是3个参数,可为什么实际使用时两个参数
cc.moveBy(持续时间,vec2对象);
这个语法我无法理解 是重载吗?cc.moveBy拥有多个重载用于接收不同的参数?
还是说vec2这个数参数会被解析成x,y坐标 然后自动填充了?

啊 我是第一次接触cocos所有有些地方不是很理解。

额,那个好像不是链接哦,而是你引擎目录下的地址

不是重载,只能说是模拟重载,这涉及到js语法方面的知识(arguments),函数的实参可以是动态的,也就是说如果你形参是两个的话,实参可以是任意个,然后在函数内部判断参数的个数,不同个数的参数执行不同的操作

比如你函数的形参定义是两个,实际只传入了一个参数,第二个参数就是undefined,这个时候就可以判断第二个参数的值,根据第二个参数的值来决定执行什么操作

如果形参是两个,实参是三个或者四个或者更多,可以通过arguments对象获得,

建议你去了解一下js的arguments

moveBy函数的原理是这样的,判断最后一个参数是不是undefined,如果是,代表只有两个参数,那么就把第二个参数当成一个对象,从这个对象里获取x和y的值,如果第三个参数不是undefined,就把第二个参数当成x的值,第三个参数当成y的值

所以你用两个参数也可以,三个参数也可以

那个,能提个小建议吗,关于API页面左侧这一栏
有时候想查一些东西的时候

点击之后,左边这一栏就切回初始页面去了

这样的话,有时候打开了函数页面却发现函数并不是我想要的(特别是我这种新手),或者说想要看一下其他的相关函数的时候,我就不得不重新在搜索框里重新输入一遍
或者换句话说,用户对自己的搜索结果的页面应该比这个初始页面跟感兴趣些吧…

发现个问题

文档里的内容

这里说加载进来的单个资源如果需要释放,可以调用cc.loader.releaseRes,releaseRes只能传入一个和loadRes相同的路径

我测试过后发现,我通过cc.loader.loadResAll加载的资源,我这边loadResAll是传入一个目录(“texture”),加载目录里的所有资源,然后我释放的时候是这样的cc.loader.releaseRes(“texture/1”)

我不知道是不是我钻牛角尖,还是我没有理解到,不知道loadRes和loadResAll在这里是否相同,但是我批量加载的资源也可以通过cc.loader.releaseRes来释放,并且参数和loadResAll的不一样(多了个资源名称应该算是不一样还是算一样?)

这里我不知道是因为没有loadResAll加载资源后释放的文档,还是loadRes的文档没有考虑到loadResAll

所以来发表下意见

如果是没有loadResAll加载资源后释放的文档,建议大神加一下

如果是loadRes的文档没有考虑到loadResAll,建议大神改一下

如果我的看法有错误,建议大神当我放了个屁:joy: