CocosCreator手记02——Examples中文注释目录

CocosCreator1.5

引擎自带的Examples

任何游戏引擎的都会有一套例子库。用于展示引擎的功能和API的用法。

最近看CocosCreator引擎附带的例子库。目前来说这套Cocos系列引擎的最新版，很有诚意，对比老引擎。加入了很多新的内容。比如资源下载器装载器，各种布局管理工具。预制资源。网络库。碰撞系统。也预留了扩展接口。当然整个引擎也支持插件式扩展。

可惜的是，这份例子是1.5版的，但是没有演示1.5新加的功能，比如物理引擎，摄像机等。另外，个别例子需要对应平台才能跑，在有些平台跑不了。有些例子功能重复，或无法正确演示。但这些都是小问题。

对不熟悉Cocos引擎的策划和美术，我习惯于一般把例子程序打个包发过去让他们熟悉。而CocosCreator是现代游戏开发工具，基本上是全民皆兵，所有人都会上手，就直接上编辑器看好了。例子列表用的是英文列表，说明文字也不全，简单整理了一份中文注释目录，对策划和美术来说，应该有一定参考价值。

里面有些设计是参考Web开发，我并非Web开发者，用词可能不准确：）

E:. ├─01_graphics 图形 │  ├─01_sprite 精灵组件相关例子 │  │      AnchorPoint.fire  锚点 │  │      AtlasSprite.fire 图集使用 │  │      FilledSprite.fire 填充渲染模式 │  │      SimpleSprite.fire 普通渲染模式 │  │      SlicedSprite.fire 九宫格渲染模式 │  │      TiledSprite.fire 平铺渲染模式 │  │      TrimmedSprite.fire  图像资源的自动剪裁    │  │  │  ├─02_particle 粒子系统 │  │      AutoRemoveParticle.fire “完成时自动移除”功能 │  │      ToggleParticle.fire 切换粒子显示 │  │           │  └─03_texture_format 特殊图片格式 │          webp-test.fire webp格式（PC上Chrome可用，内含平台检测代码可供参考） │           ├─02_ui UI系统 │  ├─01_widget 对齐挂件（widget本意是小部件） │  │      AdvancedWidget.fire 高级挂件的定位演示（边缘停靠） │  │      AlignOnceWidget.fire AlignOnce属性（仅对齐一次） │  │      AnimatedWidget.fire 挂件动画 │  │      AutoResize.fire 挂件自动调整大小（该例子可能有问题，和Tips描述不一致） │  │      WidgetAlign.fire 挂件对齐，此例子似乎与 AdvancedWidget内容重复 │  │       │  ├─02_label 文本标签 │  │      AlignFontLabel.fire 文本对齐（使用系统字体） │  │      BitmapFontLabel.fire 位图字体标签 │  │      LabelAtlas.fire 图集标签（一般用于纯数字显示，比如伤害数字，一般是等宽字体） │  │      SystemFontLabel.fire 系统字体标签（界面类似BitmapFontLabel，字体跟AlignFontLabel一样） │  │           │  ├─03_button 按钮 │  │      ButtonInScroll.fire ScrollView上面的按钮 │  │      ButtonInteractable.fire 按钮的交互性演示（脚本+回调函数实现类似radiobutton的效果） │  │      SimpleButton.fire 普通按钮（演示按钮的基本属性，形状，变色，事件交互等功能） │  │       │  ├─04_progressbar 进度条 │  │      progressbar.fire 进度条 │  │           │  ├─05_scrollView 滚动视图 │  │      ListView.fire 列表视图 │  │      ScrollView.fire 滚动视图 │  │           │  ├─06_layout 布局容器 │  │  ├─Layout_None 普通布局 │  │  │      Layout_None_Basic.fire 基本布局 │  │  │      Layout_None_Grid.fire 网格布局 │  │  │      Layout_None_Horizontal_Vertical.fire 水平布局和垂直布局 │  │  │       │  │  ├─Layout_ResizeChildren 缩放子节点 │  │  │      Layout_ResizeChildren_Grid.fire 网格布局 │  │  │      Layout_ResizeChildren_Normal.fire 水平布局和垂直布局 │  │  │       │  │  ├─Layout_ResizeContainer 缩放容器 │  │  │      Layout_ResizeContainer_Basic.fire 基本布局 │  │  │      Layout_ResizeContainer_Grid.fire 网格布局 │  │  │      Layout_ResizeContainer_Normal.fire 水平布局和垂直布局 │  │  │       │  │  └─Layout_ScrollView 滚动视图 │  │          Layout_ScrollViewGrid.fire 网格布局 │  │          Layout_ScrollViewNormal.fire 基本布局 │  │           │  ├─07_change_canvas_anchor 改变canvas锚点 │  │      BottomLeftAnchor.fire 通过添加空节点来改变canvas锚点，适合很多对锚点有特别要求的游戏 │  │       │  ├─08_editBox 文本框 │  │      EditBox.fire 文本框类型演示（单行，密码，多行） │  │      EditBoxTabIndex.fire Tab键切换文本框焦点（仅web下有效） │  │           │  ├─09_videoplayer 视频播放器（不支持Mac和Windows，支持移动端和Web） │  │      fullscreenVideo.fire 全屏播放演示 │  │      videoPlayer.fire 各种控制功能演示（播放，暂停，全屏等） │  │           │  ├─10_webview web视图（不支持Mac和Windows，支持移动端和Web） │  │      webview.fire │  │       │  ├─11_richtext 富文本 │  │      RichText.fire 普通演示 │  │      RichTextEvent.fire 点击事件 │  │      RichTextImage.fire 图文混排 │  │       │  ├─12_slider 滑块 │  │      Slider.fire 水平滑块，垂直滑块 │  │           │  ├─13_toggle 切换开关 │  │      Toggle.fire CheckBox复选框，RadioBox单选框 │  │       │  ├─14_pageView 翻页视图 │  │      PageView_Free_Horizontal.fire 自由型，水平 │  │      PageView_Free_Vertical.fire 自由型，垂直 │  │      PageView_Unified_Horizontal.fire 统一型，水平 │  │      PageView_Unified_Vertical.fire 统一型，垂直 │  │           │  └─15_mask 遮罩（把被遮罩物拖到上层，容易看清原来的样子） │          Mask_ELLIPSE.fire 椭圆形 │          Mask_IMAGE_STENCIL.fire 图片模板 │          Mask_NESTED.fire 嵌套使用遮罩 │          Mask_RECT.fire 矩形 │               ├─03_gameplay 游戏性 │  ├─01_player_control 角色控制 │  │      DeviceMotion.fire 重力传感（只支持移动平台） │  │      KeyboardInput.fire 按键输入（监听按键的标准写法） │  │      OnMultiTouchInput.fire 多点触摸（只支持移动平台） │  │      OnTouchInput.fire 触摸 │  │           │  ├─02_actions 动作指令（动作指令例子较少，不过动作指令的内容基本没变化，可参考以前的资料） │  │      MoveAction.fire 移动 │  │      RepeatAction.fire 重复执行 │  │      RotationAction.fire 旋转 │  │      SimpleAction.fire 简单的动作（注意动作指令的调用方法有变） │  │           │  └─03_animation 动画 │          AnimateCustomProperty.fire 自定义动画属性（通过动画操作数值变化，通过脚本读取数值来设置显示） │          AnimationCallback.fire 动画回调（回调触发类型挺多的） │          AnimationEvent.fire 动画事件 │          CreateClip.fire 动态创建动画剪辑 │          MoveAnimation.fire 移动动画 │          SpriteAnimation.fire 精灵帧动画 │               ├─04_audio 音频 │      SimpleAudio.fire 简单的音频（AudioSource演示播放背景音乐，AudioEngine演示播放音效和audioClip的使用） │       ├─05_scripting 脚本 │  ├─01_properties 属性检查器 │  │      NodeArray.fire 节点数组 │  │      NonSerialized.fire 序列化与非序列化（通过编辑器设置变量和通过脚本设置变量的区别） │  │      ReferenceType.fire 引用类型（不用运行时演示） │  │      ValueType.fire 值类型（不用运行时演示） │  │       │  ├─02_prefab 预置资源 │  │      InstantiatePrefab.fire 实例化预置资源（使用脚本代码演示，复用编辑好的节点） │  │       │  ├─03_events 事件 │  │      EventInMask.fire 遮罩下的事件 │  │      SimpleEvent.fire 普通事件（点击，鼠标，自定义） │  │      TouchPropagation.fire 触摸事件冒泡（来自Web的相关概念） │  │       │  ├─04_scheduler Cocos2d-x中的计时器（不是js中的计时器） │  │      scheduler.fire（和cocos环境结合的更好，更容易获得上下文） │  │       │  ├─05_cross_reference 交叉引用 │  │      Cro***eference.fire （通过编辑器绑定参数和ES6箭头函数，演示两个节点交叉引用） │  │       │  ├─06_life_cycle 生命周期 │  │      life_cycle.fire （只是演示了一个带回调的action，和标题不太相符） │  │       │  ├─07_asset_loading 资产加载 │  │      AssetLoading.fire 资产加载（演示了很多类型的资产如何加载如何创建对象并显示，标准写法，比较有参考价值） │  │      LoadRes.fire 普通资产和预置资产的加载区别 │  │      LoadResDir.fire 按文件夹装载资产 │  │           │  ├─08_module 模块 │  │      load_module.fire 加载模块（加载图片和JSON数据，刷新怪物） │  │       │  ├─09_singleton 单例 │  │      Singleton.fire 一种单例写法（不用运行时演示） │  │       │  ├─10_loadingBar loading条 │  │      loadingBar.fire （配合cc.loader实现资产加载并显示在loading条） │  │       │  ├─11_network 网络（附带SocketIO插件） │  │      downloader.fire 下载器演示（下载txt和图片，不支持Web） │  │      network.fire （XMLHttpRequest，WebSocket，SocketIO演示） │  │       │  └─12_pool 对象池（一种封装好的快速开发对象，和Prefab配合，节约内存提高效率，不用自己手动实现） │          nodePool.fire （点击小怪物停止移动，再点继续移动，使用了unuse和reuse回调） │           ├─anysdk anysdk触控的第三方sdk接入解决方案（略） │      01_user.fire │      02_iap.fire │      03_share.fire │      04_ads.fire │      05_analytics.fire │      06_social.fire │      07_push.fire │      08_adtracking.fire │      09_crash.fire │      10_rec.fire │       │           ├─collider 碰撞系统 │      Category.fire 碰撞组演示 │      Hittest.fire 点击测试 │      platform.fire 跳台游戏演示 │      Shape.fire 不同形状碰撞组件（圆形，矩形，多边形） │      Shooter.fire 射击游戏演示（演示×××使用） │      Tag.fire 碰撞组件的Tag属性 │           ├─dragonbones 龙骨动画编辑器支持 │      DragonBones.fire 普通演示 │      DragonMesh.fire 网格动画 │       ├─graphics 几何绘图 │  ├─demo │  │      doodle.fire 涂鸦 │  │      sine-waves.fire 正弦波 │  │       │  └─example │          arc.fire 弧形 │          ellipse.fire 椭圆 │          linejoin.fire 参数很多，画线效果更好（这部分可参考HTML5Canvas画线） │          lineTo.fire 简单画线 │          rect.fire 矩形 │           ├─motionStreak 拖尾 │      MotionStreak.fire （只支持WebGL模式，但是似乎在哪个平台都无法显示） │           ├─native_call 本地调用（只支持Android） │      Native_Call.fire │           ├─spine Spine动画编辑器支持 │      SpineBoy.fire 普通演示 │      SpineMesh.fire 网格动画 │       └─tiledmap 瓦片地图         Puzzle.fire 迷宫游戏演示（渲染，碰撞，滚屏等）

最新消息是，官方沟通对于例子问题也很重视，有些小错误都会马上修复，关于例子，是有专门的Github仓库的，在主页上可以找到，不用等CCC发布新版本再拿