chrome.desktopCapture

Mô tả

Desktop Capture API (API Chụp màn hình) chụp nội dung trên màn hình, các cửa sổ riêng lẻ hoặc các thẻ riêng lẻ.

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

"màn hình"

"window"

"tab"

"audio"

SelfCapturePreferenceEnum

Chrome 107 trở lên

Gương 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 nội dung nghe nhì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 nội dung nghe nhìn trên máy tính có bộ nguồn được chỉ định.

Thông số

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

  • targetTab

    Thẻ không bắt buộc

    Thẻ không bắt buộc để tạo sự kiện phát trực tiếp. Nếu không được chỉ định, chỉ có tiện ích gọi mới có thể sử dụng luồng kết quả. Chỉ những khung hình trong thẻ đã cho 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à một nguồn gốc bảo mật, 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 không rõ ràng 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 một streamId trống. streamId được tạo chỉ dùng được một lần và sẽ hết hạn sau vài giây nếu không được 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 phát.

      • canRequestAudioTrack

        boolean

        Đúng nếu "audio" (âm thanh) có trong các 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.