chrome.desktopCapture

Descripción

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

Permisos

desktopCapture

Tipos

DesktopCaptureSourceType

Es una enumeración que se usa para definir el conjunto de fuentes de medios de escritorio que se usan en chooseDesktopMedia().

Enum

"screen"

"window"

"tab"

"audio"

SelfCapturePreferenceEnum

Chrome 107 y versiones posteriores

Espejos SelfCapturePreferenceEnum.

Enum

"include"

"exclude"

SystemAudioPreferenceEnum

Chrome 105 y versiones posteriores

Refleja SystemAudioPreferenceEnum.

Enum

"include"

"exclude"

WindowAudioPreferenceEnum

Chrome 140 y versiones posteriores

Refleja WindowAudioPreferenceEnum.

Enum

"system"

"window"

"exclude"

Métodos

cancelChooseDesktopMedia()

chrome.desktopCapture.cancelChooseDesktopMedia(
  desktopMediaRequestId: number,
): void

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

Parámetros

  • desktopMediaRequestId

    número

    Es el ID que devuelve chooseDesktopMedia().

chooseDesktopMedia()

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

Muestra la IU del selector de medios de escritorio con el conjunto de fuentes especificado.

Parámetros

  • Es el conjunto de fuentes que se deben mostrar al usuario. El orden de las fuentes en el conjunto decide el orden de las pestañas en el selector.

  • targetTab

    Pestaña opcional

    Es la pestaña opcional para la que se crea la transmisión. Si no se especifica, la extensión que llama puede usar la transmisión resultante. El flujo solo lo pueden usar los marcos de la pestaña determinada cuya fuente de seguridad coincida con tab.url. 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 el flujo de medios que corresponde a la fuente seleccionada por el usuario. Si el usuario no seleccionó ninguna fuente (es decir, canceló el mensaje), se llama a la devolución de llamada con un streamId vacío. El streamId creado solo se puede usar 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 "audio" se incluye en las fuentes de parámetros y el usuario final no desmarca la casilla de verificación "Compartir audio". De lo contrario, será 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

    Es un ID que se puede pasar a cancelChooseDesktopMedia() en caso de que se deba cancelar el mensaje.