chrome.desktopCapture

Descripción

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

Permisos

desktopCapture

Tipos

DesktopCaptureSourceType

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

Enum

"window"

SelfCapturePreferenceEnum

Chrome 107 y versiones posteriores

Duplica SelfCapturePreferenceEnum.

Enum

SystemAudioPreferenceEnum

Chrome 105 y versiones posteriores

Duplica SystemAudioPreferenceEnum.

Enum

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 devuelto por chooseDesktopMedia()

chooseDesktopMedia()

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

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

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 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 de llamada puede usar la transmisión resultante. Solo los marcos de una pestaña determinada cuyo origen de seguridad coincida con tab.url pueden usar la transmisión. El origen de la pestaña debe ser un origen seguro, p.ej., HTTPS.

  • callback

    la función

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

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

    • streamId

      cadena

      Es una cadena opaca que se puede pasar a la API de getUserMedia() para generar flujos multimedia que corresponden a 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 el flujo.

      • canRequestAudioTrack

        boolean

        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 getUserMedia.

Devuelve

  • número

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