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”
Enum
“incluir”
“excluir”
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
-
fuentes
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 unstreamId
vacío. ElstreamId
creado solo se puede usar una vez y vence después de unos segundos cuando no se usa. -
opciones
objeto
Chrome 57 y versiones posterioresContiene 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.