API संदर्भ

मीडिया (विभिन्न प्रकार)

सुविधा समर्थन के लिए 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 }
}