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 }
}