API 참조
Media (교차 유형)
기능 지원은 app.capabilities, 인가는 app.access와 호스트 권한으로 확인하세요. 예제는 합성 값을 사용합니다. 호출 전에 경로, ID, 입력, 필터를 바꾸세요.
타입 정의
graphql
type Subscription {
mediaUpdated: MediaChange!
}
type Mutation {
deleteMediaItems(type: MediaDataType!, query: String!): ActionResult!
moveMediaItems(type: MediaDataType!, query: String!, destDir: String!): ActionResult!
restoreMediaItems(type: MediaDataType!, query: String!): ActionResult!
trashMediaItems(type: MediaDataType!, query: String!): ActionResult!
recordMediaPlay(mediaId: ID!, type: PlaybackType!, positionMs: Long!): Boolean!
saveMediaPlayProgress(mediaId: ID!, type: PlaybackType!, positionMs: Long!): Boolean!
}
type Query {
mediaBuckets(type: MediaDataType!): [MediaBucket!]!
mediaPlayHistory(query: String!, offset: Int!, limit: Int!): [MediaPlayHistory!]!
}
type ActionResult {
affectedCount: Int!
}
scalar Instant
scalar Long
type MediaBucket {
size: Long!
id: ID!
name: String!
itemCount: Int!
topItemPaths: [String!]!
}
type MediaChange {
types: [MediaDataType!]!
}
enum MediaDataType {
AUDIO
VIDEO
IMAGE
DOC
}
interface MediaItem {
id: ID!
title: String!
path: String!
size: Long!
bucketId: ID!
createdAt: Instant!
updatedAt: Instant!
}
type MediaPlayHistory {
mediaId: ID!
mediaType: PlaybackType!
positionMs: Long!
playCount: Long!
playedAt: Instant!
media: MediaItem!
}
enum PlaybackType {
AUDIO
VIDEO
}작업
subscription
mediaUpdated
영향받은 목록을 새로 고칠 미디어 라이브러리 변경 정보를 받습니다.
graphql
subscription mediaUpdated {
mediaUpdated { types }
}mutation
deleteMediaItems
일치하는 미디어 항목을 영구 삭제하고 영향받은 수를 보고합니다. 범위를 명시적으로 좁히는 쿼리가 필요합니다.
graphql
# A blank query would match the whole library, and a bulk delete is
# not something a client should be able to aim at everything by
# accident — it is refused before the platform is asked.
mutation deleteMediaItems($type: MediaDataType!, $query: String!) {
deleteMediaItems(type: $type, query: $query) { affectedCount }
}mutation
moveMediaItems
일치하는 미디어 항목을 대상 디렉터리로 이동하고 영향받은 수를 보고합니다.
graphql
mutation moveMediaItems($type: MediaDataType!, $query: String!, $destDir: String!) {
moveMediaItems(type: $type, query: $query, destDir: $destDir) { affectedCount }
}mutation
restoreMediaItems
일치하는 휴지통 미디어 항목을 복원하고 영향받은 수를 보고합니다.
graphql
mutation restoreMediaItems($type: MediaDataType!, $query: String!) {
restoreMediaItems(type: $type, query: $query) { affectedCount }
}mutation
trashMediaItems
일치하는 미디어 항목을 휴지통으로 이동하고 영향받은 수를 보고합니다. 범위를 명시적으로 좁히는 쿼리가 필요합니다.
graphql
mutation trashMediaItems($type: MediaDataType!, $query: String!) {
trashMediaItems(type: $type, query: $query) { affectedCount }
}mutation
recordMediaPlay
카탈로그 미디어 항목의 재생 시작과 위치를 기록합니다.
graphql
mutation recordMediaPlay($mediaId: ID!, $type: PlaybackType!, $positionMs: Long!) {
recordMediaPlay(mediaId: $mediaId, type: $type, positionMs: $positionMs)
}mutation
saveMediaPlayProgress
재생 시작을 다시 기록하지 않고 미디어 항목의 재생 위치를 저장합니다.
graphql
mutation saveMediaPlayProgress($mediaId: ID!, $type: PlaybackType!, $positionMs: Long!) {
saveMediaPlayProgress(mediaId: $mediaId, type: $type, positionMs: $positionMs)
}query
mediaBuckets
지정한 데이터 타입(예: IMAGE, VIDEO)의 모든 미디어 저장소 버킷을 나열합니다. 갤러리 UI의 ‘폴더’ 화면 구성에 사용합니다.
graphql
query mediaBuckets($type: MediaDataType!) {
mediaBuckets(type: $type) { size id name itemCount topItemPaths }
}query
mediaPlayHistory
쿼리에 일치하는 미디어 재생 기록을 페이지 단위로 읽습니다.
graphql
query mediaPlayHistory($query: String!, $offset: Int!, $limit: Int!) {
mediaPlayHistory(query: $query, offset: $offset, limit: $limit) { mediaId mediaType positionMs playCount playedAt }
}