执行快捷指令
使用本接口只支持专业版调用，必须要在正确手机添加iMouse快捷指令并正确绑定。
请求参数
{
"fun": "shortcut", //功能名
"msgid": 0,
"data": {
"deviceid": "5C:1D:D9:ED:D9:DE",//设备id
"id":1, //功能id
"devlist": [ //执行快捷指令的设备列表
"50:1D:D9:ED:D9:DE",
"51:1D:D9:ED:D9:DE",
"52:1D:D9:ED:D9:DE"
],
"outtime": 15, //超时时间，单位是秒，不填默认15秒
"parameter": ""//功能参数，json字符串，每一个功能对应的参数不一样
}
//参数内容
}
成功返回
{
"fun": "shortcut", //功能名
"data": {//返回数据
"deviceid": "5C:1D:D9:ED:D9:DE", //设备id
"retdata": ""//返回结果
},
"id":1,//功能id
"msgid": 0,
"message": "成功", //调用返回消息
"status": 0 //0成功，非0失败
}
失败返回
{
"data": {//返回数据
"deviceid": "5C:1D:D9:ED:D9:DE" //设备id
},
"id":1,//功能id
"fun": "shortcut", //功能名
"message": "没有初始化USB设备", //调用返回消息
"msgid": 0,
"status": 1
}
| 功能ID | 功能描述 |
|---|---|
| 1 | 获取手机相册列表 |
| 2 | 从手机相册传送照片或视频文件到电脑 |
| 3 | 删除手机照片或视频文件 |
| 4 | 获取手机指定目录内文件列表 |
| 5 | 从手机传送指定文件到电脑 |
| 6 | 删除手机指定文件 |
| 7 | 发送照片或视频到手机相册 |
| 8 | 发送文件到手机指定目录 |
| 10 | 发送文字到手机剪贴板 |
| 11 | 从手机剪贴板获取文字 |
| 12 | |
| 13 | 手机打开url |
| 14 | |
| 15 | 设定屏幕亮度 |
| 16 | 打开手电筒（无需功能参数） |
| 17 | 关闭手电筒（无需功能参数） |
| 18 | 打开飞行模式（无需功能参数） |
| 19 | 关闭飞行模式（无需功能参数） |
| 20 | 打开蜂窝数据（无需功能参数） |
| 21 | 关闭蜂窝数据（无需功能参数） |
| 22 | 打开无线局域网（无需功能参数） |
| 23 | 关闭无线局域网（无需功能参数） |
| 24 | 获取手机外网ip |
具体功能参数和返回结果
获取手机相册列表
请求参数
{
"date": "2023/07/28 19:09", //日期时间，获取这个日期时间之后的，留空则是所有
"num": 5 //获取条数
}
返回结果
[
{//第一条记录
"name": "abc1", //文件名
"ext": "png", //扩展名
"size": "1.6 MB", //文件大小
"time": "2023年8月10日 22:05"//文件创建时间
},
{//第二条记录
"name": "abc2", //文件名
"ext": "png", //扩展名
"size": "1.6 MB", //文件大小
"time": "2023年8月10日 22:05"//文件创建时间
}
]
从手机相册传送照片或视频文件到电脑
请求参数
[
"abc1.png", //文件名
"abc2.png" //文件名
]
返回结果
接受到的文件存放在 iMouse安装目录\Shortcut\Media 目录下
删除手机照片或视频文件
请求参数
[
"abc1.png", //文件名
"abc2.png" //文件名
]
返回结果
无
获取手机指定目录内文件列表
请求参数
{
"path": "/" //获取的路径，填写/ 代表是获取 我的iPhone 目录下所有文件
}
返回结果
[
{//第一条记录
"name": "iMouse", //文件名或者目录名
"ext": "", //扩展名，扩展名是空代表是目录
"size": "320 字节", //文件大小
"time": "2023年8月10日 22:05"//文件创建时间
},
{//第二条记录
"name": "abc1", //文件名或者目录名
"ext": "png", //扩展名
"size": "1.6 MB", //文件大小
"time": "2023年8月10日 22:05"//文件创建时间
},
{//第三条记录
"name": "abc2", //文件名或者目录名
"ext": "png", //扩展名
"size": "1.6 MB", //文件大小
"time": "2023年8月10日 22:05"//文件创建时间
}
]
从手机传送指定文件到电脑
请求参数
[
"/iMouse/1.txt", //手机文件全路径和文件名
"/iMouse/2.txt" //手机文件全路径和文件名
]
返回结果
接受到的文件存放在 iMouse安装目录\Shortcut\File 目录下
删除手机指定文件
请求参数
[
"/iMouse/1.txt", //手机文件全路径和文件名
"/iMouse/2.txt" //手机文件全路径和文件名
]
返回结果
无
发送照片或视频到手机相册
请求参数
{
"list":[//需要发送的文件列表
"d:\iMouse\1.png",//电脑文件全路径和文件名
"d:\iMouse\2.png"//电脑文件全路径和文件名
],
"name": ""//放到相册的名称，留空放到最近项目相册里
}
返回结果
无
发送文件到手机指定目录
请求参数
{
"list":[//需要发送的文件列表
"d:\iMouse\1.txt",//电脑文件全路径和文件名
"d:\iMouse\2.txt"//电脑文件全路径和文件名
],
"path": "/iMouse/"//存放文件的路径，必须以/开始和/结尾
}
返回结果
无
发送文字到手机剪贴板
请求参数
{
"text": "哈哈哈哈" //发送的文字内容
}
返回结果
无
从手机剪贴板获取文字
请求参数
无
返回结果
{
"text": "哈哈哈哈" //从手机剪贴板获取的文字内容
}
发送短信
请求参数
无
返回结果
无
手机打开url
请求参数
{
"url": ""
}
返回结果
无
手机朗读文本
请求参数
无
返回结果
无
设定屏幕亮度
请求参数
{
"num": 0.1 //亮度，1之内的浮点数
}
返回结果
无
获取手机外网ip
请求参数
无
返回结果
{
"text": "" //ip地址
}
请求示例和返回示例
获取手机相册列表
请求
{
"fun": "shortcut",
"msgid": 0,
"data": {
"deviceid": "5C:1D:D9:ED:D9:DE",
"id":1,
"devlist": [
"50:1D:D9:ED:D9:DE"
],
"parameter": "{\"date\": \"2023/07/28 19:09\",\"num\": 5}"
}
}
返回
{
"fun": "shortcut",
"data": {
"deviceid": "5C:1D:D9:ED:D9:DE",
"retdata": "[{\"name\": \"abc1\",\"ext\": \"png\",\"size\": \"1.6 MB\",\"time\": \"2023年8月10日 22:05\"},{ \"name\": \"abc2\", \"ext\": \"png\", \"size\": \"1.6 MB\",\"time\": \"2023年8月10日 22:05\"}]"
},
"id":1,
"msgid": 0,
"message": "成功",
"status": 0
}