设备驱动 API
媒体与相册注入
将远程图片静默写入 Android 系统相册,供社交发帖直接调用
在社群运营、多图发朋友圈、小红书图文发布等自动化业务场景中,最困难的环节往往是“如何把服务器上的图片放进手机相册”。
AI 手机专为解决此痛点内置了 media.download_image 核心能力。
核心机制:相册无感注入
- 直接写入系统媒体库:图片下载后直接保存在手机系统相册集合中。
- 强制触发图库广播刷新:下载完成后,系统自动触发图库广播刷新。
- 置顶展示:下载的图片瞬间出现在系统相册的「最近」第一张,后续无论是自动化脚本还是视觉模型,只需点击系统附件选择器的第一个缩略图即可直接发送!
指令说明 (media.download_image)
- 方法:
POST /gateway/skill/execute - 参数:
image_urls(数组, 推荐):支持批量传入多个 HTTP / HTTPS 图片公网地址(亦兼容驼峰imageUrls或简写urls)。image_url(字符串, 兼容单张):单个图片地址(亦兼容imageUrl或url)。- 注意:手机端侧直接通过网络请求下载,请确保图片链接在公网可直接访问,切勿传入
localhost或127.0.0.1。
请求示例
{
"device_id": "848bd13e2f9",
"skill_id": "media.download_image",
"params": {
"image_urls": [
"https://example.com/promotions/banner_01.png",
"https://example.com/promotions/product_detail.jpg"
]
}
}
响应示例
{
"code": 200,
"msg": "从 URL 批量下载图片到设备相册,并强制触发系统图库刷新",
"data": {
"success_count": 2,
"failed_count": 0,
"saved_paths": [
"/storage/emulated/0/Pictures/BatonImages/img_1717171717_0.png",
"/storage/emulated/0/Pictures/BatonImages/img_1717171717_1.jpg"
]
},
"skillId": "media.download_image",
"deviceId": "848bd13e2f9"
}