iMouse投屏 清空相册
调用说明
依赖 iMouse投屏 客户端
只在这台设备以 iMouse投屏 方式推流时可用，前置条件与 code 70~73 的含义见「iMouse投屏 相册列表」。
清空一个相册，支持多台设备同时清（各台并行）。album_id 与 album_name 至少传一个，
两个都不传返回 code=36（不允许不指定相册就清空）。
| 相册类型 | 怎么处理（2026-09-10 起） |
|---|---|
| 系统智能相册（相机胶卷、截图等） | 里面的照片从系统相册彻底删除（进「最近删除」30 天），会弹 iOS 确认框 |
| 用户自建相册 | 相册里的照片同样从系统相册彻底删除（不是只移出相册），同样会弹确认框 |
album_id / album_name 只传其中一个也行，内核会自动补全另一个。
清空智能相册会弹 iOS 确认框，内核会替你点掉
内核发出请求后等 auto_click 毫秒，自动替你点掉确认框；auto_click=0 则不点，此时你要自己在手机上点，接口会一直等到 outtime。
⚠️ 弹窗没被点掉时，后面所有相册请求都会超时（71），到手机上把弹窗点掉即可。
清自建相册不弹框，也不会去点。
- 请求参数
| 参数 | 类型 | 说明 | 备注 |
|---|---|---|---|
| fun | 字符串 | /plugin/imcast/album/clear | 请求功能名 |
| id | 字符串 | 设备id | 多个设备用逗号隔开 |
| album_id | 字符串 | 相册 id | 来自「相册列表」，优先级高于 album_name |
| album_name | 字符串 | 相册名 | 与 album_id 二选一即可；智能相册（相机胶卷）按名字也找得到 |
| auto_click | 整数 | 发出请求后等多少毫秒去点确认框 | 不传默认 1500；0 不点 |
| outtime | 整数 | 超时时间 | 单位毫秒，不传或 0 用内核配置（默认 15 秒） |
- httpGet请求示例
curl --request GET \
--url 'http://192.168.9.9:9911/api/plugin/imcast/album/clear?id=6C:8D:C1:67:04:29&album_name=%E6%B5%8B%E8%AF%95'
- httpPost请求示例
curl --request POST \
--url http://192.168.9.9:9911/api \
--header "content-type: multipart/form-data" \
--form "fun=/plugin/imcast/album/clear" \
--form "id=6C:8D:C1:67:04:29" \
--form "album_name=测试"
- httpPost json请求示例【websocket也可发送同样json请求】
curl --request POST \
--url http://192.168.9.9:9911/api \
--header 'Content-Type: application/json' \
--data '{
"fun": "/plugin/imcast/album/clear",
"data": {
"id": "6C:8D:C1:67:04:29,5C:F7:E6:CE:65:22",
"album_name": "测试"
}
}'
响应结果
{
"data": {
"list": [
{ "id": "6C:8D:C1:67:04:29", "code": 0, "message": "成功", "deleted": 2, "album_name": "测试", "album_id": "57AB2D83-F098-4C67-886E-D7439A5E8DCC/L0/040", "type": "user" }
],
"code": 0,
"id": "6C:8D:C1:67:04:29",
"message": "成功"
},
"status": 200,
"message": "成功",
"msgid": 0,
"fun": "/plugin/imcast/album/clear"
}
- 响应data数据字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
| code | 整数 | 全部设备都成功为 0，否则是第一台失败设备的 code |
| list[].id | 字符串 | 设备id |
| list[].code | 整数 | 这台的结果，0 成功 |
| list[].message | 字符串 | 这台的说明；手机端有提示语时带在这里 |
| list[].deleted | 整数 | 移出 / 删除的照片数 |
| list[].album_name | 字符串 | 实际定位到的相册名 |
| list[].album_id | 字符串 | 实际定位到的相册 id（没清到东西时为空） |
| list[].type | 字符串 | 手机端报告的相册类型：user 自建、smart 系统 |
备注
清空之后立刻调「相册列表」，count 可能还是旧值（手机端缓存），「图片列表」是准的。