chrome.desktopCapture

ब्यौरा

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

अनुमतियां

desktopCapture

टाइप

DesktopCaptureSourceType

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

Enum

"screen"

"window"

"tab"

"audio"

SelfCapturePreferenceEnum

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

SelfCapturePreferenceEnum को डुप्लीकेट करता है.

Enum

"include"

"exclude"

SystemAudioPreferenceEnum

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

SystemAudioPreferenceEnum को डुप्लीकेट करता है.

Enum

"include"

"exclude"

तरीके

cancelChooseDesktopMedia()

chrome.desktopCapture.cancelChooseDesktopMedia(
  desktopMediaRequestId: number,
)

chooseDesktopMedia() फ़ंक्शन से दिखाया गया डेस्कटॉप मीडिया पिकर डायलॉग छिपाता है.

पैरामीटर

  • desktopMediaRequestId

    संख्या

    chooseDesktopMedia() फ़ंक्शन से मिला आईडी

chooseDesktopMedia()

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

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

पैरामीटर

  • स्रोत

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

  • targetTab

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

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

  • कॉलबैक

    फ़ंक्शन

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

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

    • streamId

      स्ट्रिंग

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

    • विकल्प

      ऑब्जेक्ट

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

      इसमें ऐसी प्रॉपर्टी होती हैं जो स्ट्रीम के बारे में बताती हैं.

      • canRequestAudioTrack

        बूलियन

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

रिटर्न

  • संख्या

    अगर प्रॉम्प्ट को रद्द करना है, तो यह आईडी cancelChooseDesktopMedia() फ़ंक्शन को पास किया जा सकता है.