chrome.desktopCapture

Deskripsi

Desktop Capture API merekam konten layar, jendela individual, atau tab individual.

Izin

desktopCapture

Jenis

DesktopCaptureSourceType

Enum yang digunakan untuk menentukan kumpulan sumber media desktop yang digunakan dalam chooseDesktopMedia().

Enum

"screen"

"window"

"tab"

"audio"

SelfCapturePreferenceEnum

Chrome 107+

Cermin SelfCapturePreferenceEnum.

Enum

"include"

"exclude"

SystemAudioPreferenceEnum

Chrome 105+

Mencerminkan SystemAudioPreferenceEnum.

Enum

"include"

"exclude"

WindowAudioPreferenceEnum

Chrome 140+

Mencerminkan WindowAudioPreferenceEnum.

Enum

"system"

"window"

"exclude"

Metode

cancelChooseDesktopMedia()

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

Menyembunyikan dialog pemilih media desktop yang ditampilkan oleh chooseDesktopMedia().

Parameter

  • desktopMediaRequestId

    angka

    ID yang ditampilkan oleh chooseDesktopMedia()

chooseDesktopMedia()

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

Menampilkan UI pemilih media desktop dengan kumpulan sumber yang ditentukan.

Parameter

  • Kumpulan sumber yang harus ditampilkan kepada pengguna. Urutan sumber dalam set menentukan urutan tab di pemilih.

  • targetTab

    Tab opsional

    Tab opsional tempat aliran dibuat. Jika tidak ditentukan, aliran yang dihasilkan hanya dapat digunakan oleh ekstensi yang memanggil. Aliran hanya dapat digunakan oleh frame di tab tertentu yang asal keamanannya cocok dengan tab.url. Asal tab harus berupa asal yang aman, misalnya HTTPS.

  • callback

    fungsi

    Parameter callback terlihat seperti: 

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

    • streamId

      string

      String buram yang dapat diteruskan ke API getUserMedia() untuk membuat streaming media yang sesuai dengan sumber yang dipilih oleh pengguna. Jika pengguna tidak memilih sumber apa pun (yaitu membatalkan perintah), callback akan dipanggil dengan streamId kosong. streamId yang dibuat hanya dapat digunakan sekali dan akan berakhir setelah beberapa detik jika tidak digunakan.

    • opsi

      objek

      Chrome 57+

      Berisi properti yang mendeskripsikan aliran data.

      • canRequestAudioTrack

        boolean

        Benar jika "audio" disertakan dalam sumber parameter, dan pengguna akhir tidak menghapus centang kotak "Bagikan audio". Jika tidak, nilainya adalah salah (false), dan dalam hal ini, Anda tidak boleh meminta aliran audio melalui panggilan getUserMedia.

Hasil

  • angka

    ID yang dapat diteruskan ke cancelChooseDesktopMedia() jika perintah perlu dibatalkan.