chrome.desktopCapture

Beschreibung

Die Desktop Capture API erfasst den Inhalt des Bildschirms, einzelner Fenster oder einzelner Tabs.

Berechtigungen

desktopCapture

Typen

DesktopCaptureSourceType

Enum-Wert zur Definition einer Gruppe von Desktop-Medienquellen, die in selectDesktopMedia() verwendet werden.

Enum

"Bildschirm"

"Fenster"

"Tab"

"Audio"

SelfCapturePreferenceEnum

Chrome 107 oder höher

Spiegelt SelfCapturePreferenceEnum.

Enum

„einschließen“

"Ausschließen"

SystemAudioPreferenceEnum

Chrome 105 oder höher

Spiegelt SystemAudioPreferenceEnum.

Enum

„einschließen“

"Ausschließen"

Methoden

cancelChooseDesktopMedia()

chrome.desktopCapture.cancelChooseDesktopMedia(
  desktopMediaRequestId: number,
)

Blendet das Dialogfeld für die Desktop-Medienauswahl aus, das von ChooseDesktopMedia() angezeigt wird.

Parameter

  • desktopMediaRequestId

    Zahl

    Von selectDesktopMedia() zurückgegebene ID

chooseDesktopMedia()

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

Zeigt die Benutzeroberfläche der Media-Auswahl auf dem Computer mit dem angegebenen Satz von Quellen an

Parameter

  • Satz von Quellen, die dem Nutzer angezeigt werden sollen. Die Reihenfolge der Quellen im Satz bestimmt die TAB-Reihenfolge in der Auswahl.

  • targetTab

    Tabulatortaste optional

    Optionaler Tab, für den der Stream erstellt wird. Wenn nicht angegeben, kann der resultierende Stream nur von der Anruferweiterung verwendet werden. Der Stream kann nur von Frames im jeweiligen Tab verwendet werden, deren Sicherheitsherkunft tab.url entspricht. Der Ursprung des Tabs muss ein sicherer Ursprung sein, z.B. HTTPS

  • callback

    Funktion

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

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

    • streamId

      String

      Ein intransparenter String, der an die getUserMedia() API übergeben werden kann, um einen Medienstream zu generieren, der der vom Nutzer ausgewählten Quelle entspricht. Wenn der Nutzer keine Quelle ausgewählt hat (d.h. die Aufforderung abgebrochen hat), wird der Callback mit einem leeren streamId-Element aufgerufen. Die erstellte streamId kann nur einmal verwendet werden und läuft nach einigen Sekunden ab, wenn sie nicht verwendet wird.

    • Optionen

      Objekt

      Chrome 57 und höher

      Enthält Eigenschaften, die den Stream beschreiben.

      • canRequestAudioTrack

        boolean

        „True“, wenn „Audio“ ist in Parameterquellen enthalten und der Endnutzer entfernt das Häkchen neben „Audio teilen“ nicht. . Andernfalls „false“. In diesem Fall sollte nicht über den Aufruf „getUserMedia“ nach dem Audiostream gefragt werden.

Gibt Folgendes zurück:

  • Zahl

    Eine ID, die an „cancelSelectDesktopMedia()“ übergeben werden kann, falls die Aufforderung abgebrochen werden muss.