chrome.desktopCapture

Deskripsi

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

Izin

desktopCapture

Jenis

DesktopCaptureSourceType

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

Enum

"screen"

"window"

"tab"

"audio"

SelfCapturePreferenceEnum

Chrome 107+

Mencerminkan SelfCapturePreferenceEnum.

Enum

"include"

"exclude"

SystemAudioPreferenceEnum

Chrome 105+

Mencerminkan SystemAudioPreferenceEnum.

Enum

"include"

"exclude"

Metode

cancelChooseDesktopMedia()

chrome.desktopCapture.cancelChooseDesktopMedia(
  desktopMediaRequestId: number,
)

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

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 data dibuat. Jika tidak ditentukan, streaming yang dihasilkan hanya dapat digunakan oleh ekstensi panggilan. Streaming hanya dapat digunakan oleh frame di tab tertentu yang asal keamanannya cocok dengan tab.url. Asal tab harus berupa origin 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 perintah), callback akan dipanggil dengan streamId kosong. streamId yang dibuat hanya dapat digunakan sekali dan akan berakhir masa berlakunya setelah beberapa detik jika tidak digunakan.

    • opsi

      objek

      Chrome 57+

      Berisi properti yang mendeskripsikan streaming.

      • canRequestAudioTrack

        boolean

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

Hasil

  • angka

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