chrome.desktopCapture

ब्यौरा

डेस्कटॉप कैप्चर एपीआई, स्क्रीन के कॉन्टेंट, अलग-अलग विंडो या अलग-अलग टैब को कैप्चर करता है.

अनुमतियां

desktopCapture

टाइप

DesktopCaptureSourceType

Enum को chooseDesktopMedia() में इस्तेमाल किए जाने वाले, डेस्कटॉप मीडिया सोर्स का सेट तय करने के लिए इस्तेमाल किया जाता है.

Enum

SelfCapturePreferenceEnum

Chrome 107 और उसके बाद के वर्शन

मिरर SelfCapturePreferenceEnum.

Enum

SystemAudioPreferenceEnum

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

मिरर SystemAudioPreferenceEnum.

Enum

तरीके

cancelChooseDesktopMedia()

chrome.desktopCapture.cancelChooseDesktopMedia(
  desktopMediaRequestId: number,
)

डेस्कटॉप मीडिया पिकर डायलॉग बॉक्स को chooseDesktopMedia() से दिखाया जाता है.

पैरामीटर

  • desktopMediaRequestId

    नंबर

    चुनें डेस्कटॉपMedia() से आईडी वापस की गई है

chooseDesktopMedia()

chrome.desktopCapture.chooseDesktopMedia(
  sources: DesktopCaptureSourceType[],
  targetTab?: Tab,
  callback: function,
)

सोर्स के तय सेट के साथ, डेस्कटॉप मीडिया पिकर का यूज़र इंटरफ़ेस (यूआई) दिखाता है.

पैरामीटर

  • स्रोत

    DesktopCaptureSourceType[]

    सोर्स का सेट, जो उपयोगकर्ता को दिखाया जाना चाहिए. सेट में मौजूद सोर्स का क्रम, पिकर में टैब का क्रम तय करता है.

  • targetTab

    Tab ज़रूरी नहीं

    वैकल्पिक टैब, जिसके लिए स्ट्रीम की गई है. अगर इसके बारे में नहीं बताया गया है, तो मिलने वाली स्ट्रीम का इस्तेमाल सिर्फ़ कॉल एक्सटेंशन के ज़रिए किया जा सकता है. स्ट्रीम का इस्तेमाल, टैब में मौजूद सिर्फ़ वे फ़्रेम कर सकते हैं जिनके सुरक्षा स्रोत की सेटिंग tab.url से मेल खाती है. टैब का ऑरिजिन सुरक्षित होना चाहिए, जैसे कि एचटीटीपीएस.

  • कॉलबैक

    फ़ंक्शन

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

    (streamId: string,options: object)=>void

    • streamId

      स्ट्रिंग

      एक ओपेक स्ट्रिंग, जिसे getUserMedia() API को पास किया जा सकता है, ताकि उपयोगकर्ता के चुने गए सोर्स से जुड़ी मीडिया स्ट्रीम जनरेट की जा सके. अगर उपयोगकर्ता ने कोई सोर्स नहीं चुना है (जैसे कि प्रॉम्प्ट रद्द कर दिया है), तो कॉलबैक को खाली streamId के साथ कॉल किया जाता है. बनाया गया streamId सिर्फ़ एक बार इस्तेमाल किया जा सकता है. इस्तेमाल न होने पर, कुछ सेकंड बाद इसकी समयसीमा खत्म हो जाती है.

    • विकल्प

      ऑब्जेक्ट

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

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

      • canRequestAudioTrack

        boolean

        अगर "ऑडियो" पैरामीटर सोर्स में शामिल है और असली उपयोगकर्ता "ऑडियो शेयर करें" चेकबॉक्स से सही का निशान नहीं हटाता, तो वैल्यू 'सही' होती है. नहीं तो गलत होता है और इस मामले में, किसी को getUserMedia कॉल के ज़रिए ऑडियो स्ट्रीम के बारे में नहीं पूछना चाहिए.

रिटर्न

  • नंबर

    प्रॉम्प्ट को रद्द करने की ज़रूरत पड़ने पर, उसे cancelChooseDesktopMedia() के लिए पास किया जा सकता है.