chrome.desktopCapture

Deskripsi

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

Izin

desktopCapture

Jenis

DesktopCaptureSourceType

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

Enum

"tab"

"audio"

SelfCapturePreferenceEnum

Chrome 107 dan yang lebih baru

Mencerminkan SelfCapturePreferenceEnum.

Enum

SystemAudioPreferenceEnum

Chrome 105 dan yang lebih baru

Mencerminkan SystemAudioPreferenceEnum.

Enum

Metode

cancelChooseDesktopMedia()

chrome.desktopCapture.cancelChooseDesktopMedia(
  desktopMediaRequestId: number,
)

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

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. Aliran data 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 getUserMedia() API untuk menghasilkan streaming media yang sesuai dengan sumber yang dipilih oleh pengguna. Jika pengguna tidak memilih sumber apa pun (yaitu membatalkan permintaan), 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 menjelaskan aliran data.

      • canRequestAudioTrack

        boolean

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

Hasil

  • angka

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