skills/media
设备驱动 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"
}