玩家输入事件

本篇教程，我们将介绍 Cocos Creator 的玩家输入事件。

目前支持了以下几种事件：

• 键盘事件
• 鼠标事件
• 触摸事件
• 设备重力传感事件

注意：目前已经不建议直接使用 cc.eventManager 来注册任何事件，cc.eventManager 的用法也不保证持续性，有可能随时被修改

如何定义输入事件

除了键盘、设备重力传感器事件是通过函数cc.systemEvent.on(type,callback,target)注册以外 其他的例如：鼠标事件与触摸事件请参考系统内置事件。

可选的type类型有:

1. cc.SystemEvent.EventType.KEY_DOWN (键盘按下)
2. cc.SystemEvent.EventType.KEY_UP (键盘释放)
3. cc.SystemEvent.EventType.DEVICEMOTION (设备重力传感)

键盘事件

• 事件监听器类型：cc.SystemEvent.EventType.KEY_DOWN和cc.SystemEvent.EventType.KEY_UP
• 事件触发后的回调函数：
  • 自定义回调函数：callback(event);
• 回调参数：
  • KeyCode:API 传送门
  • Event：API 传送门

cc.Class({
    extends: cc.Component,onLoad: function () {
        // add key down and key up event
        cc.systemEvent.on(cc.SystemEvent.EventType.KEY_DOWN,sans-serif; box-sizing: border-box; font-weight: bold;">this.onKeyDown,sans-serif; box-sizing: border-box; font-weight: bold;">this);
        cc.systemEvent.on(cc.SystemEvent.EventType.KEY_UP,sans-serif; box-sizing: border-box; font-weight: bold;">this.onKeyUp,sans-serif; box-sizing: border-box; font-weight: bold;">this);
    },destroy () {
        cc.systemEvent.off(cc.SystemEvent.EventType.KEY_DOWN,sans-serif; box-sizing: border-box; font-weight: bold;">this);
        cc.systemEvent.off(cc.SystemEvent.EventType.KEY_UP,onKeyDown: function (event) {
        switch(event.keyCode) {
            case cc.KEY.a:
                'Press a key');
                break;
        }
    },onKeyUp: 'release a key');
                break;
        }
    }
});

鼠标事件

• 事件监听器类型：cc.EventListener.MOUSE
• 事件触发后的回调函数：
  • 鼠标按下：onMouseDown(event);
  • 鼠标释放：onMouseUp(evnet);
  • 鼠标移动：onMouseMove(evnet);
  • 鼠标滚轮：onMouseScroll(evnet);
• 回调参数：
  • Event：API 传送门

// 添加鼠标事件监听器
var listener = {
    event: cc.EventListener.MOUSE,onMouseDown: function (event) {
        cc.log('Mouse Down: ' + event);
    },onMouseUp: 'Mouse Up: ' + event);
    }，
    onMouseMove: event) {
       cc.log('Mouse Move: ' + event);
    }
    onMouseScroll: 'Mouse Scroll: ' + event);
    }
}
// 绑定鼠标事件
cc.eventManager.addListener(listener,this.node);

单点触摸事件

• 事件监听器类型：cc.EventListener.TOUCH_ONE_BY_ONE
• 事件触发后的回调函数：
  • 触摸开始：onTouchBegan(touches,event);
  • 触摸移动时：onTouchMoved(touches,event);
  • 触摸结束时：onTouchEnded(touches,event);
  • 取消触摸：onTouchCancelled(touches,event);
• 回调参数：
  • Touches: 触摸点的列表，单个TouchAPI 传送门
  • Event：API 传送门

注意：onTouchBegan回调事件里要return true， 这样后续的onTouchEnded和onTouchMoved才会触发事件。

// 添加单点触摸事件监听器
var listener = {
    event: cc.EventListener.TOUCH_ONE_BY_ONE,onTouchBegan: touches,event) {
        cc.log('Touch Began: ' + event);
        return true; //这里必须要写 return true
    },onTouchMoved: 'Touch Moved: ' + event);
    }，
    onTouchEnded: 'Touch Ended: ' + event);
    }
    onTouchCancelled: 'Touch Cancelled: ' + event);
    }
}
// 绑定单点触摸事件
cc.eventManager.addListener(listener,136); font-weight: bold;">this.node);

多点触摸事件cc.EventListener.TOUCH_ALL_AT_ONCE

事件触发后的回调函数：

• 触摸开始：onTouchesBegan(touches,event);
• 触摸移动时：onTouchesMoved(touches,event);
• 触摸结束时：onTouchesEnded(touches,event);
• 取消触摸：onTouchesCancelled(touches,sans-serif; font-size: 16px; line-height: 25.6px;">同理：onTouchesBegan回调事件里也要onTouchesEnded和onTouchesMoved才会触发事件。

  // 添加多点触摸事件监听器
  var listener = {
      event: cc.EventListener.TOUCH_ALL_AT_ONCE,onTouchesBegan: // touches 触摸点的列表
          cc.log('Touch Moved: ' + event);
      }，
      onTouchesEnded: 'Touch Ended: ' + event);
      }
      onTouchesCancelled: // 绑定多点触摸事件
  cc.eventManager.addListener(listener,136); font-weight: bold;">this.node);