MediaCapture.GetPreviewFrameAsync Método
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
| GetPreviewFrameAsync() |
Obtiene un marco de vista previa del dispositivo de captura. |
| GetPreviewFrameAsync(VideoFrame) |
Obtiene un marco de vista previa del dispositivo de captura, copiado en el VideoFrame de destino proporcionado y convertido en el formato del marco de destino. |
Obtiene un marco de vista previa del dispositivo de captura.
public:
virtual IAsyncOperation<VideoFrame ^> ^ GetPreviewFrameAsync() = GetPreviewFrameAsync;/// [Windows.Foundation.Metadata.Overload("GetPreviewFrameAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<VideoFrame> GetPreviewFrameAsync();[Windows.Foundation.Metadata.Overload("GetPreviewFrameAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<VideoFrame> GetPreviewFrameAsync();function getPreviewFrameAsync()Public Function GetPreviewFrameAsync () As IAsyncOperation(Of VideoFrame)Devoluciones
Una operación asincrónica que devuelve un VideoFrame al completarse correctamente.
- Atributos
Requisitos de Windows
| Características de aplicaciones |
backgroundMediaRecording
|
Comentarios
Este método devuelve el marco de vista previa en el formato actual del dispositivo de captura sin copiar ni convertir el fotograma. Para obtener el fotograma de vista previa en otro formato, use la sobrecarga GetPreviewFrameAsync(VideoFrame) y pase un VideoFrame con el formato deseado.
Para obtener instrucciones de procedimientos sobre fotogramas de vista previa, consulte Obtención de un marco de vista previa.
Nota
En escenarios de aplicación que llaman a capturar un gran número de fotogramas en una secuencia, como escenarios de Computer Vision, se recomienda usar la clase MediaFrameReader en lugar de GetPreviewFrameAsync. Para obtener más información y instrucciones paso a paso, vea Procesar fotogramas multimedia con MediaFrameReader.
Consulte también
Se aplica a
WinRT Build 26100 y otras versiones
| Producto | Versiones |
|---|---|
| WinRT | Build 10240, Build 10586, Build 14383, Build 15063, Build 16299, Build 17134, Build 17763, Build 18362, Build 19041, Build 20348, Build 22000, Build 22621, Build 26100 |
Obtiene un marco de vista previa del dispositivo de captura, copiado en el VideoFrame de destino proporcionado y convertido en el formato del marco de destino.
public:
virtual IAsyncOperation<VideoFrame ^> ^ GetPreviewFrameAsync(VideoFrame ^ destination) = GetPreviewFrameAsync;/// [Windows.Foundation.Metadata.Overload("GetPreviewFrameCopyAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<VideoFrame> GetPreviewFrameAsync(VideoFrame const& destination);[Windows.Foundation.Metadata.Overload("GetPreviewFrameCopyAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<VideoFrame> GetPreviewFrameAsync(VideoFrame destination);function getPreviewFrameAsync(destination)Public Function GetPreviewFrameAsync (destination As VideoFrame) As IAsyncOperation(Of VideoFrame)Parámetros
- destination
- VideoFrame
Fotograma de vídeo en el que se copiará el fotograma de vista previa.
Devoluciones
Una operación asincrónica que devuelve un VideoFrame al completarse correctamente.
- Atributos
Requisitos de Windows
| Características de aplicaciones |
backgroundMediaRecording
|
Comentarios
Para obtener un marco de vista previa sin pasar por una operación de copia o conversión, use la sobrecarga sin argumentos de GetPreviewFrameAsync.
Para obtener instrucciones de procedimientos sobre fotogramas de vista previa, consulte Obtención de un marco de vista previa.
Nota
En escenarios de aplicación que llaman a capturar un gran número de fotogramas en una secuencia, como escenarios de Computer Vision, se recomienda usar la clase MediaFrameReader en lugar de GetPreviewFrameAsync. Para obtener más información y instrucciones paso a paso, vea Procesar fotogramas multimedia con MediaFrameReader.
Consulte también
Se aplica a
WinRT Build 26100 y otras versiones
| Producto | Versiones |
|---|---|
| WinRT | Build 10240, Build 10586, Build 14383, Build 15063, Build 16299, Build 17134, Build 17763, Build 18362, Build 19041, Build 20348, Build 22000, Build 22621, Build 26100 |