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"
Enum
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
-
źródła
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 elementemstreamId
. Utworzonego elementustreamId
można użyć tylko raz. Wygasa po kilku sekundach, gdy nie jest używana. -
Opcje
obiekt
Chrome 57 i nowsze wersjeZawiera 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.