uinput

uinput可模拟用户操作鼠标、键盘、触控板等设备，用于稳定性等压力测试。

环境要求

• 根据hdc命令行工具指导，完成环境准备。

• 确保设备已正常连接，并执行hdc shell。

uinput功能

用法

uinput <option> <command> <arg> ...

支持能力 |命令简写|命令全写 |含义说明 | |——–|——– |——– | |-M |–mouse |注入鼠标事件。| |-K |–keyboard|注入键盘事件。| |-S |–stylus |注入触控笔事件。| |-T |–touch |注入触摸事件。| |-P |–touchpad|注入触控板事件。| |-? |–help |帮助命令。 |

说明：

命令中与坐标相关的参数，单位均为px(屏幕物理像素单位)。

帮助命令

显示uinput工具能够支持的命令信息。

命令

uinput -? 
uinput --help

使用示例

# 显示帮忙信息
uinput -? 

# 执行结果
sage: uinput <option> <command> <arg>...
The option are:
-K  --keyboard
commands for keyboard:
-d <key>                   --down   <key>     -press down a key
-u <key>                   --up     <key>     -release a key
-l <key> [long press time] --long_press <key> [long press time] -press and hold the key
-r <key> [repeat output time] --repeat output <key> [repeat output time] -press and hold the key
-i <time>                  --interval <time>  -the program interval for the (time) milliseconds

...

鼠标事件

模拟鼠标移动、点击等事件。

鼠标移动事件

模拟鼠标移动到相对位置(dx, dy)。

命令

uinput -M -m <dx> <dy>
uinput --mouse --move <dx> <dy>

使用示例

# 模拟鼠标移动到相对位置(100, 100)。
uinput -M -m 100 100

扩展命令

uinput -M -m <dx1> <dy1> <dx2> <dy2> [smooth time] --trace
uinput --mouse --move <dx1> <dy1> <dx2> <dy2> [smooth time] --trace

补充选项--trace，可以模拟鼠标移动相对位置及过程
[smooth time]移动时间，默认值：1000ms，取值范围：1 ~ 15000ms。

使用示例

# 模拟鼠标从(100, 100)花费1500ms移动到(200, 200)。
uinput -M -m 100 100 200 200 1500 --trace

鼠标按键按下事件

模拟鼠标按下按键，与抬起事件使用。key：鼠标按键。

命令

uinput -M -d <key>
uinput --mouse --down <key>

鼠标按键抬起事件

模拟鼠标按下按键，与按下事件使用。key：鼠标按键。

命令

uinput -M -u <key>
uinput --mouse --up <key>

使用示例

# 按下鼠标左键并抬起。
uinput -M -d 0 -u 0

鼠标按键单击事件

模拟鼠标单击按键。key：鼠标按键。

命令

uinput -M -c <key>
uinput --mouse --click <key>

使用示例

# 单击鼠标左键。
uinput -M -c 0

双击鼠标按键事件

模拟双击鼠标按键。id：鼠标按键。

命令

uinput -M -b <dx> <dy> <id> [press time] [click interval time]
uinput --mouse --double_click <dx> <dy> <id> [press time] [click interval time]

[press time]按压时间，取值范围：1 ~ 300ms。
[click interval time] 点击间隔时间，取值范围：1 ~ 450ms。
设置间隔时间必须在取值范围内，否则操作结果可能产生错误或无效操作。

使用示例

# 在（100， 150）这个位置双击鼠标左键。
uinput -M -b 100 150 0 10 10

鼠标滚轴滚动事件

模拟鼠标滚轴向后滚动。

命令

uinput -M -s <number>
uinput --mouse --scroll <number>

number鼠标滚动刻度数，一个刻度是15。

使用示例

# 鼠标滚轴向后滚动三个刻度。
uinput -M -s 45

鼠标拖拽事件

模拟鼠标拖拽。

命令

uinput -M -g <dx1> <dy1> <dx2> <dy2> [total time]
uinput --mouse --drag <dx1> <dy1> <dx2> <dy2> [total time]

[total time]可选参数，默认值为3000ms，取值范围：3000 ~ 15000ms。

使用示例

# 模拟按下鼠标左键从(100, 150)在指定时间拖动到(500, 300)后释放鼠标左键。
uinput -M -g 100 150 500 300

设置鼠标事件间隔

设置鼠标事件以毫秒为单位的程序间隔。

命令

uinput -M -i <time>
uinput --mouse --interval <time>

使用示例

# 单击鼠标左键间隔500ms后再次单击鼠标左键。
uinput -M -c 0 -i 500 -c 0

鼠标按键

键盘事件

模拟编辑框键盘按键输入事件。

键盘按键按下事件

模拟键盘按下按键，与抬起事件使用。key：键值定义说明。

命令

uinput -K -d <key>
uinput --keyboard --down <key>

键盘按键抬起事件

模拟键盘抬起按键，与按下事件使用。key：键值定义说明。

命令

uinput -K -u <key>
uinput --keyboard --up <key>

使用示例

# 按下"a"键并抬起。
uinput -K -d 2017 -u 2017

键盘按键长按事件

模拟键盘按下一个按键并保持设定的时长。key：键值定义说明。

命令

uinput -K -l <key> [long press time]
uinput --keyboard --long_press <key> [long press time]

使用示例

# 按下"a"键并保持100ms后抬起。
uinput -K -l 2017 100

键盘按键持续输入事件

模拟键盘按下一个按键并在设定的时长内持续输入。key：键值定义说明。

命令

uinput -K -r <key> [repeat output time]
uinput --keyboard --repeat <key> [repeat output time]

使用示例

# 按下"a"键并在100ms内重复输入。
uinput -K -r 2017 100

设置键盘事件间隔

设置键盘事件以毫秒为单位的程序间隔。

命令

uinput -K -i <time>
uinput --keyboard --interval <time>

使用示例

# 按下键盘‘a’键间隔500ms后释放。
uinput -K -d 2017 -i 500 -u 2017

键盘文本输入事件

模拟键盘输入文本。不支持与其他commands组合使用。只支持ASCLL字符，最大支持输入字符2000个。

命令

uinput -K -t <text>
uinput --keyboard --text <text>

使用示例

# 在编辑框输入一段文本"123"
uinput -K -t 123

触控笔事件

模拟触控笔点击、滑动等事件。

触控笔按下事件

模拟触控笔在（dx dy）按下，与up配合使用。

命令

uinput -S -d <dx> <dy>
uinput --stylus --down <dx> <dy>

触控笔抬起事件

模拟触控笔在（dx dy）抬起，与down配合使用。

命令

uinput -S -u <dx> <dy>
uinput --stylus --up <dx> <dy>

使用示例

# 在（100, 100）位置按下并抬起。
uinput -S -d 100 100 -u 100 100

触控笔移动事件

模拟触控笔从(dx1, dy1)按下在smooth time（毫秒）移动到(dx2, dy2)后抬起。

命令

uinput -S -m <dx1> <dy1> <dx2> <dy2> [smooth time] [-k keep time]
uinput --stylus --move <dx1> <dy1> <dx2> <dy2> [smooth time] [-k keep time]

[smooth time]可选参数，默认值为1000ms，取值范围：1 ~ 15000ms。
[-k keep time]可选参数，默认值为0ms，取值范围：0 ~ 60000ms。

使用示例

# 触控笔从(100, 100)按下花费1000ms移动到(200, 200)后抬起。
uinput -S -m 100 100 200 200 1000 -k 1000

触控笔单击事件

模拟触控笔在(dx, dy)位置单击。

命令

uinput -S -c <dx> <dy> [click interval]
uinput --stylus --click <dx> <dy> [click interval]

[click interval] 点击间隔时间，取值范围：1 ~ 450ms。

使用示例

# 触控笔在(100, 100)位置单击。
uinput -S -c 100 100

触控笔拖拽事件

模拟触控笔拖拽事件。

命令

uinput -S -g <dx1> <dy1> <dx2> <dy2> [press time] [total time] 
uinput --stylus --drag <dx1> <dy1> <dx2> <dy2> [press time] [total time] 

[Press time]按压时间，不能少于500ms。
[total time]拖动时间，[total time] - [Press time]不能少于500ms，否则操作结果可能产生错误或无效操作。

使用示例

# 模拟触控笔按下从(100, 150)在1100ms拖动到(500, 300)后释放。
uinput -S -g 100 150 500 300 500 1100

设置触控笔事件间隔

设置触控笔事件以毫秒为单位的程序间隔。

命令

uinput -S -i <time>
uinput --stylus --interval <time>

使用示例

# 单击(100, 100)位置后，间隔500ms后再次单击(100, 100)位置。
uinput -S -c 100 100  -i 500 -c 100 100

触摸事件

模拟手指触摸点击、滑动等事件。

触摸按下事件

模拟手指触摸在（dx dy）按下，与up配合使用。

命令

uinput -T -d <dx> <dy>
uinput --touch --down <dx> <dy>

触摸抬起事件

模拟手指触摸在（dx dy）抬起，与down配合使用。

命令

uinput -T -u <dx> <dy>
uinput --touch --up <dx> <dy>

使用示例

# 在（100, 100）位置按下并抬起。
uinput -T -d 100 100 -u 100 100

触摸移动事件

模拟手指触摸从(dx1, dy1)按下在smooth time（毫秒）移动到(dx2, dy2)后抬起。最多支持三指同时移动。

命令

uinput -T -m <dx1> <dy1> <dx2> <dy2> [-k keep time] [smooth time]
uinput --touch --move <dx1> <dy1> <dx2> <dy2> [-k keep time] [smooth time]

[-k keep time]可选参数，默认值为0ms，取值范围：0 ~ 60000ms。
[smooth time]可选参数，默认值为1000ms，取值范围：1 ~ 15000ms。

使用示例

# 手指触摸从(100, 100)按下花费1000ms移动到(200, 200)后抬起。
uinput -T -m 100 100 200 200 1000 -k 1000

# 三指滑动，第一根手指触摸按下从（300，900）移动到（300,2000），第二根手指触摸按下从（600,900）移动到（600,2000），第三根手指触摸按下从（900,900）移动到（900,2000），移动总时长为200ms，移动结束后手指在屏幕停顿1000m后再抬起。
uinput -T -m 300 900 300 2000 600 900 600 2000 900 900 900 2000 200 -k 1000

触摸单击事件

模拟手指触摸在(dx, dy)位置单击。

命令

uinput -T -c <dx> <dy> [click interval]
uinput --touch --click <dx> <dy> [click interval]

[click interval] 点击间隔时间，取值范围：1 ~ 450ms。

使用示例

# 手指在触摸屏(100, 100)位置单击。
uinput -T -c 100 100

触摸拖拽事件

模拟手指触摸拖拽事件。

命令

uinput -T -g <dx1> <dy1> <dx2> <dy2> [press time] [total time] 
uinput --touch --drag <dx1> <dy1> <dx2> <dy2> [press time] [total time] 

[Press time]按压时间，不能少于500ms。
[total time]拖动时间，[total time] - [Press time]不能少于500ms，否则操作结果可能产生错误或无效操作。

使用示例

# 模拟手指按下从(100, 150)在1100ms拖动到(500, 300)后释放。
uinput -T -g 100 150 500 300 500 1100

设置触摸事件间隔

设置触摸事件以毫秒为单位的程序间隔。

命令

uinput -T -i <time>
uinput --touch --interval <time>

使用示例

# 手指单击(100, 100)位置后，间隔500ms后再次单击(100, 100)位置。
uinput -S -c 100 100  -i 500 -c 100 100

触摸单指关节双击事件

模拟触摸屏单指关节双击。

命令

uinput -T -k -s <dx1> <dy1> <dx2> <dy2> [interval time]
uinput --touch --knuckle --single <dx1> <dy1> <dx2> <dy2> [interval time]

[interval time]间隙时间：默认值200ms，取值范围：1 ~ 250ms。

使用示例

# 单指关节在(100, 100)、(100, 130)位置间隔200ms敲击。
uinput -T -k -s 100 100 100 130

触摸指双关节双击事件

模拟触摸屏双指关节双击。

命令

uinput -T -k -d <dx1> <dy1> <dx2> <dy2> [interval time]
uinput --touch --knuckle --double <dx1> <dy1> <dx2> <dy2> [interval time]

[interval time]间隙时间：默认值200ms，取值范围：1 ~ 250ms。

使用示例

# 双指关节在(100, 100)、(100, 130)位置间隔200ms敲击。
uinput -T -k -d 100 100 100 130

触控板事件

触控板捏合事件

模拟触控板手指捏合。

命令

uinput -P -p <dx> <dy> scalePercent
uinput --touchpad --pinch <dx> <dy> scalePercent

scalePercent：收缩百分比，取值范围：0~500。小于100是缩小，大于100是放大。设置时要求dx大于0，dy大于200。此场景只支持图片缩放，调用该命令时，确保桌面上有一张图片。

使用示例

# 手指捏合图片。
uinput -P -p 100 300 89

触控板滑动事件

模拟触控板滑动捏合。

命令

uinput -P -s <startX> <startY> <endX> <endY>
uinput --touchpad --swipe <startX> <startY> <endX> <endY>

使用示例

# 在触控板滑动手指，可以看到后台多任务视图。
uinput -P -s 100 1100 100 300

你可能感兴趣的鸿蒙文章

harmony 鸿蒙Performance Analysis Kit（性能分析服务）

harmony 鸿蒙分析AppFreeze（应用无响应）

harmony 鸿蒙应用恢复开发指导

harmony 鸿蒙分析CppCrash（进程崩溃）

harmony 鸿蒙错误管理开发指导

harmony 鸿蒙hdc

harmony 鸿蒙事件上报

harmony 鸿蒙HiAppEvent介绍

harmony 鸿蒙订阅踩内存事件（ArkTS）

harmony 鸿蒙订阅踩内存事件（C/C++）