key

Key管理设备按键事件

方法：

• addEventListener: 添加按键事件监听器
• removeEventListener: 移除按键事件监听器

对象：

• KeyType: 按键类型
• KeyEvent: 按键事件

回调方法：

• KeyEventCallback: 按键事件的回调函数

KeyType

按键类型

常量：

• "backbutton": (DOMString 类型 )设备“返回”按钮按键事件
  

  如果需要改变默认“返回”按钮的处理逻辑，则可通过plus.key.addEventListener来注册监听"backbutton"事件。

• "keydown": (DOMString 类型 )键按下事件
  

  如果需要改变默认键按下的处理逻辑，则可通过plus.key.addEventListener来注册监听"keydown"事件。 可通过回调函数中KeyEvent对象的keyCode来获取按下的键值。

• "keyup": (DOMString 类型 )键松开事件
  

  如果需要改变默认键松开的处理逻辑，则可通过plus.key.addEventListener来注册监听"keyup"事件。 可通过回调函数中KeyEvent对象的keyCode来获取松开的键值。

• "longpressed": (DOMString 类型 )长按键事件
  

  如果需要改变默认长按键的处理逻辑，则可通过plus.key.addEventListener来注册监听"longpressed"事件。 长按键时会多次触发回调函数，通过回调函数中KeyEvent对象的keyCode来获取长按的键值。

• "menubutton": (DOMString 类型 )设备“菜单”按钮按键事件
  

  如果需要改变默认“菜单”按钮的处理逻辑，则可通过plus.key.addEventListener来注册监听"menubutton"事件。

• "searchbutton": (DOMString 类型 )设备“搜索”按钮按键事件
  

  如果需要改变默认“搜索”按钮的处理逻辑，则可通过plus.key.addEventListener来注册监听"searchbutton"事件。

• "volumeupbutton": (DOMString 类型 )设备“音量+”按钮按键事件
  

  如果需要改变默认“音量+”按钮的处理逻辑，则可通过plus.key.addEventListener来注册监听"volumeupbutton"事件。

• "volumedownbutton": (DOMString 类型 )设备“音量-”按钮按键事件
  

  如果需要改变默认“音量-”按钮的处理逻辑，则可通过plus.key.addEventListener来注册监听"volumedownbutton"事件。

KeyEvent

按键事件

属性：

• keyCode: 触发按键事件的键值
• keyType: 按键事件类型

KeyEventCallback

按键事件的回调函数

void onKeyEvent( KeyEvent event ){
	// Event handled code.
	var key=event.keyCode; // 用户按键的键值
}
				

参数：

• event: ( KeyEvent ) 必选 监听用户按键操作返回的数据
  可通过event的keyCode属性（String类型）获取用户按键的类型，参考KeyType类型。

返回值：

void : 无