cocos / example-projects

Example project to guide users through how to create game with Cocos Creator

Cocos Creator 2.x 开发范例

本项目同时面向 Cocos Creator 引擎开发人员和最终用户，目的是建立一套贯穿开发、测试、学习使用的完整的功能范例。

项目结构

assets
  |--cases （范例场景和脚本存放位置）
  |    |--01_graphics （图像相关）
  |    |--02_ui（用户界面相关）
  |    |--03_gameplay（玩法相关）
  |    |--04_audio （音效效果）
  |    |--import（外部数据导入相关）
  |    |--data（用户数据处理）
  |--res（范例使用的资源）
  |   |--atlas（图集资源）
  |   |--font（字体）
  |   |--imported（外部导入资源）
  |   |--textures（贴图资源）
  |--scripts（公共脚本）

每一类范例里可以根据需要再次细分类别，每个范例首先要有一个场景文件，里面包括了范例功能的展示。

在范例场景所在目录下，放置所需要的脚本，外加一个和范例场景同名的md文件，里面是范例功能的使用说明。请参考已有的md文件来书写。

开发者要求

开发者在开发新功能时，请新建一个范例后使用范例作为功能展示和测试用途。在功能开发完成后，书写使用说明，以方便 QA 测试跟进，和最终用户及时准确的掌握用法。

场景名使用驼峰命名，文件夹名使用下划线分割。

范例说明索引

每篇说明文档都和范例场景同名，并且放在同一个目录下。

图像相关 Graphics

• 01_sprite

  • Simple Sprite
  • Atlas Sprite
  • Sliced Sprite

• 02_particle

  • Toggle Particle

界面相关 UI

• 01_widget 

  • Widget Align
  • Auto Resize

• 02_label

  • System Font Label

• 03_button

  • Simple Button

玩法相关 Gameplay

• 01_player_control

  • Keyboard Input
  • Touch Input

• 02_actions

  • Simple Action

• 03_animation

  • Sprite Animation

音效相关 Audio

• Simple Audio

example-projects's Issues

[Request] remove proj.android files for creator2.0

with this changes, cocos/engine-native#1352

those below should be removed for ant project and binary template removed

suggestion [Optional]

Since only one file AppActivity.java existed at build-templates dir, don't need to put both copy into jsb-default and jsb-link. Only one file, one copy is ok. copy it into different dir when build

please check this @jareguo

build-template should sync the changes with cocos2d-x-lite/template

when example-cases build native project, it used the template of cocos2d-x-lite, not those.

没有分包加载的案例吗

似乎没有龙骨动态加载的范例

http://forum.cocos.com/t/1-9-2-1-10-bug/66415

Require:

Require:

• #35
• #59

Reference:
https://vercel.com/design/snippet

Originally posted by @AntoineKM in tonightpass/kitchn#95

merge master to v2.0

合并场景

完善 downloader-web 范例

• 

---

• 

---

• 检查微信小游戏是否会有该问题
  

---

• 

https://github.com/cocos-creator/fireball/issues/8352
https://github.com/cocos-creator/fireball/issues/8351
https://github.com/cocos-creator/fireball/issues/8350
https://github.com/cocos-creator/fireball/issues/8345

TypeError: Cannot read property 'WebSocket' of undefined on cocos creator 1.8.0

I encountered this problem after exporting the project, and run on 微信开发者工具 v1.02.1801081

场景跳转但是没有资源加载

若利用 search 进行场景跳转有概率出现资源场景内不加载资源问题，同时重新回到 TestList 场景再次跳转（无论何种方式）该场景都没有加载资源显示内容

。

2.4.3你们打开不报错吗

集合范例点运行报错 creator v1.1.2

TypeError: Cannot read property 'LineJoin' of undefined
at Object.require.linejoin: "let LineJoin = cc.Graphics.LineJoin" (assets/cases/graphics/example/linejoin.js:1)
at s (../../../../../../Applications/CocosCreator.app/Contents/Resources/app.asar/node_modules/browser-pack/_prelude.js:1)
at e (../../../../../../Applications/CocosCreator.app/Contents/Resources/app.asar/node_modules/browser-pack/_prelude.js:1)
at file:///Users/lianghangbing/CocosJsProj/example-cases/library/bundle.project.js?001:1:451

Suggestion: Deploy example-cases to gh-pages.

It is convenient for users to view cases online.
How about deploying example-cases to gh-pages?

关于网络通信部分不理解，能搞一个基于socket.io的聊天室吗？

有登录界面
进去后就是聊天界面

missing script

i just clone and open, then get warning

Script attached to "mask" in scene "TestList.fire" is missing or invalid. Detailed information:
Node path: "Menu/readme/mask"
Asset url: "db://assets/TestList.fire"

Not working

Examples not working properly.

1. Test List displaying blank items (with no text).
2. Everything is in Chinese.
3. Instructions section not displaying text.
4. No documentation

示例中部分类与函数未更新至ccc2.0

如示例 03_gameplay/OnTouchCtrl.js 中有关二维向量的函数

为什么没有注释啊！

cases/02_ui/03_button/ButtonInScroll.fire 报错

点击Play按钮时报错：

co

ReferenceError: dragonBones is not defined

ReferenceError: dragonBones is not defined
at Object.require.DragonBonesCtrl: "requireComponent: dragonBones.ArmatureDisplay" (assets/cases/dragonbones/DragonBonesCtrl.js:20:8)
at s (../../../../../../Applications/CocosCreator.app/Contents/Resources/app.asar/node_modules/browser-pack/_prelude.js:1)
at e (../../../../../../Applications/CocosCreator.app/Contents/Resources/app.asar/node_modules/browser-pack/_prelude.js:1)
at file:///Users/footprint/Downloads/example-cases-master/library/bundle.project.js?001:1:451

有没有开源的项目代码可供下载学习？

这个例子对新手有点不友好...

新建项目时候有这个项目，但在本地并不知道怎么跑起来--

Crushed on Android app 2.2.1

12-12 10:02:03.773 642 676 E InputDispatcher: channel '960d932 org.cocos2d.examplecases/org.cocos2dx.javascript.AppActivity (server)' ~ Channel is unrecoverably broken and will be disposed!

example-02/09_videoPlayer 展示的当前视频状态与 online video 不符合

相关 https://github.com/cocos-creator/fireball/issues/8006

没有ts版本么？

1.91 版本运行报错啊

downloader.js:70 GET http://localhost:7456/preview-scripts/assets/cases/anysdk/08_adtracking/AdTracking.js 0 ()

研发场景合并工具

运行机制，参考 https://docs.unity3d.com/Manual/SmartMerge.html

增加截屏 example

每个平台截屏方法可能不一样。
需要对原生、小游戏、Web 平台分别开发。
开发完后，修改 FAQ 里的这部分内容，引导用户直接看范例

VideoPlayerCtrl `onVideoPlayerEvent` CLICKED 事件需要判断是否全屏

如果全屏状态, 无法暂停.

        if (event === cc.VideoPlayer.EventType.CLICKED) {
            if (!this.videoPlayer.isFullscreen) {   // <------ 需要加此判断
                if (this.videoPlayer.isPlaying()) {
                    this.videoPlayer.pause();
                } else {
                    this.videoPlayer.play();
                }
            }
        }

07_render_texture/render_to_canvas.js Uncaught TypeError: texture.initWithSize is not a function

想实现截图功能，用到这里的案例，但是报 texture.initWithSize is not a function

Max steel

It's going to be like subway surfers like the picture of the film Max steel their is going to be steel their and beast their

将所有范例的 Background Prefab 节点设置为自动同步

目前是手动同步的，其实 TestList 中的背景色已经调整过了。不过其它范例都没变，要一个一个改过去吗…… 疯了。还是用自动同步吧，这样以后换背景的时候就不用重新设置。

提交到 v2.0，记得提交后提醒所有人更新一下仓库，免得造成冲突

co

there is no example about camera

please add a example about camere

[完善] 过滤 example-cases 中所有范例并且进行完善

在 2.0 分支上进行改进完善

• 补充例用 TTF 字体展示 Label 测试。
• 剔除没用的代码（之前做 tips 有遗留了一些多余的代码）
• 添加远程加载音频的范例 用户反馈传送门
• 添加动态加载 spine 范例 用户反馈传送门

webview 测试例初始时 Label 显示的状态与实际不符

在桌面端 Chrome 浏览器验证，刚打开 webview 测试例，窗口白框（状态应该是正在加载），显示的却是 Loaded

可以升级此项目为3.x的版本吗

想学习下3.x的用法

Import from Spine Pro

Hi!

I only found this old documentation on how to import spine animation:
https://github.com/cocos-creator/deprecated-examples/blob/master/guides/components/spine_skeleton.md

Is this now officially supported?
I found spineBoy png, json and atlas file in this repository, is this a valid and working example now (beginning fo 2019)

Thank you @nantas @walzer @pandamicro @zilongshanren

co

Readme Links

Most cases links in the readme are broken.

加入安全区域使用范例

参考 Cocos2d-x 的测试例，增加 getSafeArea 的使用范例

API 从 2.0 修改了，现在是 cocos/engine-native#1502

改善 example-cases 列表上如果有不支持的范例直接禁用按钮并提示用户不支持

太不友好了

程序报错，跑不起来
Cannot read property 'loadRes' of undefined