chrome.mediaGalleries

अहम जानकारी: यह एपीआई सिर्फ़ ChromeOS पर काम करता है.

ब्यौरा

उपयोगकर्ता की सहमति से, उसकी लोकल डिस्क में मौजूद मीडिया फ़ाइलों (ऑडियो, इमेज, वीडियो) को ऐक्सेस करने के लिए, chrome.mediaGalleries एपीआई का इस्तेमाल करें.

अनुमतियां

mediaGalleries

उपलब्धता

सिर्फ़ ChromeOS के लिए

टाइप

AddGalleryWatchResult

प्रॉपर्टी

• galleryId

  स्ट्रिंग

• हो गया

  बूलियन

GalleryChangeDetails

प्रॉपर्टी

• galleryId

  स्ट्रिंग

  इससे बदली गई गैलरी की पहचान होती है.

• टाइप

  GalleryChangeType

  बदलाव वाले इवेंट का टाइप.

GalleryChangeType

Enum

"contents_changed"
गैलरी का कॉन्टेंट बदल गया है.

"watch_dropped"
स्मार्टवॉच को हटा दिया गया है, क्योंकि डिवाइस को डिसकनेक्ट कर दिया गया है, गैलरी की अनुमति हटा दी गई है या कोई अन्य वजह है.

GetMediaFileSystemsInteractivity

Enum

"नहीं"
इंटरैक्टिव तरीके से काम न करें.

"yes"
उपयोगकर्ता से, अनुमति वाली मीडिया गैलरी मैनेज करने के लिए कहें.

"if_needed"
उपयोगकर्ता से अनुमति वाली गैलरी मैनेज करने के लिए सिर्फ़ तब कहें, जब रिटर्न सेट खाली हो.

GetMetadataType

Enum

"all"
एमआईएमई टाइप, मेटाडेटा टैग, और अटैच की गई इमेज को वापस पाएं.

"mimeTypeAndTags"
सिर्फ़ एमआईएमई टाइप और मेटाडेटा टैग वापस पाएं.

"mimeTypeOnly"
सिर्फ़ एमआईएमई टाइप को वापस पाएं.

MediaFileSystemMetadata

प्रॉपर्टी

• deviceId

  string ज़रूरी नहीं

  अगर मीडिया गैलरी किसी ऐसे डिवाइस पर है जिसे हटाया जा सकता है, तो डिवाइस के ऑनलाइन होने पर उसका यूनीक आईडी.

• galleryId

  स्ट्रिंग

  मीडिया गैलरी के लिए यूनीक और स्थायी आईडी.

• isAvailable

  बूलियन

  अगर डिवाइस फ़िलहाल उपलब्ध है, तो वैल्यू true होगी.

• isMediaDevice

  बूलियन

  अगर मीडिया गैलरी वाले डिवाइस को मीडिया डिवाइस के तौर पर पहचाना गया है, तो True. जैसे, पीटीपी या एमटीपी डिवाइस या डीसीआईएम डायरेक्ट्री मौजूद है.

• isRemovable

  बूलियन

  अगर मीडिया गैलरी, हटाए जा सकने वाले डिवाइस पर है, तो वैल्यू 'सही है' होगी.

• नाम

  स्ट्रिंग

  फ़ाइल सिस्टम का नाम.

MediaFileSystemsDetails

प्रॉपर्टी

• इंटरैक्टिव

  GetMediaFileSystemsInteractivity ज़रूरी नहीं

  अनुमति वाले सेट को वापस करने से पहले, उपयोगकर्ता से अन्य मीडिया गैलरी की अनुमति मांगी जाए या नहीं. डिफ़ॉल्ट रूप से, यह साइलेंट पर सेट होता है. अगर 'yes' वैल्यू पास की जाती है या ऐप्लिकेशन को किसी भी मीडिया गैलरी का ऐक्सेस नहीं दिया गया है और 'if_needed' वैल्यू पास की जाती है, तो मीडिया गैलरी के कॉन्फ़िगरेशन का डायलॉग बॉक्स दिखेगा.

MediaMetadata

प्रॉपर्टी

• एल्बम

  string ज़रूरी नहीं

  ऑडियो और वीडियो के लिए तय किया गया है.

• कलाकार

  string ज़रूरी नहीं

• attachedImages

  Blob[]

  मीडिया फ़ाइल के मेटाडेटा में एम्बेड की गई इमेज. इसका इस्तेमाल, आम तौर पर एल्बम आर्ट या वीडियो के थंबनेल के लिए किया जाता है.

• टिप्पणी

  string ज़रूरी नहीं

• कॉपीराइट

  string ज़रूरी नहीं

• डिस्क

  number ज़रूरी नहीं

• कुल समय

  number ज़रूरी नहीं

  ऑडियो और वीडियो के लिए तय किया गया है. बस कुछ ही सेकंड में.

• शैली

  string ज़रूरी नहीं

• ऊंचाई

  number ज़रूरी नहीं

  वीडियो के लिए तय किया गया. पिक्सल में.

• भाषा

  string ज़रूरी नहीं

• mimeType

  स्ट्रिंग

  ब्राउज़र ने एमआईएमई टाइप को स्निफ़ किया.

• rawTags

  StreamInfo[]

  मीडिया फ़ाइल में मौजूद सारा मेटाडेटा. एक से ज़्यादा स्ट्रीम वाले फ़ॉर्मैट के लिए, स्ट्रीम का क्रम पहले जैसा ही रहेगा. कंटेनर मेटाडेटा पहला एलिमेंट होता है.

• रोटेशन

  number ज़रूरी नहीं

  वीडियो के लिए तय किया गया. डिग्री में.

• title

  string ज़रूरी नहीं

• ट्रैक

  number ज़रूरी नहीं

• चौड़ाई

  number ज़रूरी नहीं

MediaMetadataOptions

प्रॉपर्टी

• metadataType

  GetMetadataType ज़रूरी नहीं

  इससे यह तय होता है कि मेटाडेटा के किस सबसेट को वापस पाना है. अगर विकल्प को शामिल नहीं किया जाता है, तो डिफ़ॉल्ट रूप से 'सभी' पर सेट होता है.

StreamInfo

प्रॉपर्टी

• टैग

  ऑब्जेक्ट

  स्ट्रीम के लिए टैग की स्ट्रिंग->स्ट्रिंग डिक्शनरी, जिसे फ़िल्टर नहीं किया गया है.

• टाइप

  स्ट्रिंग

  इससे कंटेनर के फ़ॉर्मैट या स्ट्रीम के कोडेक के बारे में पता चलता है. जैसे, "mp3", "h264".

तरीके

addGalleryWatch()

वादा

chrome.mediaGalleries.addGalleryWatch(
  galleryId: string,
  callback?: function,
): Promise<AddGalleryWatchResult>

यह फ़ंक्शन, गैलरी आईडी के हिसाब से गैलरी के लिए, गैलरी वॉच जोड़ता है. इसके बाद, दिए गए कॉलबैक को सफलता या असफलता के नतीजे के साथ ट्रिगर किया जाता है.

पैरामीटर

• galleryId

  स्ट्रिंग

• कॉलबैक

  function ज़रूरी नहीं

  callback पैरामीटर कुछ ऐसा दिखता है:

  (result: AddGalleryWatchResult) => void

  • नतीजा

    AddGalleryWatchResult

रिटर्न

• Promise<AddGalleryWatchResult>

  Chrome 116 या इसके बाद का वर्शन

  प्रॉमिस सिर्फ़ Manifest V3 और इसके बाद के वर्शन के लिए काम करते हैं. अन्य प्लैटफ़ॉर्म के लिए, कॉलबैक का इस्तेमाल करना ज़रूरी है.

addUserSelectedFolder()

chrome.mediaGalleries.addUserSelectedFolder(
  callback: function,
): void

उपयोगकर्ता को डायरेक्ट्री पिकर दिखाएं और चुनी गई डायरेक्ट्री को गैलरी के तौर पर जोड़ें. अगर उपयोगकर्ता पिकर को रद्द कर देता है, तो selectedFileSystemName खाली रहेगा. डायलॉग बॉक्स दिखाने के लिए, उपयोगकर्ता का जेस्चर ज़रूरी है. उपयोगकर्ता के जेस्चर के बिना, कॉलबैक इस तरह से चलेगा जैसे उपयोगकर्ता ने उसे रद्द कर दिया हो.

पैरामीटर

• कॉलबैक

  फ़ंक्शन

  callback पैरामीटर कुछ ऐसा दिखता है:

  (mediaFileSystems: DOMFileSystem[], selectedFileSystemName: string) => void

  • mediaFileSystems

    DOMFileSystem[]

  • selectedFileSystemName

    स्ट्रिंग

getMediaFileSystemMetadata()

chrome.mediaGalleries.getMediaFileSystemMetadata(
  mediaFileSystem: DOMFileSystem,
): MediaFileSystemMetadata | undefined

किसी खास मीडिया फ़ाइल सिस्टम का मेटाडेटा पाना.

पैरामीटर

• mediaFileSystem

  DOMFileSystem

रिटर्न

• MediaFileSystemMetadata | undefined

getMediaFileSystems()

वादा

chrome.mediaGalleries.getMediaFileSystems(
  details?: MediaFileSystemsDetails,
  callback?: function,
): Promise<DOMFileSystem[]>

इस उपयोगकर्ता एजेंट में कॉन्फ़िगर की गई मीडिया गैलरी पाएं. अगर कोई भी इंटरवेंशन कॉन्फ़िगर नहीं किया गया है या उपलब्ध नहीं है, तो कॉलबैक को एक खाली कलेक्शन मिलेगा.

पैरामीटर

• विवरण

  MediaFileSystemsDetails ज़रूरी नहीं

• कॉलबैक

  function ज़रूरी नहीं

  callback पैरामीटर कुछ ऐसा दिखता है:

  (mediaFileSystems: DOMFileSystem[]) => void

  • mediaFileSystems

    DOMFileSystem[]

रिटर्न

• वादा<DOMFileSystem[]>

  Chrome 116 या इसके बाद का वर्शन

  प्रॉमिस सिर्फ़ Manifest V3 और इसके बाद के वर्शन के लिए काम करते हैं. अन्य प्लैटफ़ॉर्म के लिए, कॉलबैक का इस्तेमाल करना ज़रूरी है.

getMetadata()

वादा

chrome.mediaGalleries.getMetadata(
  mediaFile: Blob,
  options?: MediaMetadataOptions,
  callback?: function,
): Promise<MediaMetadata>

किसी मीडिया फ़ाइल के लिए, मीडिया से जुड़ा मेटाडेटा फ़ेच करता है. यह मीडिया गैलरी में मौजूद फ़ाइलों के साथ-साथ, अन्य डीओएम फ़ाइल सिस्टम के लिए भी काम करना चाहिए.

पैरामीटर

• mediaFile

  ब्लॉब

• विकल्प

  MediaMetadataOptions ज़रूरी नहीं

• कॉलबैक

  function ज़रूरी नहीं

  callback पैरामीटर कुछ ऐसा दिखता है:

  (metadata: MediaMetadata) => void

  • मेटाडेटा

    MediaMetadata

रिटर्न

• वादा<MediaMetadata>

  Chrome 116 या इसके बाद का वर्शन

  प्रॉमिस सिर्फ़ Manifest V3 और इसके बाद के वर्शन के लिए काम करते हैं. अन्य प्लैटफ़ॉर्म के लिए, कॉलबैक का इस्तेमाल करना ज़रूरी है.

removeGalleryWatch()

chrome.mediaGalleries.removeGalleryWatch(
  galleryId: string,
): void

यह फ़ंक्शन, गैलरी आईडी के हिसाब से गैलरी वॉच को हटाता है.

पैरामीटर

• galleryId

  स्ट्रिंग

इवेंट

onGalleryChanged

chrome.mediaGalleries.onGalleryChanged.addListener(
  callback: function,
)

यह इवेंट तब ट्रिगर होता है, जब मीडिया गैलरी में बदलाव किया जाता है या गैलरी वॉच को हटाया जाता है.

पैरामीटर

• कॉलबैक

  फ़ंक्शन

  callback पैरामीटर कुछ ऐसा दिखता है:

  (details: GalleryChangeDetails) => void

  • विवरण

    GalleryChangeDetails