chrome.desktopCapture

Opis

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

Uprawnienia

desktopCapture

Typy

DesktopCaptureSourceType

Wartość typu Enum służąca do zdefiniowania zestawu źródeł multimediów na komputery używanych w zasadzie selectDesktopMedia().

Typ wyliczeniowy

"screen"

"window"

"tab"

"audio"

SelfCapturePreferenceEnum

Chrome 107 i nowsze wersje .

Odzwierciedla wartość SelfCapturePreferenceEnum.

Typ wyliczeniowy

"include"

"wyklucz"

SystemAudioPreferenceEnum

Chrome w wersji 105 lub nowszej .

Powiela parametr SystemAudioPreferenceEnum.

Typ wyliczeniowy

"include"

"wyklucz"

Metody

cancelChooseDesktopMedia()

chrome.desktopCapture.cancelChooseDesktopMedia(
  desktopMediaRequestId: number,
)

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

Parametry

  • desktopMediaRequestId

    liczba

    Identyfikator zwrócony przez selectDesktopMedia()

chooseDesktopMedia()

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

Pokazuje interfejs selektora multimediów na komputery z określonym zestawem źródeł.

Parametry

  • Zbiór źródeł, które powinny być widoczne dla użytkownika. Kolejność źródeł w zestawie określa kolejność kart w selektorze.

  • targetTab

    Opcjonalne Tab

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

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak: 

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

    • streamId

      ciąg znaków

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

    • Opcje

      Obiekt

      Chrome w wersji 57 lub nowszej .

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

      • canRequestAudioTrack

        wartość logiczna

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

Zwroty

  • liczba

    Identyfikator, który można przekazać do cancelChooseDesktopMedia() w razie konieczności anulowania promptu.