chrome.desktopCapture

Opis

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

Uprawnienia

desktopCapture

Typy

DesktopCaptureSourceType

Typ enumeracji służący do definiowania zestawu źródeł multimediów na komputery używane w funkcji chooseDesktopMedia().

Typ wyliczeniowy

„screen”

„window”

„tab”

„audio”

SelfCapturePreferenceEnum

Chrome 107 lub nowszy

Odzwierciedla SelfCapturePreferenceEnum.

Typ wyliczeniowy

"include"

„wyklucz”

SystemAudioPreferenceEnum

Chrome w wersji 105 lub nowszej

Odzwierciedla SystemAudioPreferenceEnum.

Typ wyliczeniowy

"include"

„exclude”

Metody

cancelChooseDesktopMedia()

chrome.desktopCapture.cancelChooseDesktopMedia(
  desktopMediaRequestId: number,
)

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

Parametry

  • desktopMediaRequestId

    liczba

    Identyfikator zwracany przez funkcję chooseDesktopMedia()

chooseDesktopMedia()

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

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

Parametry

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

  • targetTab

    Tabulator 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 pochodzenie bezpieczeństwa jest zgodne z tab.url. Źródło karty musi być bezpieczne, np. HTTPS.

  • wywołanie zwrotne

    funkcja

    Parametr callback ma postać:

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

    • streamId

      ciąg znaków

      Nieprzejrzysty ciąg znaków, który można przekazać do interfejsu API getUserMedia() w celu wygenerowania strumienia multimediów odpowiadającego źródłu wybranemu przez użytkownika. Jeśli użytkownik nie wybierze żadnego źródła (czyli anuluje prompt), wywołanie funkcji zwrotnej zostanie wywołane z pustym parametrem streamId. Utworzonego streamId można użyć tylko raz. Wygasa ono po kilku sekundach, jeśli nie zostanie użyte.

    • Opcje

      Obiekt

      Chrome 57 lub nowszy

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

      • canRequestAudioTrack

        wartość logiczna

        Wartość Prawda, 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ść jest fałszywa, a w takim przypadku nie należy prosić o strumień audio za pomocą wywołania getUserMedia.

Zwroty

  • liczba

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