chrome.desktopCapture

Deskripsi

Desktop Capture API merekam konten layar, masing-masing jendela, atau setiap tab.

Izin

desktopCapture

Jenis

DesktopCaptureSourceType

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

Enum

"layar"

"window"

"tab"

"audio"

SelfCapturePreferenceEnum

Chrome 107 dan yang lebih baru

Mencerminkan SelfCapturePreferenceEnum.

Enum

"sertakan"

"kecualikan"

SystemAudioPreferenceEnum

Chrome 105 dan yang lebih baru

Mencerminkan SystemAudioPreferenceEnum.

Enum

"sertakan"

"kecualikan"

Metode

cancelChooseDesktopMedia()

chrome.desktopCapture.cancelChooseDesktopMedia(
  desktopMediaRequestId: number,
)

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

Parameter

  • desktopMediaRequestId

    angka

    ID yang ditampilkan oleh selectDesktopMedia()

chooseDesktopMedia()

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

Menampilkan UI pemilih media desktop dengan kumpulan sumber yang ditentukan.

Parameter

  • Kumpulan sumber yang akan ditampilkan kepada pengguna. Urutan sumber dalam kumpulan menentukan urutan tab di pemilih.

  • targetTab

    Tab opsional

    Tab opsional tempat streaming dibuat. Jika tidak ditentukan, streaming yang dihasilkan hanya dapat digunakan oleh ekstensi panggilan. Streaming hanya dapat digunakan oleh frame di tab tertentu yang origin keamanannya cocok dengan tab.url. Asal tab harus berupa asal yang aman, mis. dengan HTTPS.

  • callback

    fungsi

    Parameter callback terlihat seperti ini: 

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

    • streamId

      string

      String buram yang dapat diteruskan ke getUserMedia() API untuk menghasilkan 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 habis masa berlakunya setelah beberapa detik jika tidak digunakan.

    • opsi

      objek

      Chrome 57 dan yang lebih baru

      Berisi properti yang mendeskripsikan aliran data.

      • canRequestAudioTrack

        boolean

        Benar jika "audio" disertakan dalam sumber parameter, dan pengguna akhir tidak menghapus centang pada "Bagikan audio" . Jika tidak salah, dan dalam hal ini, pengguna tidak boleh meminta streaming audio melalui panggilan getUserMedia.

Hasil

  • angka

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