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,
)

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

پارامترها

• منابع

  DesktopCaptureSourceType []

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

• targetTab

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

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

• پاسخ به تماس

  تابع

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

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

  • streamId

    رشته

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

  • گزینه ها

    شی

    Chrome 57+

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

    • canRequestAudioTrack

      بولی

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

برمی گرداند

• شماره

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