├── .cocos-project.json
├── .gitignore
├── LICENSE
├── README.md
├── frameworks
├── cocos2d-js-v3.3.full.js
└── cocos2d-js-v3.3.js
├── index.html
├── main.js
├── project.json
├── res
├── AltarScene.json
├── AltarScene
│ ├── LV9_4.png
│ ├── bg_tree01.png
│ ├── bg_tree02.png
│ ├── bg_tree03.png
│ ├── guard01.png
│ ├── guard02.png
│ ├── lv1-1.PNG
│ ├── lv10_3.png
│ ├── lv10_5.png
│ ├── lv10_chengqiang.png
│ ├── lv10_fangzi.png
│ ├── lv10_fangzi_down.png
│ ├── lv10_tielian.png
│ ├── lv1qiang.png
│ ├── lv2-1.PNG
│ ├── lv2-2.PNG
│ ├── lv2_3.png
│ ├── lv3-1.png
│ ├── lv3_1(lv4_1).png
│ ├── lv4-1.png
│ ├── lv5-1.png
│ ├── lv5_1.png
│ ├── lv6_1.png
│ ├── lv9_1.png
│ └── staging.png
├── Common
│ ├── Cn16.png
│ ├── Cn17.png
│ └── Cn19.png
├── Default
│ ├── Button_Disable.png
│ └── defaultParticle.plist
├── DifficultySelection.json
├── DifficultySelection
│ ├── DS01.png
│ ├── DS02.png
│ ├── DS03.png
│ ├── DS05.png
│ ├── DS07.png
│ ├── DS08.png
│ ├── DS09.png
│ ├── DS10.png
│ ├── DS11.png
│ ├── DS12.png
│ ├── DS13.png
│ ├── DS15.png
│ └── DS16.png
├── MainMenu.json
├── MainMenu
│ ├── MM01.png
│ ├── MM02.png
│ ├── MM03.png
│ ├── MM04.png
│ ├── MM05.png
│ ├── MM06.png
│ ├── MM07.png
│ ├── MM08.png
│ ├── MM09.png
│ ├── MM10.png
│ ├── MM12.png
│ ├── MM13.png
│ ├── MM14.png
│ ├── MM15.png
│ ├── MM16.png
│ ├── MM17.png
│ ├── MM18.png
│ ├── MM19.png
│ ├── MM20.png
│ ├── MM21.png
│ ├── MM22.png
│ ├── MM23.png
│ └── MM24.png
├── MainScreen.json
├── PlayerStats.json
└── finger.png
└── src
├── guideConfig.js
├── lib
├── Guide.js
├── UILoader.js
└── async.js
├── resource.js
└── ui
└── MainScreen.js
/.cocos-project.json:
--------------------------------------------------------------------------------
1 | {
2 | "has_native": true,
3 | "project_type": "js"
4 | }
--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------
1 | .idea/
2 | *.DS_Store
3 |
--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
1 | The MIT License (MIT)
2 |
3 | Copyright (c) 2015 ShawnZhang2015
4 |
5 | Permission is hereby granted, free of charge, to any person obtaining a copy
6 | of this software and associated documentation files (the "Software"), to deal
7 | in the Software without restriction, including without limitation the rights
8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9 | copies of the Software, and to permit persons to whom the Software is
10 | furnished to do so, subject to the following conditions:
11 |
12 | The above copyright notice and this permission notice shall be included in all
13 | copies or substantial portions of the Software.
14 |
15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21 | SOFTWARE.
22 |
23 |
--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
1 | sz.Guide
2 | ========
3 |
4 | cocos2d-js游戏简单引导框架
5 |
6 | ##在线演示
7 | www.ixuexie.com/Guide/index.html
8 |
9 | ## 博客教程
10 |
11 | [一、原理和框架](http://blog.csdn.net/6346289/article/details/44001005)
12 | [二、定位器细节](http://blog.csdn.net/6346289/article/details/44150147)
13 | [三、框架分析](http://blog.csdn.net/6346289/article/details/44586595)
14 | [四、使用方法](http://blog.csdn.net/6346289/article/details/44745771)
15 |
16 | ## 快速使用
17 |
18 | ### 创建引导层
19 | ```javascript
20 | //在Layer的onEnter时创建引导层对象(sz.GuideLayer)
21 | onEnter: function() {
22 | this._super();
23 | //guideConfig 为引导配置对象
24 | new sz.GuideLayer(this, guideConfig);
25 | }
26 | ```
27 | ### 引导配置
28 |
29 | 导引配置主要是编写**引导任务**, 引导任务可能由1个或多个引导步骤组成。当任务中的步骤全部完成sz.Guide会自动保存进度。
30 | ```javascript
31 | tasks = {
32 | '任务1':[
33 | //任务数组中，每一个对象为一个step
34 | {
35 | log: '用于调试日志字符串',
36 | //引导指令：手型提示
37 | command: sz.GuideCommand.GC_FINGER_HINT,
38 | //定位器
39 | locator:'定位器字符串，一般为节点的Name'
40 | }
41 | ],
42 | '任务2':[...]
43 | '任务3':[...]
44 | }
45 | ```
46 |
47 | ###定位器语法
48 | ```javascript
49 | “/” ：名字（name）定位符，例如： ‘a/b/c’ 、’dialogLayer/_closeButton’
50 | “#”：tag（id）定位符，例如：’a#123’
51 | “.”：变量名（var）定位符，例如：’a._okButton’
52 | “>”：子节点（child）定位符，例如：’a>c’
53 | ```
54 |
55 | ###创建引导
56 | 之前使用new sz.Guide(this, config);会自动将引导层添加到第一个参数（target）上。
57 | 新的用法需要自己将创建出的引导层添加到一个节点上：
58 | ```javascript
59 | var guide =new sz.Guide(this, config);
60 | cc.director.getRunningScene().addChild(guide);
61 | ```
62 |
63 | ###自动引导
64 | 新增自动引导功能通过isAutoGuide开启，主要用于开发测试，需要注意**自动引导期间不能随便移动鼠标**
65 | ```javascript
66 | guideConfig = {
67 | tasks:{...}, //引导任务
68 | fingerImage:'res/finger.png',//手型图片
69 | isShowMask: false, //是否开启遮罩
70 | isAutoGuide: true //是否自动引导
71 | }
72 | ```
73 |
74 |
75 | 参请见代码guideConfig.js文件
--------------------------------------------------------------------------------
/index.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 | Hello Cocos2d-JS
6 |
7 |
17 |
18 |
26 |
27 |
28 |
29 |
30 |
31 |
32 |
33 |
34 | sz.Guide是基于 cocos2d-js 实现的一个简易的新手引导框架，使用json配置文件就能方便编写游戏引导。
35 | sz.Guide库githut源码地址
36 |
37 |
38 |
39 |
40 |
41 |
42 |
43 |
44 |
45 |
46 |
47 |
48 |
49 |
50 |