key
Key管理设备按键事件
方法：
- addEventListener: 添加按键事件监听器
- hideSoftKeybord: 隐藏软键盘
- setAssistantType: 设置辅助输入类型
- showSoftKeybord: 显示软键盘
- removeEventListener: 移除按键事件监听器
对象：
回调方法：
- KeyEventCallback: 按键事件的回调函数
权限：
5+功能模块（permissions）
{
// ...
"permissions":{
// ...
"Webview": {
"description": "窗口管理"
}
}
}
KeyType
按键类型
常量：
- "backbutton": (String
类型
)设备“返回”按钮按键事件
如果需要改变默认“返回”按钮的处理逻辑，则可通过plus.key.addEventListener来注册监听"backbutton"事件。
- "keydown": (String
类型
)键按下事件
如果需要改变默认键按下的处理逻辑，则可通过plus.key.addEventListener来注册监听"keydown"事件。 可通过回调函数中KeyEvent对象的keyCode来获取按下的键值。
- "keyup": (String
类型
)键松开事件
如果需要改变默认键松开的处理逻辑，则可通过plus.key.addEventListener来注册监听"keyup"事件。 可通过回调函数中KeyEvent对象的keyCode来获取松开的键值。
- "longpressed": (String
类型
)长按键事件
如果需要改变默认长按键的处理逻辑，则可通过plus.key.addEventListener来注册监听"longpressed"事件。 长按键时会多次触发回调函数，通过回调函数中KeyEvent对象的keyCode来获取长按的键值。
- "menubutton": (String
类型
)设备“菜单”按钮按键事件
如果需要改变默认“菜单”按钮的处理逻辑，则可通过plus.key.addEventListener来注册监听"menubutton"事件。
- "searchbutton": (String
类型
)设备“搜索”按钮按键事件
如果需要改变默认“搜索”按钮的处理逻辑，则可通过plus.key.addEventListener来注册监听"searchbutton"事件。
- "volumeupbutton": (String
类型
)设备“音量+”按钮按键事件
如果需要改变默认“音量+”按钮的处理逻辑，则可通过plus.key.addEventListener来注册监听"volumeupbutton"事件。
- "volumedownbutton": (String
类型
)设备“音量-”按钮按键事件
如果需要改变默认“音量-”按钮的处理逻辑，则可通过plus.key.addEventListener来注册监听"volumedownbutton"事件。
KeyEvent
按键事件
属性：
- keyCode: (Number
类型
)触发按键事件的键值
键值由各系统平台定义，一些特殊按键在不同的设备上可能存在差异。
- keyType: (KeyType
类型
)按键事件类型
用于表明触发此按键事件的类型，值为KeyType中定义的值。
KeyEventCallback
按键事件的回调函数
void onKeyEvent( KeyEvent event ){
// Event handled code.
var key=event.keyCode; // 用户按键的键值
}
参数：
- event:
(
KeyEvent
)
必选 监听用户按键操作返回的数据
可通过event的keyCode属性（String类型）获取用户按键的类型，参考KeyType类型。