OpenHarmony多模输入子系统

__Benco2025-03-02 16:43

OpenHarmony多模输入子系统

简介

OpenHarmony旨在为开发者提供NUI（Natural User Interface）的交互方式，有别于传统操作系统的输入，在OpenHarmony上，我们将多种维度的输入整合在一起，开发者可以借助应用程序框架、系统自带的UI组件或API接口轻松地实现具有多维、自然交互特点的应用程序。

具体来说，多模输入子系统基于Linux原生驱动和HDF驱动接收设备输入事件，如键盘、鼠标、触摸屏、触摸板等，对输入事件进行归一化和标准化后通过innerSDK分发到ArkUI框架，ArkUI框架封装事件后转发到应用，或者innerSDK通过JsKit接口直接分发事件到应用。

/foundation/multimodalinput/input
├── common                       # 公共代码
├── interfaces                   # 对外接口存放目录
│   └── native                   # 对外native层接口存放目录
│       └── innerkits            # 对系统内部子系统提供native层接口存放目录
├── service                      # 服务框架代码
├── sa_profile                   # 服务启动配置文件
├── uinput                       # 输入事件注入模块

使用

接口说明

多模输入目前提供的接口为按键事件注入接口，该接口仅对系统应用开放。

inputEventClient是处理注入事件类。

表 1 inputEventClient的主要接口

功能分类	接口名	描述
注入按键	function injectEvent(keyEvent: KeyEvent): number;	注入按键事件的接口

使用说明

当前仅提供了BACK按键的事件注入。

当系统应用需要返回上一层时，通过注入接口将BACK键注入到多模服务，多模服务再上传到应用，以实现返回到上一层级目录的效果。使用方式如下所示：

复制代码

// 引入提供的js接口库
import inputEventClient from '@ohos.multimodalInput.inputEventClient';

// 调用注入事件接口
let keyEvent = {
    isPressed: true,        // 按键事件的按键类型：true：down false：up
    keyCode: 2,             // 按键对应的keycode, 例如back键的值为2
    keyDownDuration: 0,     // 按键按下到抬起的时长，单位ms
    isIntercepted: false    // 标注按键事件是否检测拦截
}
res = inputEventClient.injectEvent({KeyEvent: keyEvent});

说明： 新增的接口能力需要兼容原有的能力。

设备能力支持

设备	触摸屏	触摸板	鼠标	键盘
rk3568	是	是	是	是
hi3516dv300	是	否	否	否

OpenHarmony多模输入子系统

OpenHarmony多模输入子系统

简介

目录

使用

接口说明

使用说明

设备能力支持

相关仓