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

  • 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.