您可以使用任何您喜欢的编程语言对接(如:Python
易语言,按键精灵,C++等)API轻易开发全自动化工
具,无需在手机端安装APP,无需使用无障碍权限
可实现获取画面,文本输入,屏幕点击、滑动、拖动
等操作。
除wsapi支持外,软件还支持spy++ 大漠插件等第三方集成
WebSocket API 地址:127.0.0.1:22224
WebSocket在线测试地址:https://wstool.js.org/
说明:除 List
接口和分组接口外,其他接口需传入 deviceIds
(设备ID,多个逗号分隔)或 groupIds
(分组ID,多个逗号分隔) deviceIds groupIds传all代表所有手机
功能:查询设备列表,返回设备ID
功能:查询某些设备/分组的详细信息
参数名 | 类型 | 说明 | 是否必需 |
---|---|---|---|
action | string | 固定值:Detail | 是 |
comm.deviceIds | string | 设备ID,多个逗号分隔 | 至少传一个 |
comm.groupIds | string | 分组ID,多个逗号分隔 |
功能:查询当前主控的设备信息
功能:通过App名称启动应用
参数名 | 类型 | 说明 | 是否必需 |
---|---|---|---|
action | string | 固定值:GetAppInfoByAppName | 是 |
comm.deviceIds | string | 设备ID(支持 all ),多个逗号分隔 | 是 |
comm.appName | string | 应用名称(如 feifei ) | 是 |
功能:获取当前设备所在页面的应用包名类名
参数名 | 类型 | 说明 | 是否必需 |
---|---|---|---|
action | string | 固定值:CurrentAppInfo | 是 |
comm.deviceIds | string | 设备ID(支持 all ),多个逗号分隔 | 是 |
功能:查询分组列表
功能:创建分组,返回新分组id
参数名 | 类型 | 说明 | 是否必需 |
---|---|---|---|
action | string | 固定值:CreateGroup | 是 |
comm.groupName | string | 分组名称 | 是 |
功能:修改分组名称
参数名 | 类型 | 说明 | 是否必需 |
---|---|---|---|
action | string | 固定值:UpdateGroup | 是 |
comm.groupId | string | 分组ID | 是 |
comm.groupName | string | 新分组名称 | 是 |
功能:删除分组
参数名 | 类型 | 说明 | 是否必需 |
---|---|---|---|
action | string | 固定值:DeleteGroup | 是 |
comm.groupId | string | 分组ID | 是 |
功能:移除设备到指定分组
参数名 | 类型 | 说明 | 是否必需 |
---|---|---|---|
action | string | 固定值:RemoveDeviceGroup | 是 |
comm.deleteGroupId | string | 设备所在的原分组ID | 是 |
comm.newGroupId | string | 要移动的新分组ID | 是 |
comm.androidIds | string | 设备ID,多个逗号分隔 | 是 |
功能:修改设备名称
参数名 | 类型 | 说明 | 是否必需 |
---|---|---|---|
action | string | 固定值:EditDeviceName | 是 |
comm.deviceIds | string | 设备ID(仅支持单个) | 是 |
comm.deviceName | string | 新设备名称 | 是 |
comm.isTemp | string | 是否临时修改(1=临时,0=保存数据库) | 是 |
功能:修改设备编号
参数名 | 类型 | 说明 | 是否必需 |
---|---|---|---|
action | string | 固定值:EditDeviceNo | 是 |
comm.deviceIds | string | 设备ID(仅支持单个) | 是 |
comm.deviceNo | string | 新设备编号(int类型字符串) | 是 |
comm.isTemp | string | 是否临时修改(1=临时,0=保存数据库) | 是 |
功能:截屏
参数名 | 类型 | 说明 | 是否必需 |
---|---|---|---|
action | string | 固定值:Screen | 是 |
comm.groupIds | string | 分组ID,多个逗号分隔 | 是 |
comm.savePath | string | 保存文件夹目录 | 是 |
功能:设置手机粘贴板
参数名 | 类型 | 说明 | 是否必需 |
---|---|---|---|
action | string | 固定值:WriteClipboard | 是 |
comm.deviceIds | string | 设备ID,多个逗号分隔 | 是 |
comm.content | string | 粘贴板内容 | 是 |
功能:获取手机粘贴板内容
参数名 | 类型 | 说明 | 是否必需 |
---|---|---|---|
action | string | 固定值:GetClipboard | 是 |
comm.deviceIds | string | 设备ID(仅支持单个) | 是 |
功能:手机基础操作
参数名 | 类型 | 说明 | 是否必需 |
---|---|---|---|
action | string | 固定值:BasisOperate | 是 |
comm.deviceIds | string | 设备ID,多个逗号分隔 | 是 |
comm.type | string | 操作类型(1=加音量,2=减音量,3=Back,4=home键,6=最近任务,14=息屏,15=开屏) | 是 |
功能:事件操作
参数名 | 类型 | 说明 | 是否必需 |
---|---|---|---|
action | string | 固定值:PointerEvent | 是 |
comm.deviceIds | string | 设备ID,多个逗号分隔 | 是 |
comm.mask | string | 事件类型(0=按下,1=移动,2=松开,3=鼠标右键,4=滚轮向上,5=滚轮向下,6=上滑,7=下滑,8=左滑,9=右滑,10=放大,11=缩小) | 是 |
comm.x | string | 坐标x(百分比) | 是 |
comm.y | string | 坐标y(百分比) | 是 |
comm.endx | string | 结束x坐标(滑动事件需传,其他传0) | 是 |
comm.endy | string | 结束y坐标(滑动事件需传,其他传0) | 是 |
comm.delta | string | 滚轮/缩放增量 | 可选 |
功能:键盘事件
参数名 | 类型 | 说明 | 是否必需 |
---|---|---|---|
action | string | 固定值:KeyBoardkey | 是 |
comm.deviceIds | string | 设备ID,多个逗号分隔 | 是 |
comm.key | string | 按键值(参考System.Windows.Input.Keys) | 是 |
comm.modifiers | string | 修饰键(Shift=4,Control=2,Alt=1) | 可选 |
comm.isUp | string | 是否松开(0=按下,1=松开) | 是 |
功能:输入中文
参数名 | 类型 | 说明 | 是否必需 |
---|---|---|---|
action | string | 固定值:InputText | 是 |
comm.text | string | 输入文本 | 是 |
comm.deviceIds | string | 设备ID,多个逗号分隔 | 是 |
功能:执行ADB命令
参数名 | 类型 | 说明 | 是否必需 |
---|---|---|---|
action | string | 固定值:ADB | 是 |
comm.command | string | ADB命令(如"ip addr show wlan0") | 是 |
comm.deviceIds | string | 设备ID,多个逗号分隔 | 是 |
功能:开始上传文件
参数名 | 类型 | 说明 | 是否必需 |
---|---|---|---|
action | string | 固定值:BeginFileSend | 是 |
comm.filePaths | string | 电脑文件路径(多个逗号分隔) | 是 |
comm.isAutoInstall | string | 是否自动安装APK(0=上传文件,1=自动安装) | 是 |
comm.deviceIds | string | 设备ID,多个逗号分隔 | 是 |
功能:中断上传文件
参数名 | 类型 | 说明 | 是否必需 |
---|---|---|---|
action | string | 固定值:StopSendFile | 是 |
comm.deviceIds | string | 设备ID,多个逗号分隔 | 是 |
功能:执行Bat文件
参数名 | 类型 | 说明 | 是否必需 |
---|---|---|---|
action | string | 固定值:ExecuteBat | 是 |
comm.filePath | string | Bat文件路径 | 是 |
comm.deviceIds | string | 设备ID(支持 all ) | 是 |
功能:停止Bat文件
参数名 | 类型 | 说明 | 是否必需 |
---|---|---|---|
action | string | 固定值:StopBat | 是 |
comm.filePath | string | Bat文件路径(传空停止所有脚本) | 可选 |
comm.deviceIds | string | 设备ID(支持 all ) | 是 |
功能:下载文件到手机
参数名 | 类型 | 说明 | 是否必需 |
---|---|---|---|
action | string | 固定值:HttpDown | 是 |
comm.httpurl | string | 下载链接 | 是 |
comm.savepath | string | 手机保存路径 | 是 |
comm.deviceIds | string | 设备ID(支持 all ) | 是 |
功能:读取手机文件内容
参数名 | 类型 | 说明 | 是否必需 |
---|---|---|---|
action | string | 固定值:PullText | 是 |
comm.textpath | string | 手机文件路径 | 是 |
comm.deviceIds | string | 设备ID(支持 all ) | 是 |
功能:下载手机文件到电脑
参数名 | 类型 | 说明 | 是否必需 |
---|---|---|---|
action | string | 固定值:PullFile | 是 |
comm.deviceIds | string | 设备ID(仅支持单个) | 是 |
comm.phoneFilePath | string | 手机文件路径 | 是 |
comm.savePath | string | 电脑保存路径 | 是 |