chrome.desktopCapture

ब्यौरा

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

अनुमतियां

desktopCapture

टाइप

DesktopCaptureSourceType

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

Enum

"स्क्रीन"

"विंडो"

"टैब"

"ऑडियो"

SelfCapturePreferenceEnum

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

मिरर SelfCapturePreferenceEnum.

Enum

"शामिल करें"

"बाहर रखें"

SystemAudioPreferenceEnum

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

मिरर SystemAudioPreferenceEnum.

Enum

"शामिल करें"

"बाहर रखें"

तरीके

cancelChooseDesktopMedia()

chrome.desktopCapture.cancelChooseDesktopMedia(
  desktopMediaRequestId: number,
)

डेस्कटॉप मीडिया पिकर डायलॉग छिपाता है, जो चुनने डेस्कटॉप मीडिया() के ज़रिए दिखाया जाता है.

पैरामीटर

  • desktopMediaRequestId

    संख्या

    चुनेंDesktopMedia() का इस्तेमाल करके दिया गया आईडी

chooseDesktopMedia()

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

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

पैरामीटर

  • स्रोत

    DesktopCaptureSourceType[]

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

  • targetTab

    टैब ज़रूरी नहीं

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

  • कॉलबैक

    फ़ंक्शन

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

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

    • streamId

      स्ट्रिंग

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

    • विकल्प

      ऑब्जेक्ट

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

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

      • canRequestAudioTrack

        बूलियन

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

रिटर्न

  • संख्या

    एक आईडी, जिसे सूचना को रद्द करने की ज़रूरत होने पर,Chooseडेस्कटॉपMedia() को रद्द करने के लिए पास किया जा सकता है.