MediaCapture.GetPreviewFrameAsync 方法

定义

重载

GetPreviewFrameAsync()

从捕获设备获取预览帧。

GetPreviewFrameAsync(VideoFrame)

从捕获设备获取预览帧,并将其复制到提供的目标 VideoFrame 并转换为目标帧的格式。

GetPreviewFrameAsync()

从捕获设备获取预览帧。

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)

返回

成功完成时返回 VideoFrame 的异步操作。

属性

Windows 要求

应用功能
backgroundMediaRecording

注解

此方法以捕获设备的当前格式返回预览帧,而无需复制或转换帧。 若要获取其他格式的预览帧,请使用 GetPreviewFrameAsync (VideoFrame) 重载并传入具有所需格式的 VideoFrame

有关预览帧的操作指南,请参阅 获取预览帧

注意

对于需要按序列捕获大量帧的应用方案(例如计算机视觉方案),建议使用 MediaFrameReader 类而不是 GetPreviewFrameAsync。 有关详细信息和操作指南,请参阅 使用 MediaFrameReader 处理媒体帧

另请参阅

适用于

GetPreviewFrameAsync(VideoFrame)

从捕获设备获取预览帧,并将其复制到提供的目标 VideoFrame 并转换为目标帧的格式。

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)

参数

destination
VideoFrame

将预览帧复制到的视频帧。

返回

成功完成时返回 VideoFrame 的异步操作。

属性

Windows 要求

应用功能
backgroundMediaRecording

注解

若要在不执行复制或转换操作的情况下获取预览帧,请使用 GetPreviewFrameAsync 的 no 参数重载。

有关预览帧的操作指南,请参阅 获取预览帧

注意

对于需要按序列捕获大量帧的应用方案(例如计算机视觉方案),建议使用 MediaFrameReader 类而不是 GetPreviewFrameAsync。 有关详细信息和操作指南,请参阅 使用 MediaFrameReader 处理媒体帧

另请参阅

适用于