Tham chiếu API

Media (Cross-Type)

Các thao tác trải dài trên nhiều loại media (ảnh, video, âm thanh, tài liệu): liệt kê bucket, thùng rác, khôi phục, và xóa hàng loạt. Thùng rác/khôi phục yêu cầu Android R+ (API 30+).

Định nghĩa kiểu

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
}

Thao tác

query

mediaBuckets

Liệt kê tất cả bucket media-store cho một loại dữ liệu đã cho (ví dụ IMAGE, VIDEO). Được sử dụng để xây dựng chế độ xem "Folders" trong UI thư viện.

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

deleteMediaItems

Xóa vĩnh viễn các mục media khớp với một query. Trên Android R+, xóa các mục trong thùng rác; trên các phiên bản cũ hơn, xóa trực tiếp các mục khớp. Các mục chỉ mục ảnh cũng được xóa.

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

trashMediaItems

Chuyển các mục media khớp với một query vào thùng rác hệ thống. Yêu cầu Android R+. Cho AUDIO/VIDEO, các mục cũng được xóa khỏi danh sách phát.

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

restoreMediaItems

Khôi phục các mục media trong thùng rác khớp với một query. Yêu cầu Android R+.

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