dh360 / cocos-creator-joystick

Cocos Creator Joystick Demo 虚拟摇杆

cocos-creator-joystick

Cocos Creator 虚拟摇杆样例

中文文档 | English Docs

在线预览: https://yunyoujun.github.io/cocos-creator-joystick/

使用

通过文件导入

下载 dist/joystick-demo.zip 并通过 Cocos Creator 导入。

Cocos Creator v2.x -> 文件 -> 资源导入...

通过 Git

git clone https://github.com/YunYouJun/cocos-creator-joystick.git

将其作为项目，通过 Cocos Creator v2.x 打开。

你可以在 demo 场景中查看样例。

功能

• 虚拟摇杆类型
  • 固定
  • 跟随
• 玩家
  • 旋转
  • 移动
• 触摸感应位置
  • 全屏感应
  • 半屏
  • 只感应 Joystick 所在范围

虚拟摇杆

属性	类型	默认值	描述	可自定义
joystickType	JoystickType.FIXED / JoystickType.FOLLOW	JoystickType.FIXED	虚拟摇杆类型	√
player	cc.Node	-	挂载要控制的玩家节点	√
ring	cc.Node	-	摇杆背景节点	√
dot	cc.Node	-	摇杆操纵点	√

玩家

属性	类型	默认值	描述	由虚拟摇杆控制	可自定义
moveDir	Vec2	cc.v2(0, 1) // 竖直向上	初始移动方向	√	√
_speedType	SpeedType.STOP / SpeedType.NORMAL / SpeedType.FAST	SpeedType.NORMAL	速度类型	√	×
_moveSpeed	cc.Integer	0	移动速度	×	×
stopSpeed	cc.Integer	0	停止时速度	×	√
normalSpeed	cc.Integer	100	正常速度	×	√
fastSpeed	cc.Integer	200	加快时速度	×	√

项目结构

逻辑文件均位于 assets/script 目录下

文件名	描述	功能
Joystick.js	虚拟摇杆脚本文件	存储 Joystick 主逻辑
JoystickCommon.js	公用变量文件	存储公用类型定义
Player.js	玩家脚本文件	挂载于玩家节点上，包含玩家必要属性。（可根据需要自行修改）
UI.js	UI	提供在线预览页面，玩家切换摇杆类型功能。（不需要可直接删除）

其他

欢迎 Star, Issues, Pull requests 。

开发

构建

npm run build

部署

npm run deploy