文档管理中心
指南系统基础功能Input Kit(多模输入服务)Input Kit术语

Input Kit术语

A

Air Mouse Mode; 空鼠模式

手写笔的隔空操作模式:通过在空中移动手写笔控制屏幕上虚拟光标的移动,并借助笔身按键实现上下翻页,适用于演示PPT、隔空操作等场景。进入该模式后系统自动使用悬浮光标(LASER_CURSOR)、点击光标(LASER_CURSOR_DOT)或激光笔光标(LASER_CURSOR_DOT_RED),应用无法通过常规光标样式接口直接设置,区别于手写笔在屏幕上书写的常规触控输入。

D

Display Coordinate System; 屏幕坐标系

以指定屏幕左上角为原点的相对坐标系,单位为像素,用于表示鼠标、触屏、轴等输入事件在屏幕上的位置。区别于以主屏左上角为原点、坐标跨屏统一的全局坐标系,多屏场景下两者的坐标值不同。

E

Event Injection; 事件注入

以编程方式构造按键、鼠标、触屏、轴等输入事件并送入系统输入通道、模拟真实用户输入的能力,主要用于自动化测试等场景。注入须遵循事件状态约束(按键先按下后抬起、轴事件序列先开始后更新再结束、同一触点不能重复按下等),并受权限管控:系统侧需ohos.permission.INJECT_INPUT_EVENT,开放侧需ohos.permission.CONTROL_DEVICE权限或先获得用户注入授权,注入产生的事件会被标记为注入事件。

Event Interception; 输入事件拦截

应用在系统分发输入事件前截获并自行处理的机制,支持按键、鼠标、触屏和轴事件。按键事件拦截仅在应用获焦时生效,鼠标、触屏和轴事件拦截仅在命中应用窗口时生效,同一应用重复添加仅首次生效;区别于只观察不阻断的事件监听。

Event Redispatch; 事件重分发

将被按键事件钩子拦截的事件按原有优先级顺序重新交回系统分发链路的机制,须在拦截后3秒内发起,且按下与抬起(或取消)事件需保持配对关系。用于钩子处理完毕后不消费按键、让事件继续正常派发。

F

Final Key; 被修饰键

组合快捷键中除修饰键以外、决定组合含义的按键,一个快捷键中仅允许一个,例如Ctrl+Alt+A中的A,系统接口中称最终按键。与修饰键集合共同唯一确定一个快捷键,快捷键订阅中由该按键按下或抬起触发回调,具体触发时机由订阅参数指定。

Fingerprint Gesture; 指纹手势

由侧边指纹器件识别上报的手势类事件,包含按下、抬起、滑动、第二次按下、双触等类型,并携带相对指纹器件长轴/短轴的偏移量。将指纹器件从身份认证部件扩展为一种触控输入通道,区别于用于身份认证的指纹识别。

G

Gesture Event; 手势事件

系统对底层触摸或触控板数据完成识别后上报的高层语义事件,直接给出捏合、旋转、多指滑动等手势结果,按开始、更新、结束(或取消)的事件序列上报。应用无需自行计算原始触点轨迹即可响应手势,区别于原始的触摸事件。

Global Coordinate System; 全局坐标系

以主屏左上角为原点、跨多块屏幕统一取值的坐标系,单位为像素,单屏幕组多屏场景下坐标全局唯一,鼠标事件的全局坐标(globalX/globalY)基于该坐标系表示。基于全局坐标的事件注入用于跨屏精确定位,区别于以指定屏幕左上角为原点的屏幕坐标系。

Global Shortcut; 全局快捷键

在系统任意界面按下即可生效的按键或组合键,又称热键(Hotkey),不依赖特定焦点窗口,由系统统一管理分发,应用通过全局快捷键接口订阅后即使不在前台也能响应。按定义者分为系统快捷键与应用快捷键,订阅前需避开已被系统或其他应用占用的组合;特殊场景(如工厂模式)下可整体屏蔽所有系统快捷键。

H

Hover Scroll; 悬停滚动

鼠标悬停(未按键)状态下滚动滚轮使悬停位置下方窗口内容滚动的行为,可通过系统开关控制启停,默认开启。用于控制滚轮滚动是否需要在悬停时即时生效。

搜索
请输入您想要搜索的关键词