chrome.desktopCapture

Descripción

La API de Desktop Capture captura el contenido de la pantalla, ventanas individuales o pestañas individuales.

Permisos

desktopCapture

Tipos

DesktopCaptureSourceType

Es un enum que se usa para definir el conjunto de fuentes de contenido multimedia para computadoras de escritorio que se usan en chooseDesktopMedia().

Enum

"screen"

"window"

"tab"

"audio"

SelfCapturePreferenceEnum

Chrome 107 y versiones posteriores

Duplica SelfCapturePreferenceEnum.

Enum

"include"

"exclude"

SystemAudioPreferenceEnum

Chrome 105 y versiones posteriores

Refleja SystemAudioPreferenceEnum.

Enum

"include"

"exclude"

Métodos

cancelChooseDesktopMedia()

chrome.desktopCapture.cancelChooseDesktopMedia(
  desktopMediaRequestId: number,
)

Oculta el diálogo del selector de contenido multimedia de escritorio que muestra chooseDesktopMedia().

Parámetros

  • desktopMediaRequestId

    número

    ID que devuelve chooseDesktopMedia().

chooseDesktopMedia()

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

Muestra la IU del selector de contenido multimedia para computadoras de escritorio con el conjunto de fuentes especificado.

Parámetros

  • Es un conjunto de fuentes que se deben mostrar al usuario. El orden de las fuentes en el conjunto determina el orden de tabulación en el selector.

  • targetTab

    Tab opcional

    Pestaña opcional para la que se crea la transmisión. Si no se especifica, solo la extensión que realiza la llamada puede usar la transmisión resultante. Solo los fotogramas de la pestaña determinada cuyo origen de seguridad coincida con tab.url pueden usar la transmisión. El origen de la pestaña debe ser seguro, p.ej., HTTPS.

  • callback

    función

    El parámetro callback se ve de la siguiente manera: 

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

    • streamId

      string

      Es una cadena opaca que se puede pasar a la API de getUserMedia() para generar una transmisión de contenido multimedia que corresponde a la fuente que seleccionó el usuario. Si el usuario no seleccionó ninguna fuente (es decir, canceló el mensaje), se llamará a la devolución de llamada con un streamId vacío. El streamId creado se puede usar solo una vez y vence después de unos segundos si no se usa.

    • opciones

      objeto

      Chrome 57 y versiones posteriores

      Contiene propiedades que describen la transmisión.

      • canRequestAudioTrack

        booleano

        Es verdadero si se incluye "audio" en las fuentes de parámetros y el usuario final no desmarca la casilla de verificación "Compartir audio". De lo contrario, es falso y, en este caso, no se debe solicitar la transmisión de audio a través de la llamada a getUserMedia.

Muestra

  • número

    Un ID que se puede pasar a cancelChooseDesktopMedia() en caso de que se deba cancelar la solicitud.