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

Enum que se usa para definir el conjunto de fuentes de contenido multimedia de escritorio que se usan en chooseDesktopMedia().

Enum

“pantalla”

“ventana”

“pestaña”

“audio”

SelfCapturePreferenceEnum

Chrome 107 y versiones posteriores

Duplica SelfCapturePreferenceEnum.

Enum

“incluir”

“excluir”

SystemAudioPreferenceEnum

Chrome 105 y versiones posteriores

Duplica SystemAudioPreferenceEnum.

Enum

“incluir”

“excluir”

Métodos

cancelChooseDesktopMedia()

chrome.desktopCapture.cancelChooseDesktopMedia(
  desktopMediaRequestId: number,
)

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

Parámetros

  • desktopMediaRequestId

    número

    ID que muestra ChooseDesktopMedia()

chooseDesktopMedia()

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

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

Parámetros

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

  • targetTab

    Pestaña 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 pueden usar la transmisión los fotogramas de la pestaña correspondiente cuyo origen de seguridad coincida con tab.url. El origen de la pestaña debe ser un origen 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 se corresponda con la fuente que seleccionó 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 cuando no se usa.

    • opciones

      objeto

      Chrome 57 y versiones posteriores

      Contiene propiedades que describen la transmisión.

      • canRequestAudioTrack

        boolean

        Verdadero si es "audio" se incluye en fuentes de parámetros, y el usuario final no desmarca la opción "Compartir audio". . De lo contrario, es falso y, en este caso, no se debería solicitar una transmisión de audio a través de la llamada getUserMedia.

Muestra

  • número

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