虚拟外设

请先切换 HID模式,并安装驱动与控制器

模拟 外设触控 , 类似于在Android设备上插一个 鼠标 ,从而进行 模拟操作 .

info

在自动化测试中. 当前应用设置,无障碍点击无效时. 可以使用此函数模拟鼠标点击.

• 优势:点击,滑动,输入等不可被屏蔽
• 劣势:需要Android设备与PC电脑 Usb线连接,设置为充电模式,并下载Hid客户端,在app中绑定Id

#class
action.Hid

外设点击

模拟鼠标 点击

action.Hid.click(x:int,y:int,dur:int=20)

• 参数

参数	类型	是否必填	说明
x	int	是	点击的屏幕X坐标
y	int	是	点击的屏幕Y坐标
dur	int	否	点击时常 默认20毫秒

---

外设滑动

模拟鼠标 拖拽滑动

action.Hid.slide(x:int,y:int,x1:int,y1:int,dur:int=20):

• 参数

参数	类型	是否必填	说明
x	int	是	滑动的起始点X坐标
y	int	是	滑动的起始点Y坐标
x1	int	是	滑动的结束点X坐标
y1	int	是	滑动的结束点Y坐标
dur	int	否	滑动时长 默认20毫秒

外设按键

模拟键盘按键

action.Hid.key(**keycode):

• 参数

参数	类型	是否必填	说明
keycode	str 可变参数	是	按键值

key值

• 类型:

  • 字母键:

    • a - A键
    • b - B键
    • c - C键 ...
    • z - Z键

  • 数字键:

    • 1 - 数字1键
    • 2 - 数字2键 ...
    • 0 - 数字0键

  • 功能键:

    • enter - 回车键
    • esc - ESC键
    • backspace - 退格键
    • tab - Tab键
    • space - 空格键
    • capsLock - 大写锁定键
    • f1 - F1功能键 ...
    • f12 - F12功能键
    • printScreen - 打印屏幕键
    • scrollLock - 滚动锁定键
    • pause - 暂停键

  • 导航键:

    • insert - 插入键
    • home - Home键
    • pageUp - 上翻页键
    • delete - 删除键
    • end - End键
    • pageDown - 下翻页键
    • rightArrow - 右箭头键
    • leftArrow - 左箭头键
    • downArrow - 下箭头键
    • upArrow - 上箭头键

  • 符号键:

    • minus - 减号键
    • equal - 等号键
    • leftBracket - 左方括号键
    • rightBracket - 右方括号键
    • backslash - 反斜杠键
    • semicolon - 分号键
    • quote - 单引号键
    • grave - 重音符键
    • comma - 逗号键
    • period - 句号键
    • slash - 斜杠键

  • 小键盘:

    • numLock - 小键盘锁定键

    • keypadDivide - 小键盘除号键

    • keypadMultiply - 小键盘乘号键

    • keypadSubtract - 小键盘减号键

    • keypadAdd - 小键盘加号键

    • keypadEnter - 小键盘回车键

    • keypad1 - 小键盘1键 ...

    • keypad9 - 小键盘9键

    • keypad0 - 小键盘0键

    • keypadDecimal - 小键盘小数点键

    • 描述: 要发送的按键值。

  • Shift:

    • 类型: Boolean | undefined
    • 描述: Shift键的状态，表示是否按下。不传默认为 false。

  • Ctrl:

    • 类型: Boolean | undefined
    • 描述: Ctrl键的状态，表示是否按下。不传默认为 false。

  • Alt:

    • 类型: Boolean | undefined
    • 描述: Alt键的状态，表示是否按下。不传默认为 false。

  • Command:

    • 类型: Boolean | undefined
    • 描述: Command键的状态，表示是否按下。不传默认为 false。

  • id:

    • 类型: String
    • 描述: 要操作的设备的唯一标识符。