chrome.desktopCapture

توضیحات

Desktop Capture API محتوای صفحه، پنجره های جداگانه یا برگه های جداگانه را ضبط می کند.

مجوزها

desktopCapture

انواع

DesktopCaptureSourceType

Enum برای تعریف مجموعه ای از منابع رسانه ای دسکتاپ مورد استفاده در () () ()()()()()()()از منوی() رسانه دسکتاپ استفاده می شود.

Enum

"صفحه نمایش"

"پنجره"

"تب"

"صوتی"

SelfCapturePreferenceEnum

Chrome 107+

Mirrors SelfCapturePreferenceEnum .

Enum

"شامل"

"حذف"

SystemAudioPreferenceEnum

Chrome 105+

Mirrors SystemAudioPreferenceEnum .

Enum

"شامل"

"حذف"

روش ها

cancelChooseDesktopMedia()

chrome.desktopCapture.cancelChooseDesktopMedia(
  desktopMediaRequestId: number,
)

دیالوگ انتخابگر رسانه دسکتاپ نشان داده شده توسط () () را پنهان می کند.

پارامترها

  • desktopMediaRequestId

    شماره

    شناسه توسط () selectDesktopMedia برگردانده شد

chooseDesktopMedia()

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

رابط کاربری انتخابگر رسانه دسک تاپ را با مجموعه منابع مشخص شده نشان می دهد.

پارامترها

  • مجموعه ای از منابعی که باید به کاربر نشان داده شود. ترتیب منابع در مجموعه، ترتیب برگه ها را در انتخابگر تعیین می کند.

  • targetTab

    برگه اختیاری است

    برگه اختیاری که جریان برای آن ایجاد شده است. اگر مشخص نشده باشد، جریان حاصل فقط توسط برنامه افزودنی فراخوان قابل استفاده است. این جریان را فقط می‌توان توسط فریم‌هایی در برگه داده شده استفاده کرد که منبع امنیتی آن‌ها با tab.url مطابقت دارد. مبدا برگه باید یک منبع امن باشد، به عنوان مثال HTTPS.

  • پاسخ به تماس

    تابع

    پارامتر callback به نظر می رسد: 

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

    • streamId

      رشته

      یک رشته مات که می تواند به getUserMedia() API ارسال شود تا جریان رسانه ای مطابق با منبع انتخاب شده توسط کاربر ایجاد شود. اگر کاربر هیچ منبعی را انتخاب نکرده باشد (یعنی اعلان را لغو کرده باشد)، پس تماس با یک streamId خالی فراخوانی می شود. streamId ایجاد شده فقط یک بار قابل استفاده است و در صورت عدم استفاده پس از چند ثانیه منقضی می شود.

    • گزینه ها

      شی

      Chrome 57+

      حاوی ویژگی هایی است که جریان را توصیف می کند.

      • canRequestAudioTrack

        بولی

        درست است اگر «صوت» در منابع پارامتر گنجانده شده باشد، و کاربر نهایی تیک کادر «اشتراک‌گذاری صدا» را بردارید. در غیر این صورت نادرست است و در این صورت نباید از طریق تماس getUserMedia درخواست پخش صدا کرد.

برمی گرداند

  • شماره

    شناسه‌ای که می‌تواند به cancelChooseDesktopMedia() ارسال شود، در صورتی که درخواست لغو شود.