chrome.desktopCapture

Description

L'API Desktop Capture capture le contenu de l'écran, des fenêtres ou des onglets individuels.

Autorisations

desktopCapture

Types

DesktopCaptureSourceType

Énumération utilisée pour définir l'ensemble des sources multimédias pour ordinateur de bureau utilisées dans chooseDesktopMedia().

Énumération

"écran"

"fenêtre"

"tabulation"

"audio"

SelfCapturePreferenceEnum

Chrome 107 ou version ultérieure

Reflète SelfCapturePreferenceEnum.

Énumération

"inclure"

"exclure"

SystemAudioPreferenceEnum

Chrome 105 ou version ultérieure

Reflète SystemAudioPreferenceEnum.

Énumération

"inclure"

"exclure"

Méthodes

cancelChooseDesktopMedia()

chrome.desktopCapture.cancelChooseDesktopMedia(
  desktopMediaRequestId: number,
)

Masque la boîte de dialogue du sélecteur de fichiers multimédias pour ordinateur de bureau affichée par chooseDesktopMedia().

Paramètres

  • desktopMediaRequestId

    Nombre

    ID renvoyé par chooseDesktopMedia()

chooseDesktopMedia()

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

Affiche l'interface utilisateur du sélecteur de fichiers multimédias sur ordinateur avec l'ensemble de sources spécifié.

Paramètres

  • Ensemble de sources à présenter à l'utilisateur. L'ordre des sources dans l'ensemble détermine l'ordre de tabulation dans le sélecteur.

  • targetTab

    Tabulation facultatif

    Onglet facultatif pour lequel le flux est créé. S'il n'est pas spécifié, le flux obtenu ne peut être utilisé que par l'extension d'appel. Le flux ne peut être utilisé que par les frames de l'onglet donné dont l'origine de sécurité correspond à tab.url. L'origine de l'onglet doit être sécurisée (par exemple, HTTPS

  • rappel

    fonction

    Le paramètre callback se présente comme suit: 

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

    • streamId

      chaîne

      Chaîne opaque qui peut être transmise à l'API getUserMedia() pour générer un flux multimédia correspondant à la source sélectionnée par l'utilisateur. Si l'utilisateur n'a sélectionné aucune source (c'est-à-dire qu'il a annulé l'invite), le rappel est appelé avec une streamId vide. L'objet streamId créé ne peut être utilisé qu'une seule fois et expire au bout de quelques secondes lorsqu'il n'est pas utilisé.

    • options

      objet

      Chrome (version 57 ou ultérieure)

      Contient les propriétés qui décrivent le flux.

      • canRequestAudioTrack

        booléen

        Vrai si "audio" est incluse dans les sources des paramètres, et l'utilisateur final ne peut pas décocher la case "Partager l'audio". . Sinon, il est préférable de ne pas demander le flux audio via l'appel getUserMedia.

Renvoie

  • Nombre

    ID qui peut être transmis à cancelChooseDesktopMedia() si l'invite doit être annulée.