chrome.mediaGalleries

ब्यौरा

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

अनुमतियां

mediaGalleries

उपलब्धता

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

टाइप

AddGalleryWatchResult

प्रॉपर्टी

  • galleryId

    स्ट्रिंग

  • सफलता

    बूलियन

GalleryChangeDetails

प्रॉपर्टी

  • galleryId

    स्ट्रिंग

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

  • टाइप

    GalleryChangeType

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

GalleryChangeType

Enum

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

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

GetMediaFileSystemsInteractivity

Enum

"नहीं"
जवाब में इंटरैक्टिव कॉन्टेंट शामिल न करो.

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

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

GetMetadataType

Enum

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

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

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

MediaFileSystemMetadata

प्रॉपर्टी

  • deviceId

    string ज़रूरी नहीं है

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

  • galleryId

    स्ट्रिंग

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

  • isAvailable

    बूलियन

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

  • isMediaDevice

    बूलियन

    अगर मीडिया गैलरी वाले डिवाइस का पता मीडिया डिवाइस के तौर पर चला है, तो यह वैल्यू सही होती है. जैसे, PTP या MTP डिवाइस या DCIM डायरेक्ट्री मौजूद है.

  • 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 optional

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

StreamInfo

प्रॉपर्टी

  • टैग

    ऑब्जेक्ट

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

  • टाइप

    स्ट्रिंग

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

तरीके

addGalleryWatch()

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

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

पैरामीटर

  • galleryId

    स्ट्रिंग

  • कॉलबैक

    फ़ंक्शन ज़रूरी नहीं

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

    (result: AddGalleryWatchResult) => void

रिटर्न

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

    प्रॉमिस सिर्फ़ मेनिफ़ेस्ट 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

रिटर्न

getMediaFileSystems()

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

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

पैरामीटर

  • विवरण

    MediaFileSystemsDetails optional

  • कॉलबैक

    फ़ंक्शन ज़रूरी नहीं

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

    (mediaFileSystems: DOMFileSystem[]) => void

    • mediaFileSystems

      DOMFileSystem[]

रिटर्न

  • Promise<DOMFileSystem[]>

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

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

getMetadata()

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

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

पैरामीटर

  • mediaFile

    ब्लॉब

  • विकल्प

    MediaMetadataOptions ज़रूरी नहीं है

  • कॉलबैक

    फ़ंक्शन ज़रूरी नहीं

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

    (metadata: MediaMetadata) => void

रिटर्न

  • Promise<MediaMetadata>

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

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

removeGalleryWatch()

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

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

पैरामीटर

  • galleryId

    स्ट्रिंग

इवेंट

onGalleryChanged

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

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

पैरामीटर