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 un ensemble de sources multimédias pour ordinateur de bureau utilisées dans chooseDesktopMedia().

Enum

"screen"

"window"

"tab"

"audio"

SelfCapturePreferenceEnum

Chrome 107 et versions ultérieures

Reflète SelfCapturePreferenceEnum.

Enum

SystemAudioPreferenceEnum

Chrome 105 et versions ultérieures

Reflète SystemAudioPreferenceEnum.

Enum

Méthodes

cancelChooseDesktopMedia()

chrome.desktopCapture.cancelChooseDesktopMedia(
  desktopMediaRequestId: number,
)

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

Paramètres

  • desktopMediaRequestId

    number

    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 pour ordinateur avec l'ensemble de sources spécifié.

Paramètres

  • Ensemble de sources à montrer à 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 une origine sécurisée (HTTPS, par exemple).

  • rappel

    function

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

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

    • streamId

      chaîne

      Chaîne opaque pouvant ê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. Le 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 57 et versions ultérieures

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

      • canRequestAudioTrack

        boolean

        "True" si "audio" est inclus dans les sources de paramètres et que l'utilisateur final ne décochez pas la case "Partager l'audio". Dans le cas contraire, cette valeur est "false", et dans ce cas, il ne faut pas demander de flux audio via l'appel getUserMedia.

Renvoie

  • number

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