跳到主要内容
版本：3.0.1

模拟点击

XXTouchNG 支持通过软件方法模拟单指点击、单指划动、多指手势、模拟按键和模拟输入等操作。

录制回放脚本​

在设备上按一下 “音量加/减” 键，你会看到设备上弹出了一个 “XXTouch” 提示框，点击 录制 选项。此时出现提示 “开始录制”，你可以在设备上进行一系列的点击、划动等操作，这些操作会被自动记录到脚本中。

再次按一下 “音量加/减” 键，点击 停止 选项。此时出现提示 “结束录制”，随后点击 在 X.X.T. 中显示 选项，你会看到 X.X.T. 应用中出现了一个新的文件，其文件名形如 rec_20221006182101.lua，单击以选中文件。

在设备上按一下 “音量加/减” 键，你会看到设备上弹出了一个 “XXTouch” 提示框，点击 运行 选项。你会看到刚刚录制的脚本被回放了一遍。

警告

如果在脚本回放过程中出现任何异常，你可以在设备上按一下 “音量加/减” 键，点击 停止 选项。

屏幕坐标系​

请先将设备的 屏幕方向锁 关闭，保持听筒在上，将设备 竖直 握持。其坐标系如下图 Hardware Coordinates 所示：

XXTouchNG 始终以物理像素为单位，使用硬件分辨率坐标系，即 Hardware Coordinates，而不是逻辑分辨率坐标系 Logical Coordinates 或者视图坐标系 View Coordinates。有关不同设备的坐标系，请参阅：

试一试！单指划动​

在 VSCode 工作区新建 simulate-touch.lua 脚本，输入以下内容：

simulate-touch.lua
nLog("Open “Settings”…")
app.run("com.apple.Preferences")  -- 打开 “设置” 应用
sys.sleep(2)  -- 延迟 2 秒

nLog("Test gestures…")
touch.show_pose(true)  -- 显示手指位置
for _ = 1, 5 do
  touch.on(375, 1100)
    :move(375, 275)
    :step_delay(20)    -- 每一步的延迟
    :step_len(1)       -- 每一步的长度
    :move(375, 255)
    :off()
  sys.sleep(1)
end

点击 VSCode 窗口右上角的 “远程运行”，你会看到设备上的 “设置” 应用被打开，随后 “设置” 列表被连续多次地向下划动。

试一试！多指手势​

首先，下载 rec_20220919195950.lua 保存至 VSCode 工作区；随后，新建 multi-touch.lua 脚本，输入以下内容：

multi-touch.lua
nLog("Test multi-touch gestures…")
assert(app.front_bid() == "com.apple.mobileslideshow")
touch.tap(229, 364)
sys.sleep(2)

require("rec_20220919195950")
sys.sleep(2)

在设备上打开 “照片” 应用，选取一张图片。点击 VSCode 窗口右上角的 “远程运行”，你会看到设备上的图片被双指撷取，随后进行了一系列的旋转、放大和缩小操作。

试一试！模拟输入​

在 VSCode 工作区新建 simulate-input.lua 脚本，输入以下内容：

simulate-input.lua
key.send_text("Hello, World!")

在设备上打开 “备忘录” 应用，新建空白备忘录，确保软键盘已经弹出。点击 VSCode 窗口右上角的 “远程运行”，你会看到 Hello, World! 被逐字输入到了 “备忘录” 中。

最后于 更新