Media（跨类型）

API 参考

跨越多种媒体类型（图片、视频、音频、文档）的操作：分桶列表、回收、恢复和批量删除。回收/恢复需要 Android R+（API 30+）。

类型定义

bash

type MediaBucket {
  id: String!                  # media store bucket id
  name: String!                # display name (folder name)
  count: Int!
}

type ActionResult {
  type: DataType!              # the DataType the operation ran on
  query: String!               # the query that was passed in
}

enum DataType {
  AUDIO VIDEO IMAGE SMS CONTACT NOTE FEED_ENTRY CALL DOC PACKAGE FILE
}

操作

query

mediaBuckets

列出给定数据类型（例如 IMAGE、VIDEO）的所有媒体存储分桶。用于构建图库 UI 中的 "文件夹" 视图。

bash

query GetMediaBuckets($type: DataType!) {
  mediaBuckets(type: $type) { id name count }
}

mutation

deleteMediaItems

永久删除匹配查询的媒体项。在 Android R+ 上删除回收站中的项目；在旧版本上直接删除匹配项。图片索引条目也会被移除。

bash

mutation DeleteMediaItems($type: DataType!, $query: String!) {
  deleteMediaItems(type: $type, query: $query) { type query }
}

mutation

trashMediaItems

将匹配查询的媒体项移至系统回收站。需要 Android R+。对于 AUDIO/VIDEO，项目也会从播放列表中移除。

bash

mutation TrashMediaItems($type: DataType!, $query: String!) {
  trashMediaItems(type: $type, query: $query) { type query }
}

mutation

restoreMediaItems

恢复回收站中匹配查询的媒体项。需要 Android R+。

bash

mutation RestoreMediaItems($type: DataType!, $query: String!) {
  restoreMediaItems(type: $type, query: $query) { type query }
}