chrome.desktopCapture

Beschrijving

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

Machtigingen

desktopCapture

Soorten

DesktopCaptureSourceType

Enum wordt gebruikt om een ​​set desktopmediabronnen te definiëren die worden gebruikt in ChooseDesktopMedia().

Enum

"scherm"

"raam"

"tabblad"

"audio"

SelfCapturePreferenceEnum

Chroom 107+

Spiegels SelfCapturePreferenceEnum .

Enum

"erbij betrekken"

"uitsluiten"

SystemAudioPreferenceEnum

Chroom 105+

Spiegels SysteemAudioVoorkeurEnum .

Enum

"erbij betrekken"

"uitsluiten"

Methoden

cancelChooseDesktopMedia()

chrome.desktopCapture.cancelChooseDesktopMedia(
  desktopMediaRequestId: number,
)

Verbergt het dialoogvenster voor de mediakiezer op het bureaublad, weergegeven door ChooseDesktopMedia().

Parameters

• desktopMediaRequestId

  nummer

  Id geretourneerd door ChooseDesktopMedia()

chooseDesktopMedia()

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

Toont de gebruikersinterface van de desktopmediakiezer met de opgegeven set bronnen.

Parameters

• bronnen

  DesktopCaptureSourceType []

  Set bronnen die aan de gebruiker moeten worden getoond. De volgorde van de bronnen in de set bepaalt de tabvolgorde in de kiezer.

• doelTabblad

  Tabblad optioneel

  Optioneel tabblad waarvoor de stream is gemaakt. Als dit niet is opgegeven, kan de resulterende stream alleen worden gebruikt door het bellende toestel. De stream kan alleen worden gebruikt door frames op het gegeven tabblad waarvan de beveiligingsoorsprong overeenkomt met tab.url . De oorsprong van het tabblad moet een veilige oorsprong zijn, bijvoorbeeld HTTPS.

• terugbellen

  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 enkele bron heeft geselecteerd (dat wil zeggen 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 wanneer deze niet wordt gebruikt.

  • opties

    voorwerp

    Chroom 57+

    Bevat eigenschappen die de stream beschrijven.

    • kanAudioTrack aanvragen

      Booleaans

      Waar als 'audio' is opgenomen in parameterbronnen en de eindgebruiker het selectievakje 'Audio delen' niet uitschakelt. Anders niet waar, en in dit geval zou men niet om een ​​audiostream moeten vragen via de getUserMedia-oproep.

Retouren

• nummer

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