chrome.desktopCapture

Opis

Interfejs Desktop Capture API przechwytuje zawartość ekranu, poszczególne okna lub poszczególne karty.

Uprawnienia

desktopCapture

Typy

DesktopCaptureSourceType

Wyliczenie używane do zdefiniowania zestawu źródeł multimediów na komputery używanych w funkcji selectDesktopMedia().

Enum

"screen"

"window"

"tab"

"audio"

SelfCapturePreferenceEnum

Chrome 107 i nowsze wersje

Reprezentuje SelfCapturePreferenceEnum.

Enum

SystemAudioPreferenceEnum

Chrome 105 i nowsze wersje

Odzwierciedla SystemAudioPreferenceEnum.

Enum

Metody

cancelChooseDesktopMedia()

chrome.desktopCapture.cancelChooseDesktopMedia(
  desktopMediaRequestId: number,
)

Ukrywa okno wyboru mediów na komputerze wyświetlane przez selectDesktopMedia().

Parametry

  • desktopMediaRequestId

    Liczba

    Identyfikator zwrócony przez selectDesktopMedia()

chooseDesktopMedia()

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

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

Parametry

  • Zbiór źródeł, które powinny się wyświetlać użytkownikowi. Kolejność źródeł w zestawie określa kolejność kart w selektorze.

  • targetTab

    Tab opcjonalnie

    Karta opcjonalna, dla której tworzony jest strumień. Jeśli nie określisz żadnej wartości, wygenerowanego strumienia może użyć tylko rozszerzenie wywołujące. Strumienia mogą używać tylko ramki na danej karcie, których źródło zabezpieczeń pasuje do tab.url. Pochodzenie karty musi być bezpiecznym źródłem, np. HTTPS.

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak: 

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

    • streamId

      string,

      Nieprzejrzysty ciąg znaków, który można przekazać do interfejsu getUserMedia() API w celu wygenerowania strumienia multimediów odpowiadającego źródłu wybranego przez użytkownika. Jeśli użytkownik nie wybrał żadnego źródła (tj. anulował prośbę), wywołanie zwrotne jest realizowane z pustym elementem streamId. Utworzonego elementu streamId można użyć tylko raz. Wygasa po kilku sekundach, gdy nie jest używana.

    • Opcje

      obiekt

      Chrome 57 i nowsze wersje

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

      • canRequestAudioTrack

        boolean

        Prawda, jeśli źródła parametrów zawierają „audio”, a użytkownik nie odznacza pola wyboru „Udostępnij dźwięk”. W przeciwnym razie ma wartość false, w tym przypadku nie należy prosić o strumień audio za pomocą wywołania getUserMedia.

Akcje powrotne

  • Liczba

    Identyfikator, który można przekazać do metody cancelChooseDesktopMedia() w przypadku, gdy trzeba anulować prompt.