苹果群控脚本从零跑通第一个点击：完整教程

Q: 能点击，但抓不到界面上的元素怎么办？

USB HID 只负责发送点击、滑动和输入事件，读取界面内容要靠节点或者 OCR。节点读不到的时候，用截图识字再点击，参考 PaddleOCR V6 那篇。

适用：中控 10.7.0+，手机 iOS 17+，一根 USB 数据线。本文只讲 USB HID 点击这一条路径。第一次运行大约五分钟。

适用对象与准备

这篇写给第一次接触苹果群控脚本的人：能看懂 JavaScript，手边有一台 iPhone 和一根数据线，想先运行成功一个能在屏幕上点击的最小脚本。本文只讲 USB HID 这一条点击路径，其他点击方式不在本文讨论。

开始之前，先把四样东西准备好，缺任何一样都会卡住：

中控电脑：安装好 EasyClick iOS USB 中控，版本 10.7.0 以上。低于这个版本没有 USB HID 模块。
手机：iOS 17 以上（文档建议 17+，低于 17 不稳定）。
数据线：普通 USB 数据线。USB HID 这条路线只需要一根数据线，手机上也不用安装任何 App。
开发工具：IDEA 安装 EasyClick 开发插件，用来创建工程、编写脚本和查看日志。

另外，中控第一次使用 USB HID 时可能需要刷入开发者镜像，产品下载器中的「iOS 开发者镜像压缩包」是必选组件，没有下载的话先补上。中控里还要确认这台手机已经授权（USB 设备授权），没有授权脚本无法运行。

这篇只用到四个函数：sessionStart、setScreenSize、clickPoint、sessionStop。每个函数的完整参数和返回值看 USB HID 事件函数文档。

快速上手

先把它运行成功一次，再回头讲原理。整个过程四步，五分钟能完成。

先链接设备。启动中控，用数据线把 iPhone 接到电脑上。手机第一次连接会弹出「信任」提示，点击信任；设备列表里出现这台手机，才算链接成功。

接着创建工程。在 IDEA 里打开一个空文件夹，右键新建模块，类型选择「EasyClick IOS USB版-脚本项目」，输入名称后点击创建。创建完成后点击「链接中控调试地址」，默认地址是 http://127.0.0.1:8019，底部日志显示连接成功后即可继续。

然后粘贴下面这段脚本并运行。它是完整可执行的工程脚本，带了错误处理、日志和退出清理：

1
// 苹果群控 USB HID 最小可运行脚本
2
// 适用：中控 10.7.0+，手机 iOS 17+
3

4
// 打开 USB HID 会话并设置屏幕尺寸
5
function openHid() {
6
    let r = usbHidEvent.sessionStart(true);
7
    if (r && r !== "") {
8
        loge("会话开启失败: " + r);
9
        return false;
10
    }
11
    // iPhone 12/13/14 的尺寸是 1170×2532，按你的机型修改
12
    r = usbHidEvent.setScreenSize(1170, 2532);
13
    if (r && r !== "") {
14
        loge("设置屏幕尺寸失败: " + r);
15
        return false;
16
    }
17
    return true;
18
}
19

20
// 关闭会话，释放资源
21
function closeHid() {
22
    usbHidEvent.sessionStop();
23
    logd("会话已关闭");
24
}
25

26
function main() {
27
    logd("脚本开始执行");
28

29
    if (!openHid()) {
30
        loge("USB HID 会话初始化失败，脚本退出");
31
        return;
32
    }
33

34
    // 在 (300, 400) 的位置单击，换成你要点的位置
35
    let r = usbHidEvent.clickPoint(300, 400);
36
    if (r && r !== "") {
37
        loge("点击失败: " + r);
38
        closeHid();
39
        return;
40
    }
41
    logd("点击已执行");
42
    sleep(1000);
43

44
    closeHid();
45
    logd("脚本执行结束");
46
}
47

48
main();

运行工程后，日志里能看到会话开启、点击执行、会话关闭这三条记录，手机屏幕在 (300, 400) 的位置会出现点击反应。

最后查看运行结果。点击生效，说明整条链路已经通了，后面复杂的脚本都是在这个基础上增加功能。没有反应的话，先查看日志里有没有报错，再对照第四节逐个排查。

分步详解

分步详解把上一节的整段代码拆开讲，每一步写清做什么、怎么做、预期结果。

链接设备。 启动中控，用数据线把 iPhone 接到电脑上。手机第一次连接会弹出「信任」提示，点击信任。设备列表里出现这台手机，才算链接成功；列表里没有的话，先检查数据线和驱动。

创建工程。 在 IDEA 里打开一个空文件夹，右键新建模块，类型选择「EasyClick IOS USB版-脚本项目」，输入名称后点击创建。随后点击「链接中控调试地址」，默认地址是 http://127.0.0.1:8019。底部日志显示连接成功，说明工程已经连上中控。

编写脚本。 把上一节的代码粘贴进脚本文件。核心是三个函数：openHid 负责开启会话和设置屏幕尺寸，两步都成功才返回 true；closeHid 负责关闭会话、释放资源；main 负责组织流程，出错时先调用 closeHid 再退出。sessionStart 的参数 true 是增强兼容模式，低版本系统会自动忽略。

运行与验证。 右键运行工程，查看 IDEA 底部的日志窗口。正常会依次出现「脚本开始执行」「点击已执行」「脚本执行结束」「会话已关闭」四条记录，手机屏幕在 (300, 400) 的位置出现点击反应。缺了哪条日志，问题就出在哪一步：没有「脚本开始执行」，说明工程没有运行起来；没有「点击已执行」，说明会话或坐标出了问题，回头查看报错信息。

常见问题

会话开启失败怎么办？ 先看中控版本是不是 10.7.0 以上，低于这个版本没有 USB HID 模块。版本没问题，再检查数据线是不是插稳、电脑有没有识别到设备。第一次使用 USB HID 时中控可能需要刷入开发者镜像，产品下载器里的「iOS 开发者镜像压缩包」没有安装的话，先补装再试。

点击没有反应或者点偏了怎么办？ 先确认 setScreenSize 传入的分辨率和当前截图的分辨率一致，1170×2532 是 iPhone 12/13/14 的尺寸，其他机型要改。手机横屏之后，要重新调用 setScreenSize，否则坐标全部偏移。

USB HID 能做哪些操作？ 点击、长按、双击、滑动、输入文字和截图，本文只用到点击这一种。这些操作的具体写法在后面几篇里展开。

能点击，但抓不到界面上的元素怎么办？ USB HID 只负责发送点击、滑动和输入事件，读取界面内容要靠节点或者 OCR。节点读不到的时候，看《苹果群控 OCR 找字点击：PaddleOCR V6 四段代码拆解》那篇，用截图识字再点击。

脚本运行一次就结束了，想让它重复执行怎么办？ 把 main 里的流程放进 while 循环，在循环里加 sleep 控制间隔；定时执行交给中控的任务排期，不要用死循环硬等。循环里要注意每轮重新截图、重新判断，不能沿用上一轮的坐标。

苹果群控脚本从零跑通第一个点击：完整教程

适用对象与准备

快速上手

分步详解

常见问题

延伸阅读