chrome.desktopCapture

refresh date: 2026-09-25 robots: noindex

Mô tả

API Chụp màn hình ghi lại nội dung trên màn hình, từng cửa sổ hoặc từng thẻ.

Quyền

desktopCapture

Loại

DesktopCaptureSourceType

Enum dùng để xác định tập hợp các nguồn nội dung nghe nhìn trên máy tính được dùng trong chooseDesktopMedia().

Enum

"screen"

"window"

"tab"

"audio"

SelfCapturePreferenceEnum

Chrome 107 trở lên

Phản ánh SelfCapturePreferenceEnum.

Enum

"include"

"exclude"

SystemAudioPreferenceEnum

Chrome 105 trở lên

Phản ánh SystemAudioPreferenceEnum.

Enum

"include"

"exclude"

WindowAudioPreferenceEnum

Chrome 140 trở lên

Phản ánh WindowAudioPreferenceEnum.

Enum

"system"

"window"

"exclude"

Phương thức

cancelChooseDesktopMedia()

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

Ẩn hộp thoại công cụ chọn phương tiện trên máy tính do chooseDesktopMedia() hiển thị.

Thông số

  • desktopMediaRequestId

    số

    Mã nhận dạng do chooseDesktopMedia() trả về

chooseDesktopMedia()

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

Hiện giao diện người dùng của công cụ chọn phương tiện trên máy tính với nhóm nguồn được chỉ định.

Thông số

  • Tập hợp các nguồn nên hiển thị cho người dùng. Thứ tự của các nguồn trong nhóm sẽ quyết định thứ tự của các thẻ trong bộ chọn.

  • targetTab

    Tab không bắt buộc

    Thẻ không bắt buộc mà luồng được tạo cho thẻ đó. Nếu không được chỉ định, thì luồng kết quả chỉ có thể được tiện ích gọi sử dụng. Chỉ những khung trong thẻ nhất định có nguồn gốc bảo mật khớp với tab.url mới có thể sử dụng luồng này. Nguồn gốc của thẻ phải là nguồn gốc an toàn, ví dụ: HTTPS.

  • callback

    hàm

    Tham số callback có dạng như sau: 

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

    • streamId

      chuỗi

      Một chuỗi mờ có thể được truyền đến API getUserMedia() để tạo luồng nội dung nghe nhìn tương ứng với nguồn mà người dùng chọn. Nếu người dùng không chọn nguồn nào (tức là đã huỷ lời nhắc), thì lệnh gọi lại sẽ được gọi bằng một streamId trống. streamId đã tạo chỉ có thể được sử dụng một lần và sẽ hết hạn sau vài giây nếu không được sử dụng.

    • tùy chọn

      đối tượng

      Chrome 57 trở lên

      Chứa các thuộc tính mô tả luồng.

      • canRequestAudioTrack

        boolean

        Đúng nếu "âm thanh" được đưa vào các nguồn tham số và người dùng cuối không bỏ đánh dấu hộp kiểm "Chia sẻ âm thanh". Nếu không, giá trị sẽ là false và trong trường hợp này, bạn không nên yêu cầu luồng âm thanh thông qua lệnh gọi getUserMedia.

Giá trị trả về

  • số

    Một mã nhận dạng có thể được chuyển đến cancelChooseDesktopMedia() trong trường hợp cần huỷ lời nhắc.