吐槽一下 Cocos Creator Api 文档 之 新手根本看不懂

作为一个Creator的新手,这个API确实有点难懂,首先API左侧列表没有分类简单介绍,对于新手来讲,不知道在什么时候去哪些分类里去找需要调用的那些API,最关键的是花大量的时间找到API后,下面只有简单一段文字,没有示例难以理解(不知道有多少小伙伴是学习Creator 5~6 遍还是啃不下来,原因都是在这里!)

举例说明吧,类似下图这个样子

新手以为直接调用cc.moveTo()就可以,根本就不会再次去调用runAction(),也不知道去调用,也不知道去什么地方找这个问题,一直一直在不断的修改代码,最后还是调试失败!

建议官方完善API文档

API名字
API功能简单介绍
API参数 类型 必填 参数简单介绍
API参数 类型 必填 参数简单介绍
API参数 类型 可空 参数简单介绍

API调用示例

API调用效果

API返回值

如果是这样一份的API文档,相信市面上会增加很多Creator的游戏,吐槽完毕!

http://docs.cocos.com/creator/manual/zh/scripting/actions.html 了解一下。

文档分为手册文档和API参考 举例 你要学动作系统的话建议先看手册文档里的动作系统介绍

这API文档就是工具生成的,没什么卵用,就看手册和源码

2赞

我难道不知道有手册文档吗?

我只是说个建议在api里面,加上简单完整的调用方法,这样学起来更方便,难道我要看一下api,然后在去看手册吗?

就你这智商。。弃坑吧。。

确实,新手比较难看懂,我当初就没看官网的api,全部都是搜索别人总结的东西。等慢慢熟悉了之后才敢看官方的api。

别这么直接 委婉一点:joy:

新手别抱怨太多了吧,学习工作了这几年,
我觉得cocoscreator的文档是新手引导做的最好的,
由于引擎版本更新迭代快,文档能跟上节奏已经很不错了。
通过文档,引擎模板和demo项目可以看出cocoscreator官方在努力降低门槛了
百度是最好的老师,如果不是,那就是谷歌。

3赞

hahha

确实,看过的文档里面还是cocos的最好,虽然也有一些问题,但是总的来说很不错了

个人建议,从文档入手学习,熟悉了之后,需要用什么可以直接查api,熟练了之后查阅起来就会很舒服

先看手册文档,然后看范例demo 不用全都看,看常用的就行了

虽然API文档对新手是很难看懂, 但是 creator 还是有适合新手看的入门文档啊。

你觉得有难度也是可以理解的,这是 Api 分块的锅, 全部塞到 cc 命名空间下了,基本没有分类。新手很难通过cc.xxxx 理解 这API是属于那一模块用的。如果api是这样的: cc.Action.moveTo() ,就不会理解偏差了。

当然放cc还是为了js写的方便 ,而现在要api大改一遍是不可能了。
你可以看看 Creator3d的API文档 ,在使用Ts 后,新设计的API合理多了。

1赞

你要是看过laya的文档,就会回来夸cocos文档了

u3d的文档看的也不爽啊

每次到了论坛大量萌新吐槽文档写的烂,才意识到自己又老了一年:14:
另外说一个,cocos的文档已经算很良心了,隔壁laya从头到尾瞎几把讲,按着他的文档hello world都写不出来

我觉得还好吧 不知道改怎么查 就不要查 估计是你不知道怎么用 所以还是去看教程吧 看视频会好点 刚开始我就是看视频的 :2: 但入门后发觉引擎部分其实不用记多少知识 现在的话, 我都是在ide里面直接看api的 方便的很:smirk:

用laya我只做了个打地鼠:2: 感觉还是没creator好用
egret我觉得是3大引擎中是最难用的

当时可能是跟选的语言有关?(当时看的是js文档),大概就在一年前吧,整个文档狗屁不通,让我输出hello world的脚本,发现根本不存在的,新建了对应的js脚本也不会输出。看了半天才发现指定输出的脚本就没对,坑的我一愣一愣的:2: