diff --git a/zh-cn/application-dev/reference/apis/js-apis-inputconsumer.md b/zh-cn/application-dev/reference/apis/js-apis-inputconsumer.md old mode 100644 new mode 100755 index 1c5c6506447b5d8697c25df26fa6483fa7d58192..60d5fdca087871335471341d8cca934fc527cebb --- a/zh-cn/application-dev/reference/apis/js-apis-inputconsumer.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inputconsumer.md @@ -18,35 +18,35 @@ import inputConsumer from '@ohos.multimodalInput.inputConsumer'; ## inputConsumer.on -on(type: "key", keyOption: KeyOption, callback: Callback<KeyOption>): void +on(type: "key", keyOptions: KeyOptions, callback: Callback<KeyOptions>): void -开始监听组合按键事件, 当满足条件的组合按键输入事件发生时，将KeyOption回调到入参callback表示的回调函数上。 +开始监听组合按键事件, 当满足条件的组合按键输入事件发生时，将KeyOptions回调到入参callback表示的回调函数上。 **系统能力：** SystemCapability.MultimodalInput.Input.InputConsumer **参数：** -| 参数 | 类型 | 必填 | 说明 | +| 参数 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | -| type | string | 是 | 监听输入事件类型，只支持“key”。 | -| keyOption | [KeyOption](#keyoption) | 是 | 组合键选项，用来指定组合键输入时应该符合的条件。 | -| callback | Callback<KeyOption> | 是 | 回调函数。当满足条件的按键输入产生时，回调到此函数，以传入的keyOption为入参。 | +| type | string | 是 | 监听输入事件类型，只支持“key”。 | +| keyOptions | [KeyOptions](#keyoption) | 是 | 组合键选项，用来指定组合键输入时应该符合的条件。 | +| callback | Callback<KeyOptions> | 是 | 回调函数。当满足条件的按键输入产生时，回调到此函数，以传入的keyOptions为入参。 | **示例：** ``` -let keyOption = {preKeys: [], finalKey: 3, isFinalKeyDown: true, finalKeyDownDuration: 0} -let callback = function(keyOption) { - console.info("preKeys: " + keyOption.preKeys, "finalKey: " + keyOption.finalKey, - "isFinalKeyDown: " + keyOption.isFinalKeyDown, "finalKeyDownDuration: " + keyOption.finalKeyDownDuration) +let keyOptions = { preKeys: [], finalKey: 3, isFinalKeyDown: true, finalKeyDownDuration: 0 } +let callback = function (keyOptions) { + console.info("preKeys: " + keyOptions.preKeys, "finalKey: " + keyOptions.finalKey, + "isFinalKeyDown: " + keyOptions.isFinalKeyDown, "finalKeyDownDuration: " + keyOptions.finalKeyDownDuration) } -inputConsumer.on('key', keyOption, callback); +inputConsumer.on('key', keyOptions, callback); ``` ## inputConsumer.off -off(type: "key", keyOption: KeyOption, callback: Callback<KeyOption>): void +off(type: "key", keyOptions: KeyOptions, callback: Callback<KeyOptions>): void 停止监听组合按键事件。 @@ -54,33 +54,33 @@ off(type: "key", keyOption: KeyOption, callback: Callback<KeyOption>): voi **参数：** -| 参数 | 类型 | 必填 | 说明 | +| 参数 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | -| type | string | 是 | 监听输入事件类型，只支持“key”。 | -| keyOption | [KeyOption](#keyoption) | 是 | 开始监听时传入的KeyOption。 | -| callback | Callback<KeyOption> | 是 | 开始监听时与KeyOption一同传入的回调函数 。 | +| type | string | 是 | 监听输入事件类型，只支持“key”。 | +| keyOptions | [KeyOptions](#keyoption) | 是 | 开始监听时传入的KeyOptions。 | +| callback | Callback<KeyOptions> | 是 | 开始监听时与KeyOptions一同传入的回调函数 。 | **示例：** ``` -let keyOption = {preKeys: [], finalKey: 3, isFinalKeyDown: true, finalKeyDownDuration: 0} -let callback = function(keyOption) { - console.info("preKeys: " + keyOption.preKeys, "finalKey: " + keyOption.finalKey, - "isFinalKeyDown: " + keyOption.isFinalKeyDown, "finalKeyDownDuration: " + keyOption.finalKeyDownDuration) +let keyOptions = { preKeys: [], finalKey: 3, isFinalKeyDown: true, finalKeyDownDuration: 0 } +let callback = function (keyOptions) { + console.info("preKeys: " + keyOptions.preKeys, "finalKey: " + keyOptions.finalKey, + "isFinalKeyDown: " + keyOptions.isFinalKeyDown, "finalKeyDownDuration: " + keyOptions.finalKeyDownDuration) } -inputConsumer.off('key', keyOption, callback); +inputConsumer.off('key', keyOptions, callback); ``` -## KeyOption +## KeyOptions 组合键输入事件发生时，组合键满足的选项。 **系统能力：** 以下各项对应系统能力均为SystemCapability.MultimodalInput.Input.InputConsumer - | 参数 | 类型 | 必填 | 说明 | +| 参数 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | -| preKeys | Array | 是 | 组合键前置按键集合，可为空，前置按键无顺序要求。 | -| finalKey | Number | 是 | 组合键最后按键，不能为空。 | -| isFinalKeyDown | boolean | 是 | 组合键最后按键是按下还是抬起，默认是按下。 | -| finalKeyDownDuration | Number | 是 | 组合键最后按键按下持续时长，默认无时长要求。 | +| preKeys | Array | 是 | 组合键前置按键集合，可为空，前置按键无顺序要求。 | +| finalKey | Number | 是 | 组合键最后按键，不能为空。 | +| isFinalKeyDown | boolean | 是 | 组合键最后按键是按下还是抬起，默认是按下。 | +| finalKeyDownDuration | Number | 是 | 组合键最后按键按下持续时长，默认无时长要求。 | diff --git a/zh-cn/application-dev/reference/apis/js-apis-inputdevice.md b/zh-cn/application-dev/reference/apis/js-apis-inputdevice.md old mode 100644 new mode 100755 index 22ef7bafa7b997b600fc00721aa1a333c73cf8a2..aa8968d7c778b593e9b15e81b87d712152efc46d --- a/zh-cn/application-dev/reference/apis/js-apis-inputdevice.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inputdevice.md @@ -165,11 +165,18 @@ export default { **系统能力：** 以下各项对应的系统能力均为SystemCapability.MultimodalInput.Input.InputDevice -| 名称 | 参数类型 | 说明 | -| ------- | -------------------------------------- | ---------------------------------------- | -| id | number | 输入设备的唯一标识，同一个物理设备反复插拔，其设备id会发生变化。 | -| name | string | 输入设备的名字。 | -| sources | Array<[SourceType](#sourcetype)> | 输入设备支持的源类型。比如有的键盘上附带触摸板，则此设备有keyboard和touchpad两种输入源。 | +| 名称 | 参数类型 | 说明 | +| ---------- | -------------------------------------- | ------------------------------------------------------------ | +| id | number | 输入设备的唯一标识，同一个物理设备反复插拔，其设备id会发生变化。 | +| name | string | 输入设备的名字。 | +| sources | Array<[SourceType](#sourcetype)> | 输入设备支持的源类型。比如有的键盘上附带触摸板，则此设备有keyboard和touchpad两种输入源。 | +| axisRanges | Array<[axisRanges](#axisrange)> | 输入设备的轴信息。 | +| bus | number | 输入设备的总线类型。 | +| product | number | 输入设备的产品信息。 | +| vendor | number | 输入设备的厂商信息。 | +| version | number | 输入设备的版本信息。 | +| phys | string | 输入设备的物理地址。 | +| uniq | string | 输入设备的唯一标识。 | ## AxisType diff --git a/zh-cn/application-dev/reference/apis/js-apis-inputmonitor.md b/zh-cn/application-dev/reference/apis/js-apis-inputmonitor.md old mode 100644 new mode 100755 index 5961418759209bd87927d038e8c8b6eedae483a8..72843e68c3d0e1de8e92c5fc42c51128bd2a72b8 --- a/zh-cn/application-dev/reference/apis/js-apis-inputmonitor.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inputmonitor.md @@ -63,7 +63,7 @@ export default { ## inputMonitor.off -off(type: "touch", receiver: TouchEventReceiver): void +off(type: "touch", receiver?: TouchEventReceiver): void 停止监听全局输入。