# key

Key管理设备按键事件

## 方法：

- addEventListener: 添加按键事件监听器
- hideSoftKeybord: 隐藏软键盘
- setAssistantType: 设置辅助输入类型
- showSoftKeybord: 显示软键盘
- removeEventListener: 移除按键事件监听器

## 对象：

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

## 回调方法：

- 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类型。

## 返回值：

void : 无