WindowCapture QML Type
Este tipo se utiliza para capturar una ventana. Más información...
| Import Statement: | import QtMultimedia |
| Since: | Qt 6.6 |
| In C++: | QWindowCapture |
Propiedades
- active : bool
- error : enumeration
- errorString : string
- maximumFrameRate : real
(since 6.12) - window : Window
Señales
- errorChanged()
- errorOccurred(int error, string errorString)
Métodos
- list<CapturableWindow> capturableWindows()
- void start()
- void stop()
Descripción detallada
WindowCapture captura una ventana. Se gestiona mediante CaptureSession, donde la ventana capturada se puede visualizar en un objeto de vista previa de vídeo o grabarse en un archivo.
El código siguiente muestra una sesión de captura sencilla que captura una de las ventanas disponibles con WindowCapture y la reproduce en un objeto VideoOutput.
CaptureSession {
id: captureSession
windowCapture: WindowCapture {
id: capture
}
videoOutput: VideoOutput {
id: videoOutput
}
Component.onCompleted: {
let windows = capture.capturableWindows()
if (windows.length > 0) {
capture.window = windows[0]
capture.active = true
}
}
}Limitaciones de WindowCapture
El uso de WindowCapture está sujeto a las siguientes limitaciones:
- WindowCapture solo es compatible con el backend de FFmpeg.
- En algunas plataformas, no se emiten nuevos fotogramas de vídeo mientras el contenido de la ventana capturada permanece inalterado. Por lo tanto, las aplicaciones no deben dar por sentado que recibirán un flujo continuo de fotogramas a la frecuencia de fotogramas solicitada.
Se aplican las siguientes limitaciones al utilizar « QWindowCapture » en sistemas X11:
- En los sistemas Linux X11, cuando una ventana se desplaza parcialmente fuera del área visible de la pantalla, solo se captura la región visible. Como resultado, los fotogramas de vídeo emitidos pueden tener un tamaño inferior al de la geometría de la ventana.
- Las ventanas que se encuentran fuera del área visible de la pantalla no se pueden capturar, y en ese caso se emite una señal de error.
- El comportamiento de las ventanas minimizadas o de aquellas situadas en un espacio de trabajo virtual invisible depende del gestor de ventanas. Por ejemplo, estas ventanas se pueden capturar en GNOME, mientras que en WindowMaker o Xfwm no se permite dicha captura, y la instancia de captura de ventanas emite un error.
Véase también CaptureSession y CapturableWindow.
Documentación de propiedades
active : bool
Indica si la captura está activa en este momento.
Véase también start() y stop().
error : enumeration [read-only]
Devuelve el código del último error.
| Constante | Descripción |
|---|---|
WindowCapture.NoError | Sin error |
WindowCapture.InternalError | Error interno del controlador de captura de ventanas |
WindowCapture.CapturingNotSupported | La captura de ventanas no es compatible |
WindowCapture.CaptureFailed | Error al capturar la ventana |
WindowCapture.NotFound | No se ha encontrado la ventana seleccionada |
errorString : string [read-only]
Devuelve una cadena legible para el usuario que describe la causa del error.
maximumFrameRate : real [since 6.12]
El límite máximo de la frecuencia de fotogramas de captura de ventana.
Este valor se puede configurar para anular la frecuencia de fotogramas de captura utilizada por defecto en función, por ejemplo, de la frecuencia de actualización de la pantalla, pero solo como límite máximo, ya que la captura de ventanas genera fotogramas a una frecuencia variable. No se recomienda establecer este valor por encima de la frecuencia de actualización de la pantalla, ya que puede provocar errores.
Si se establece en -1, se utiliza un valor predeterminado que depende de la plataforma.
Cualquier cambio en esta propiedad se aplica la próxima vez que el « WindowCapture » se active.
Esta propiedad se introdujo en Qt 6.12.
window : Window
Describe la ventana en la que se realiza la captura.
Si se establece esta propiedad en una ventana no válida de un « WindowCapture » activo, este pasará a estar inactivo y generará un error.
Véase también ` capturableWindows`.
Documentación de Signal
errorChanged()
Esta señal se emite cuando se modifican las propiedades « error » o « errorString ».
Esta señal no se emite cuando se producen varios errores idénticos. Para realizar un seguimiento de dichos errores, utiliza la señal errorOccurred.
Nota: El controlador correspondiente es onErrorChanged.
errorOccurred(int error, string errorString)
Avisa cuando se produce un error de « error », junto con el « errorString ».
En cuanto al parámetro «error», consulta la tabla de enumeración en error para ver qué valores se pueden pasar.
Nota: El controlador correspondiente es onErrorOccurred.
Véase también error.
Documentación del método
list<CapturableWindow> capturableWindows()
Devuelve una lista de objetos ` CapturableWindow ` que están disponibles actualmente para la captura.
Nota: En macOS, al invocar este método se abrirá el cuadro de diálogo de permisos «Grabación de pantalla». Si aún no se han concedido los permisos, este método devolverá una lista vacía. Si se invoca varias veces, este cuadro de diálogo aparecerá en primer plano.
void start()
Comienza a capturar el window.
Esto equivale a establecer la propiedad « active » en « true ».
void stop()
Detiene la captura.
Esto equivale a establecer la propiedad « active » en « false ».
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.