Ler em inglês

Compartilhar via


MediaCapture.GetPreviewFrameAsync Método

Definição

Sobrecargas

GetPreviewFrameAsync()

Obtém um quadro de visualização do dispositivo de captura.

GetPreviewFrameAsync(VideoFrame)

Obtém um quadro de visualização do dispositivo de captura, copiado para o VideoFrame de destino fornecido e convertido no formato do quadro de destino.

GetPreviewFrameAsync()

Obtém um quadro de visualização do dispositivo de captura.

[Windows.Foundation.Metadata.Overload("GetPreviewFrameAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<VideoFrame> GetPreviewFrameAsync();

Retornos

Uma operação assíncrona que retorna um VideoFrame após a conclusão bem-sucedida.

Atributos

Requisitos do Windows

Funcionalidades do aplicativo
backgroundMediaRecording

Comentários

Esse método retorna o quadro de visualização no formato atual do dispositivo de captura sem copiar ou converter o quadro. Para obter o quadro de visualização em outro formato, use a sobrecarga GetPreviewFrameAsync(VideoFrame) e passe um VideoFrame com o formato desejado.

Para obter diretrizes sobre quadros de visualização, consulte Obter um quadro de visualização.

Observação

Para cenários de aplicativo que exigem a captura de um grande número de quadros em uma sequência, como cenários de pesquisa visual computacional, é recomendável que você use a classe MediaFrameReader em vez de GetPreviewFrameAsync. Para obter mais informações e diretrizes de instruções, consulte Processar quadros de mídia com MediaFrameReader.

Confira também

Aplica-se a

GetPreviewFrameAsync(VideoFrame)

Obtém um quadro de visualização do dispositivo de captura, copiado para o VideoFrame de destino fornecido e convertido no formato do quadro de destino.

[Windows.Foundation.Metadata.Overload("GetPreviewFrameCopyAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<VideoFrame> GetPreviewFrameAsync(VideoFrame destination);

Parâmetros

destination
VideoFrame

O quadro de vídeo no qual o quadro de visualização será copiado.

Retornos

Uma operação assíncrona que retorna um VideoFrame após a conclusão bem-sucedida.

Atributos

Requisitos do Windows

Funcionalidades do aplicativo
backgroundMediaRecording

Comentários

Para obter um quadro de visualização sem passar por uma operação de cópia ou conversão, use a sobrecarga sem argumento de GetPreviewFrameAsync.

Para obter diretrizes sobre quadros de visualização, consulte Obter um quadro de visualização.

Observação

Para cenários de aplicativo que exigem a captura de um grande número de quadros em uma sequência, como cenários de pesquisa visual computacional, é recomendável que você use a classe MediaFrameReader em vez de GetPreviewFrameAsync. Para obter mais informações e diretrizes de instruções, consulte Processar quadros de mídia com MediaFrameReader.

Confira também

Aplica-se a