跳到主要内容
版本：3.0.1

模拟按键模块

模拟按键模块 - key​

模拟按一下物理按键 (key.press)​

声明​

key.press(按键码)

参数及返回值​

  • 按键码

说明​

模拟按下物理按键然后松开它。

模拟按下物理按键 (key.down)​

声明​

key.down(按键码)

参数及返回值​

  • 按键码

说明​

模拟按下物理按键。

警告

这个函数应当有对应的 key.up 调用，否则在脚本终止之后，会发生按键一直不释放的问题。

松开按下的物理按键 (key.up)​

声明​

key.up(按键码)

参数及返回值​

  • 按键码

说明​

模拟松开按下物理按键。

模拟键入文本 (key.send_text)​

声明​

key.send_text(文本[, 每键延迟])

参数及返回值​

  • 文本
    • 文本型，待输入的文字，只能是英文数字和半角字符还有 "\b" "\r" "\t"
  • 每键延迟
    • 整数型，可选，输入每次按键延迟，默认没有延迟以设备性能极限输入

说明​

将传入的 文本 拆分为单个字符，然后模拟按下对应的物理按键，最后松开。

示例​

key.send_text("AbC12#")  -- 尽可能快的键入文本
--
key.send_text("AbC12#", 300)  -- 每键入一次延迟 0.3 秒

示例代码​

模拟按 HOME 键​

key.press
key.press("HOMEBUTTON")

模拟长按 HOME 键​

key.press
key.down("HOMEBUTTON") -- 按下 HOME 键
sys.msleep(1000) -- 等待 1 秒
key.up("HOMEBUTTON") -- 松开 HOME 键

模拟双击 HOME 键​

key.press
key.press("HOMEBUTTON")
key.press("HOMEBUTTON")

模拟按锁屏键（电源键）​

key.press
key.press("LOCK")

模拟按回车键​

key.press
key.press("RETURN")

其他模拟​

key.press
-- 下面这个例子是模拟组合键 [command + v] 粘贴剪贴板的文本（不是 windows 上的 control + v）
key.down("LEFTCOMMAND") -- 按下 command 键
sys.msleep(20) -- 等待 20 毫秒
key.press("V") -- 按一下 v 键
sys.msleep(20) -- 等待 20 毫秒
key.up("LEFTCOMMAND") -- 松开 command 键
--
key.press("VOLUMEUP") -- 按一下音量 + 键
key.press("VOLUMEDOWN") -- 按一下音量 - 键
--
key.down("VOLUMEUP") -- 按下音量 + 键
sys.msleep(1000) -- 等待 1 秒
key.up("VOLUMEUP") -- 松开音量 + 键
--
key.down("LOCK") -- 按下锁屏键（电源键）
sys.msleep(3000) -- 等待 3 秒
key.up("LOCK") -- 松开锁屏键（电源键）
--
key.press("SHOW_HIDE_KEYBOARD") -- 按一下[隐藏/显示键盘键]隐藏虚拟键盘
--
key.press("SHOW_HIDE_KEYBOARD") -- 再按一下[隐藏/显示键盘键]显示虚拟键盘
--
-- 下面这个例子是模拟组合键 [锁屏键 + HOME键] 实现截屏到相册
key.down("LOCK") -- 按下锁屏键（电源键）
sys.msleep(100) -- 等待 100 毫秒
key.press("HOMEBUTTON") -- 按一下 HOME 键
sys.msleep(100) -- 等待 100 毫秒
key.up("LOCK") -- 松开锁屏键（电源键）
--
-- 切换输入法的组合键
key.down("LEFTCONTROL")
sys.msleep(50)
key.press("SPACE")
sys.msleep(50)
key.up("LEFTCONTROL")

支持的键码列表​

supported-keys
-- 字母键：
"A" "B" "C" "D" "E" "F" "G" "H" "I" "J" "K" "L" "M" "N" "O" "P" "Q" "R" "S" "T" "U" "V" "W" "X" "Y" "Z"
--
-- 数字键：
"1" "2" "3" "4" "5" "6" "7" "8" "9" "0"
--
-- 功能键：
"F1" "F2" "F3" "F4" "F5" "F6" "F7" "F8" "F9" "F10" "F11" "F12"
--
-- 其他键：
"RETURN"        --< 回车键
"ESCAPE"        --< ESC键
"BACKSPACE"     --< 退格键
"TAB"           --< 制表符键
"SPACE"         --< 空格键
"HYPHEN"        --< "-" 或 "_" 键
"EQUAL"         --< "=" 或 "+" 键
"BRACKETOPEN"   --< "[" 或 "{" 键
"BRACKETCLOSE"  --< "]" 或 "}" 键
"BACKSLASH"     --< "\" 或 "|" 键
"SEMICOLON"     --< ";" 或 ":" 键
"QUOTATION"     --< 单引号或双引号键
"ACCENT"        --< "`" 或 "~" 键
"COMMA"         --< "," 或 "<" 键
"DOT"           --< "." 或 ">" 键
"SLASH"         --< "/" 或 "?" 键
"CAPSLOCK"      --< 大小写锁定键
"PAUSE"
"INSERT"
"HOME"          --< 这个不完全等于 iOS 设备的 HOME 键
"PAGEUP"
"DELETE"
"END"
"PAGEDOWN"
"RIGHTARROW"    --< 向右箭头键
"LEFTARROW"     --< 向左箭头键
"DOWNARROW"     --< 向下箭头键
"UPARROW"       --< 向上箭头键
"LEFTCONTROL"   --< 左侧 Ctrl 键
"LEFTSHIFT"     --< 左侧 Shift 键
"LEFTALT"       --< 左侧 Alt 键
"LEFTCOMMAND"   --< 左侧 Command 键
"RIGHTCONTROL"  --< 右侧 Ctrl 键
"RIGHTSHIFT"    --< 右侧 Shift 键
"RIGHTALT"      --< 右侧 Alt 键
"RIGHTCOMMAND"  --< 右侧 Command 键
"LOCK"          --< 锁屏键，或电源键
"HOMEBUTTON"    --< 这个才等于 iOS 设备的 HOME 键
"FORWARD"       --< 多媒体下一首
"REWIND"        --< 多媒体上一首
"FORWARD2"      --< 多媒体下一首2
"REWIND2"       --< 多媒体上一首2
"EJECT"
"PLAYPAUSE"     --< 多媒体暂停键
"MUTE"          --< 静音键
"VOLUMEUP"      --< 音量 + 键
"VOLUMEDOWN"    --< 音量 - 键
"SPOTLIGHT"     --< Spotlight 键
"BRIGHTUP"      --< 屏幕亮度 + 键
"BRIGHTDOWN"    --< 屏幕亮度 - 键
"SHOW_HIDE_KEYBOARD" --< 隐藏/显示键盘键
最后于 更新