chrome.desktopCapture

Vernieuwingsdatum: 2026-09-25 robots: noindex

Beschrijving

De Desktop Capture API legt de inhoud van het scherm, afzonderlijke vensters of afzonderlijke tabbladen vast.

Toestemmingen

desktopCapture

Soorten

DesktopCaptureSourceType

Enum gebruikt om de set desktopmediabronnen te definiëren die worden gebruikt in chooseDesktopMedia().

Enum

"scherm"

"raam"

"tab"

"audio"

SelfCapturePreferenceEnum

Chrome 107+

Spiegelt SelfCapturePreferenceEnum .

Enum

"erbij betrekken"

"uitsluiten"

SystemAudioPreferenceEnum

Chrome 105+

Spiegelt SystemAudioPreferenceEnum .

Enum

"erbij betrekken"

"uitsluiten"

WindowAudioPreferenceEnum

Chrome 140+

Spiegelt WindowAudioPreferenceEnum .

Enum

"systeem"

"raam"

"uitsluiten"

Methoden

cancelChooseDesktopMedia()

chrome.desktopCapture.cancelChooseDesktopMedia(
  desktopMediaRequestId: number,
): void

Verbergt het dialoogvenster voor het selecteren van bureaubladmedia dat wordt weergegeven door chooseDesktopMedia().

Parameters

  • desktopMediaRequestId

    nummer

    ID geretourneerd door chooseDesktopMedia()

chooseDesktopMedia()

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

Toont de gebruikersinterface van de mediakiezer op het bureaublad met de opgegeven set bronnen.

Parameters

  • Een set bronnen die aan de gebruiker getoond moeten worden. De volgorde van de bronnen in de set bepaalt de tabvolgorde in de selectietool.

  • doelTab

    Tab optioneel

    Optioneel tabblad waarvoor de stream wordt aangemaakt. Indien niet gespecificeerd, kan de resulterende stream alleen worden gebruikt door de aanroepende extensie. De stream kan alleen worden gebruikt door frames in het opgegeven tabblad waarvan de beveiligingsoorsprong overeenkomt tab.url . De oorsprong van het tabblad moet een beveiligde oorsprong zijn, bijvoorbeeld HTTPS.

  • terugbelverzoek

    functie

    De callback parameter ziet er als volgt uit: 

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

    • streamId

      snaar

      Een ondoorzichtige tekenreeks die kan worden doorgegeven aan getUserMedia() API om een ​​mediastream te genereren die overeenkomt met de door de gebruiker geselecteerde bron. Als de gebruiker geen bron heeft geselecteerd (d.w.z. de prompt heeft geannuleerd), wordt de callback aangeroepen met een lege streamId . De aangemaakte streamId kan slechts één keer worden gebruikt en vervalt na enkele seconden als deze niet wordt gebruikt.

    • opties

      voorwerp

      Chrome 57+

      Bevat eigenschappen die de stream beschrijven.

      • canRequestAudioTrack

        booleaans

        Retourneert True als "audio" is opgenomen in de parameterbronnen en de eindgebruiker het selectievakje "Audio delen" niet heeft uitgeschakeld. Anders retourneert het False, en in dat geval moet men geen audiostream opvragen via de getUserMedia-aanroep.

Retourneert

  • nummer

    Een ID die kan worden doorgegeven aan cancelChooseDesktopMedia() voor het geval de prompt moet worden geannuleerd.