chrome.desktopCapture

refresh date: 2026-09-25 robots: noindex

Opis

Interfejs Desktop Capture API przechwytuje zawartość ekranu, poszczególnych okien lub kart.

Uprawnienia

desktopCapture

Typy

DesktopCaptureSourceType

Typ wyliczeniowy używany do definiowania zestawu źródeł multimediów na komputerze używanych w chooseDesktopMedia().

Typ wyliczeniowy

"screen"

"window"

"tab"

"audio"

SelfCapturePreferenceEnum

Chrome 107 lub nowsza wersja

Odzwierciedla SelfCapturePreferenceEnum.

Typ wyliczeniowy

"include"

"exclude"

SystemAudioPreferenceEnum

Chrome 105 lub nowsza wersja

Odpowiada SystemAudioPreferenceEnum.

Typ wyliczeniowy

"include"

"exclude"

WindowAudioPreferenceEnum

Chrome 140 lub nowsza wersja

Odzwierciedla WindowAudioPreferenceEnum.

Typ wyliczeniowy

"system"

"window"

"exclude"

Metody

cancelChooseDesktopMedia()

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

Ukrywa okno wyboru mediów na komputerze wyświetlane przez funkcję chooseDesktopMedia().

Parametry

  • desktopMediaRequestId

    liczba

    Identyfikator zwrócony przez chooseDesktopMedia()

chooseDesktopMedia()

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

Wyświetla interfejs wyboru mediów na komputerze z określonym zestawem źródeł.

Parametry

  • Zestaw źródeł, które powinny być wyświetlane użytkownikowi. Kolejność źródeł w zestawie określa kolejność kart w selektorze.

  • targetTab

    Tab opcjonalny

    Opcjonalna karta, dla której tworzony jest strumień. Jeśli nie zostanie określony, wynikowy strumień może być używany tylko przez rozszerzenie wywołujące. Strumień może być używany tylko przez ramki na danej karcie, których źródło zabezpieczeń pasuje do tab.url. Źródło karty musi być bezpieczne, np. HTTPS.

  • callback

    funkcja

    Parametr callback wygląda tak:

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

    • streamId

      tekst

      Nieprzezroczysty ciąg znaków, który można przekazać do interfejsu API getUserMedia(), aby wygenerować multimedia wygenerowane przez AI odpowiadające źródłu wybranemu przez użytkownika. Jeśli użytkownik nie wybrał żadnego źródła (czyli anulował prośbę), wywołanie zwrotne jest wywoływane z pustym obiektem streamId. Utworzonego streamId można użyć tylko raz. Jeśli nie zostanie użyty, wygaśnie po kilku sekundach.

    • Opcje

      obiekt

      Chrome 57 lub nowsza wersja

      Zawiera właściwości opisujące strumień.

      • canRequestAudioTrack

        wartość logiczna

        Wartość „true”, jeśli „audio” jest uwzględnione w źródłach parametrów, a użytkownik nie odznaczy pola wyboru „Udostępnij dźwięk”. W przeciwnym razie wartość to „false” i w takim przypadku nie należy prosić o strumień audio przez wywołanie getUserMedia.

Zwroty

  • liczba

    Identyfikator, który można przekazać do funkcji cancelChooseDesktopMedia(), jeśli trzeba anulować prompt.