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

> 适用：中控 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 事件函数文档](https://ieasyclick.com/iosdocs/funcs/usb-hid-event-api/)。

## 快速上手

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

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

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

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

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

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

// 关闭会话，释放资源
function closeHid() {
    usbHidEvent.sessionStop();
    logd("会话已关闭");
}

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

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

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

    closeHid();
    logd("脚本执行结束");
}

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。

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


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

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

苹果群控脚本从零跑通第一个点击：完整教程   适用：中控 10.7.0+，手机 iOS 17+，一根 USB 数据线。本文只讲 USB HID 点击这一条路径。第一次运行大约五分钟。

总监

编程语言

苹果群控USBHID点击脚本零基础教程，适用中控10.7.0+和iOS17+。通过一根USB数据线实现iPhone屏幕点击，五分钟跑通首个自动化脚本。涵盖环境配置、工程创建、核心代码示例、常见问题排查，助力快速上手iOS群控自动化开发。

代码解释

JavaScript

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

苹果群控脚本从零跑通第一个点击：完整教程-腾讯云开发者社区-腾讯云

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

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

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐