iOS自动化脚本USB HID

iOS 脚本的画面怎么来?无自动化截图和主程序录屏的实际差别

两个场景都挂 USB_HID、都不用开代理自动化,但一个不装东西、一个要装脱机主程序。这篇从脚本写法出发的区别讲起:输入法、剪贴板、打开应用各自差在哪,以及换模式的具体步骤。

约 5 分钟

iOS 自动化脚本,是用程序把 iPhone 上的重复操作跑起来。这篇只谈一件事:挂 USB HID 的时候,画面从哪来。

中控里两个都带 USB_HID 的场景,控制方式是同一套。差别在画面来源,以及由此带来的输入法、剪贴板这些扩展。

USB HID 从 EasyClick iOS USB 10.7.0(2026-09-08)起可用。这一路不走蓝牙,也不走 OTG。手机要 iOS 17 及以上,并且和「启动自动化」互斥。

控制层一样,画面层不同

两种场景在系统设置里叫「无自动化截图 + USB_HID」和「主程序录屏 + USB_HID」。共同点是都不用去中控点「开启自动化」,脚本里也不用调 startEnv。USB HID 和代理自动化服务互斥,换哪个场景都一样。

投屏界面中选择 USB HID 场景模式并调整分辨率预设

上面这张是投屏端的界面,场景模式在这里切,分辨率预设也在这里调。

iOS 一共有四种可选链路。这篇只写 USB HID 这一条。想先看全局,翻 iOS 自动化四种方式对比。两种模式共用同一套控制代码,换场景不用改这段:

// 两种模式共用,不用因为换场景改代码
usbHidEvent.sessionStart(true);
usbHidEvent.setScreenSize(1170, 2532);
usbHidEvent.clickPoint(200, 400);

真正的分岔在这一行:

// 无自动化截图:需要判读时取一帧
const img = image.captureFullScreenNoAuto();
image.startPreCapScreen();   // 频繁截图时先开预截图

单帧够不够用,看脚本是在确认一个状态,还是在盯一个过程。确认页面到了哪、按钮出来没有,单帧够用。要连续看过程,单帧会别扭。这是换模式的第一个理由。

换成主程序录屏,步骤不多,每一步都不能省。到下载区拿脱机主程序 IPA。脱机主程序从 v7.2.0 起作为 USB 自动化程序,系统要求 iOS 15 及以上,低于 iOS 15 不能用。官方下载页有预签名 IPA,用来测试,装上打开即可。网盘那份要自己签。个人开发者账号一年 688 元,可签 100 台设备,签名支持 iOS 12 及以上。这是苹果的签名费用,和 EasyClick 授权分开算。脱机单机同样只支持 iOS 15 及以上。7.0.0 起,单应用只跑主程序;要双应用,得再配 agent。

装好之后,在「IPA 包名」里填上它的包名。系统设置里选「主程序录屏 + USB_HID」。点开始投屏,手机上弹出「开始直播 / 广播」,要点确认。需要时点「打开主程序/Runner」,把它切到前台。换来的是下面四样。

输入法、剪贴板,以及装上之后多管什么

输入法在系统设置里有「系统默认」和「自定义输入法」。自定义输入法要求装了主程序,并完成键盘授权。不装的话,输入靠 typeText 逐字符打,或者 inputText 走剪贴板粘贴。中英文都能输。它没有接管键盘,遇到选词、候选会卡。

剪贴板是纯 HID 侧的一个短板。setClipboard 写进去再读,通常没问题。想把手机上手动复制的内容读出来,部分 iOS 版本会超时,严重时会卡住剪贴板服务,得重启手机。主程序录屏走主程序自己的剪贴板,读写一般直接可用。

打开网址和应用:主程序录屏能直接打开,不装主程序时得绕。传相册时,主程序录屏下先点「打开主程序/Runner」切到前台,会顺很多。

装上主程序,手机上就多了一个 App。它不参与业务流程,也不绑业务包名。一旦要装,安装和更新就归你管。画面来源也变了。录屏走主程序自己的广播,比单帧截图多一层持续通道。少了这层通道,就少一处可被检测的面,这是单帧的好处。操作频率、坐标是否固定、账号行为合不合规,跟画面怎么来没有关系。那一层在 iOS 自动化脚本怎么降低风控误伤 里写过。

排查时看什么

两边通用的就两条。画面在但点不动,在设备上右键,选 USB HID,重建 USBHID 会话。往手机打英文多出空格,去「设置 → 通用 → 键盘」关掉智能标点。主程序录屏多看两项:主程序还在不在前台,录屏有没有被系统收走。用过无自动化截图之后再改回「USB + 自动化服务」,投屏可能不正常,先重启手机再试。

脚本如果只是确认状态,页面到哪了、按钮出来没有,单帧截图够用,不用装东西。流程里有大量输入、要靠剪贴板搬内容、要打开指定链接,再装主程序。先用最轻的跑通,哪一步卡住了再升级。


关于 iEasyClick:面向 iOS 免越狱的自动化脚本平台,提供代理、蓝牙 HID、OTG HID、USB HID 多种链路,覆盖脚本开发、中控投屏与设备管理。→ 了解全部产品


想要真实跑起来?

本文介绍的方案均可基于 EasyClick 能力在 iEasyClick 落地。官网提供完整文档、开发工具与自动化产品,免费体验。

访问 iEasyClick 官网 →