chrome.mediaGalleries

ब्यौरा

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

अनुमतियां

mediaGalleries

टाइप

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

    बूलियन

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

  • 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 ज़रूरी नहीं

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

StreamInfo

प्रॉपर्टी

  • टैग

    ऑब्जेक्ट

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

  • टाइप

    स्ट्रिंग

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

तरीके

addGalleryWatch()

प्रॉमिस 
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()

प्रॉमिस 
chrome.mediaGalleries.getMediaFileSystems(
  details?: MediaFileSystemsDetails,
  callback?: function,
): Promise<DOMFileSystem[]>

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

पैरामीटर

  • विवरण

    MediaFileSystemsDetails optional

  • कॉलबैक

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

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

    (mediaFileSystems: DOMFileSystem[]) => void

    • mediaFileSystems

      DOMFileSystem[]

रिटर्न

  • Promise<DOMFileSystem[]>

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

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

getMetadata()

प्रॉमिस 
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,
)

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

पैरामीटर