chrome.desktopCapture

refresh date: 2026-09-25 robots: noindex

ब्यौरा

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

अनुमतियां

desktopCapture

इस अनुमति से एक चेतावनी ट्रिगर होती है.

टाइप

DesktopCaptureSourceType

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

Enum

"screen"

"window"

"tab"

"audio"

SelfCapturePreferenceEnum

Chrome 107 या इसके बाद का वर्शन

SelfCapturePreferenceEnum को दिखाता है.

Enum

"include"

"exclude"

SystemAudioPreferenceEnum

Chrome 105+

SystemAudioPreferenceEnum को दिखाता है.

Enum

"include"

"exclude"

WindowAudioPreferenceEnum

Chrome 140+

WindowAudioPreferenceEnum को दिखाता है.

Enum

"system"

"window"

"exclude"

तरीके

cancelChooseDesktopMedia()

chrome.desktopCapture.cancelChooseDesktopMedia(
  desktopMediaRequestId: number,
): void

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

पैरामीटर

• desktopMediaRequestId

  संख्या

  chooseDesktopMedia() से मिला आईडी

chooseDesktopMedia()

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

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

पैरामीटर

• स्रोत

  DesktopCaptureSourceType[]

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

• targetTab

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

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

• कॉलबैक

  फ़ंक्शन

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

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

  • streamId

    स्ट्रिंग

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

  • विकल्प

    ऑब्जेक्ट

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

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

    • canRequestAudioTrack

      बूलियन

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

रिटर्न

• संख्या

  ऐसा आईडी जिसे cancelChooseDesktopMedia() को पास किया जा सकता है. ऐसा तब किया जाता है, जब प्रॉम्प्ट को रद्द करना हो.