AIwok软件苹果IOS手机初始化设置和IOS HTTP接口

QQ896757558 · 发表于 2025-3-21 08:52:27

配置要求：

IDE AIWORK >3.25

手机 >= iphone6s

IOS版本 >=IOS15(ios15不支持画中画日志,16以上支持)

苹果HID硬件必须

设置:

自动息屏：必须关闭,不然截屏权限会自动关闭

蓝牙:必须打开

辅助触控:必须打开（设置->辅助功能->触控->辅助触控->打开）

软件安装

1.下载tf并安装

https://testflight.apple.com/join/1sVURYPb

或者扫二维码下载

安装完tf以后再安装aiwork

初始化

第一步硬件连接手机，选择硬件

第二步开启辅助触控

第三步校准坐标

1.找到设置通用 ->触摸板与鼠标->跟踪速度拉倒最后

2.打开软件找到坐标校准点击校准，等待校准成功提示，这里一定要保证你在上一步调整的跟踪速度鼠标位置居中

第四步快捷键校准

home默认

后台键

第五步配置快捷指令

1.配置打开app

2.配置自启动

ios操作方法

connet连接手机
http://192.168.0.112:81/connet

screenshot截屏接口
ios屏幕截屏可以指定截屏后的图像尺寸
参数：
width:宽度
height:高度
http://192.168.0.112:81/screenshot?width=720&height=1280&compress=100

getScreenWidth获取屏幕宽度
参数:
http://192.168.0.112:81/getScreenWidth

鼠标操作方法

click点击屏幕真实坐标
参数:
x:横坐标
y:纵坐标
http://192.168.0.112:81/click?x=500&y=500

clickPercent点击屏幕百分比坐标
参数:
x:横坐标
y:纵坐标
http://192.168.0.112:81/clickPercent?x=0.5&y=0.5

mouseHome 鼠标归为到0点坐标 归为鼠标到最上角
接口:http://192.168.0.112:81/mouseHome

//代码:
ios1.mouseHome()

moveToRealPoint 移动到指定坐标 鼠标会从0点坐标移动到手机真实像素坐标
http://192.168.0.112:81/moveToRealPoint?x=500&y=500

//代码:
ios1.moveToRealPoint(500,500)

moveToPercentPoint 移动到指定百分比坐标 鼠标会从0点坐标移动到手机百分比坐标
http://192.168.0.112:81/moveToPercentPoint?x=0.5&y=0.5

//代码:
ios1.moveToPercentPoint(0.5,0.5)

swipH横向水平滑动
参数:
x1:横坐标
y1:纵坐标
x2:终点横坐标
press:按下后延迟毫秒
time:滑动时长毫秒
delay:延迟抬起毫秒
http://192.168.0.105:81/swipH?x1=200&y1=600&x2=700&press=0&time=200&delay=0

swipHPercent百分比坐标横向水平滑动
参数:
x1:横坐标
y1:纵坐标
x2:终点横坐标
press:按下后延迟毫秒
time:滑动时长毫秒
delay:延迟抬起毫秒
http://192.168.0.105:81/swipHPercent?x1=0.2&y1=0.5&x2=0.7&press=0&time=200&delay=0

swipV垂直滑动
参数:
x1:横坐标
y1:纵坐标
y2:终点纵坐标
press:按下后延迟毫秒
time:滑动时长毫秒
delay:延迟抬起毫秒
http://192.168.0.105:81/swipV?x1=200&y1=300&y2=1000&press=0&time=200&delay=0

swipVPercent垂直滑动
参数:
x1:横坐标
y1:纵坐标
y2:终点纵坐标
press:按下后延迟毫秒
time:滑动时长毫秒
delay:延迟抬起毫秒
http://192.168.0.105:81/swipVPercent?x1=0.5&y1=0.8&y2=0.2&press=0&time=200&delay=0

swip滑动 预留功能暂时有问题
参数:
x1:横坐标
y1:纵坐标
x2:终点横坐标
y2:终点纵坐标
press:按下后延迟毫秒
time:滑动时长毫秒
delay:延迟抬起毫秒
http://192.168.0.106:81/swip?x1=300&y1=600&x2=600&y2=600&press=0&time=200&delay=0
返回值json格式
succes 1成功0失败

鼠标快捷键1 需要配合ios的快捷指令配置不同功能例如启动指定app 详细参考如何初始化IOS
http://192.168.0.106:81/skey1

鼠标快捷键2 需要配合ios的快捷指令配置不同功能例如启动指定app 详细参考如何初始化IOS
http://192.168.0.106:81/skey2

鼠标快捷键3 需要配合ios的快捷指令配置不同功能例如启动指定app 详细参考如何初始化IOS
http://192.168.0.106:81/skey3

鼠标快捷键4 需要配合ios的快捷指令配置不同功能例如启动指定app 详细参考如何初始化IOS
http://192.168.0.106:81/skey4

鼠标快捷键5 需要配合ios的快捷指令配置不同功能例如启动指定app 详细参考如何初始化IOS
http://192.168.0.106:81/skey5

键盘操作方法

keyPress 发送按键 按键码查询 http://doc.aiwork24.com:91/web/#/5/736
http://192.168.0.111:81/keyPress?m=0&k=4&fn=0

//测试按下a
ios1.keyPress(0,4)

home 发送home指令 需要提前配置快捷键
http://192.168.0.111:81/home

//测试按下a
ios1.home()

back 发送back指令 这个back不等同于安卓的back,要分情况使用
http://192.168.0.111:81/back

ios1.back()

recents 发送后台应用指令 唤起后台
http://192.168.0.111:81/recents

ios1.recents()

inputSimple 简单输入 只支持数字字母标点符号的输入
http://192.168.0.111:81/inputSimple?word=abcd123!@#

ios1.inputSimple('hello i am aiwork')

paste 粘贴,模拟ctrl+v的方式在输入框中粘贴,需要配合点击输入框和setClipboard设置剪切板命令使用
http://192.168.0.111:81/paste

ios1.paste()

setClipboard 设置剪切板内容，这里需要注意设置剪切板必须让应用在前端，在后台无法设置剪切板，需要先唤起app
参数：
body文本内容这里如果是有些工具记得给汉字编码urlencode否则可能出现乱码问题
http://192.168.0.111:81/setClipboard?body=你好

ingFang SC", "Hiragino Sans GB", "Microsoft YaHei", "Helvetica Neue", Helvetica, Arial, sans-serif, "Apple Color Emoji"; font-size: 36px; font-variant-ligatures: none; font-weight: 700;">苹果IOS系统教程准备环境

https://www.yuque.com/aiwork/nba2pr/yuqfliuk863h4x4t

aw5stsjo · 发表于 4 天前

看了楼主分享的内容，感觉确实挺实用的。之前也遇到过类似的需求，折腾了好几天没找到合适的方法，最后照着帖子里的步骤试了一遍，一次就跑通了。整个流程比想象中简单，尤其是前面配置的部分讲得很清楚，新手跟着做基本不会踩坑。后续如果还有进阶用法，希望楼主继续更新，收藏了慢慢研究。

aw5stsjo · 发表于 4 天前

顺着楼主的话题补一句：实践下来最省心的还是先把环境依赖理干净，后面怎么改都稳。最近把这套流程固化成了脚本，重复劳动基本没了。欢迎交流，楼主写得很扎实。

aw1ivltq · 发表于 4 天前

同感，要判断值不值得投入，就看这个场景一天重复多少次，一天十次的自动化维护成本可能比手工还高。元素定位我们用的是先抓整页文本预检，命中了再精确定位，比全页盲扫快很多。我们这边是日志分开存的，运行日志只留关键节点，出问题能快速定位到哪一步。真机上跑一遍再上线，模拟器通过不代表手机通过，系统弹窗经常是坑。

awljaazw · 发表于 3 天前

看完步骤觉得挺详细的，不过有个地方不太明白，校准坐标的时候，为什么一定要保证跟踪速度调整到最大值时鼠标位置居中？这样操作的话，要是不小心调整错了，不是会影响整个配置吗？有啥具体原因吗？

doudou9127 · 发表于前天 06:29

听着有点复杂，这配置步骤挺详细的。不过我有个疑问，安装TF之后需要直接安装AIWORK吗？还是有其他步骤？还有，校准坐标那一块，跟踪速度拉到最慢是不是更好？不然会不会影响校准精度？

hanhanmountain · 发表于前天 19:23

看来安装和配置挺复杂的，我按要求都做了，但遇到个问题，校准坐标时跟踪速度拉到最后，感觉影响了鼠标操作，有解决办法吗？还有，截屏接口里的参数，width和height填什么值合适呢？

awljaazw · 发表于昨天 08:58

看了帖子，步骤还挺详细的。安装TF和AIWORK的时候，记得扫二维码的那个方式更方便。安装完后，硬件连接手机这一步一定要按照顺序来，尤其是校准坐标这一步，跟踪速度要拉到最慢，这样校准更准确。还有，校准完之后，快捷键校准记得把Home键设置成后台键，这样方便切换。最后配置快捷指令时，一定要先配置好打开app的快捷方式，这样用起来才顺手。截图接口那部分，记得设置好宽度和高度，这样截的图才符合你的需求。有啥问题可以随时提问。

laosong2013 · 发表于 8 小时前

试过类似方案，要判断值不值得投入，就看这个场景一天重复多少次，一天十次的自动化维护成本可能比手工还高。记得给脚本留个开关，出问题能立刻停，不用重装。权限那块要单独开无障碍和电池白名单，否则跑到一半会被系统杀掉，最常见的问题就是这个。我们这边是日志分开存的，运行日志只留关键节点，出问题能快速定位到哪一步。你这个一天要跑多少次？值得投入这么多精力吗？