chrome.desktopCapture

Mô tả

Desktop Capture API (API Chụp màn hình) chụp nội dung của 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 đa phương tiện trên máy tính dùng trong chooseDesktopMedia().

Enum

"màn hình"

"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"

Phương thức

cancelChooseDesktopMedia()

chrome.desktopCapture.cancelChooseDesktopMedia(
  desktopMediaRequestId: number,
)

Ẩn hộp thoại công cụ chọn nội dung nghe nhìn trên máy tính do chooseDesktopMedia() hiển thị.

Tham số

  • desktopMediaRequestId

    số

    Mã do chooseDesktopMedia() trả về

chooseDesktopMedia()

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

Hiển thị giao diện người dùng bộ chọn nội dung nghe nhìn trên máy tính với tập hợp nguồn được chỉ định.

Tham số

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

  • targetTab

    Tab không bắt buộc

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

  • lệnh gọi lại

    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 do 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 streamId trống. Bạn chỉ có thể sử dụng streamId đã tạo một lần và mã này 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 "audio" (âm thanh) có trong nguồn tham số và người dùng cuối không bỏ đánh dấu hộp "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 truyền đến cancelChooseDesktopMedia() trong trường hợp cần huỷ lời nhắc.