chrome.desktopCapture

Mô tả

Desktop Capture API ghi lại 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 nghe nhìn trên máy tính được dùng trong chooseDesktopMedia().

Enum

"màn hình"

"window"

"thẻ"

"audio"

SelfCapturePreferenceEnum

Chrome 107 trở lên

Gương SelfCapturePreferenceEnum.

Enum

"bao gồm"

"loại trừ"

SystemAudioPreferenceEnum

Chrome 105 trở lên

Phản chiếu SystemAudioPreferenceEnum.

Enum

"bao gồm"

"loại trừ"

Phương thức

cancelChooseDesktopMedia()

chrome.desktopCapture.cancelChooseDesktopMedia(
  desktopMediaRequestId: number,
)

Ẩn hộp thoại bộ chọn phương tiện trên màn hì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,
)

Cho thấy 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 một nhóm nguồn được chỉ định.

Tham số

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

  • targetTab

    Thẻ không bắt buộc

    Thẻ không bắt buộc dùng để tạo sự kiện phát trực tiếp. Nếu bạn không chỉ định, thì chỉ tiện ích gọi mới có thể sử dụng luồng kết quả. Chỉ các 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 bảo mật, ví dụ: HTTPS.

  • số gọi lại

    hàm

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

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

    • streamId

      string

      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. streamId đã tạo chỉ có thể dùng một lần và sẽ hết hạn sau vài giây khi 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.

      • canRequestAudioTrack

        boolean

        Đúng nếu là "audio" có trong các nguồn thông số và người dùng cuối không bỏ đánh dấu tuỳ chọn "Chia sẻ âm thanh" hộp kiểm. Nếu không, giá trị sẽ là false và trong trường hợp này, người dùng 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ã nhận dạng có thể được truyền đến cancelChooseDesktopMedia() trong trường hợp cần huỷ lời nhắc.