通过

AdvancedPhotoCapture 类

  • 参考

定义

命名空间:
Windows.Media.Capture
编辑

提供使用系统提供的计算摄影技术捕获照片的方法。

public ref class AdvancedPhotoCapture sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class AdvancedPhotoCapture final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class AdvancedPhotoCapture
Public NotInheritable Class AdvancedPhotoCapture
继承
Object Platform::Object IInspectable AdvancedPhotoCapture
属性
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 要求

设备系列
Windows 10 (在 10.0.10240.0 中引入)
API contract
Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

注解

通过调用 MediaCapture.PrepareAdvancedPhotoCaptureAsync 获取此类的实例。

有关使用 AdvancedPhotoCapture 的操作指南，请参阅 高动态范围 (HDR) 和弱光照片捕获。

注意

从 Windows 10 版本 1709 开始，支持录制视频并同时使用 AdvancedPhotoCapture。 以前的版本不支持这一点。 此更改意味着可以同时拥有准备好的 LowLagMediaRecording 和 AdvancedPhotoCapture。 可以在调用 MediaCapture.PrepareAdvancedPhotoCaptureAsync 和 AdvancedPhotoCapture.FinishAsync 之间开始或停止录制视频。 还可以在录制视频时调用 AdvancedPhotoCapture.CaptureAsync。 但是，某些 AdvancedPhotoCapture 方案（如在录制视频时捕获 HDR 照片）会导致某些视频帧被 HDR 捕获更改，从而导致用户体验不佳。 因此，由 AdvancedPhotoControl.SupportedModes 返回的模式列表在录制视频时将会有所不同。 在开始或停止视频录制后，应该立即检查此值，以确保在当前的视频录制状态下支持所需的模式。

方法

CaptureAsync()

异步执行高级照片捕获。
CaptureAsync(Object)

异步执行高级照片捕获，将提供的应用定义上下文对象传递给操作的结果。
FinishAsync()

异步释放高级照片捕获操作使用的 AdvancedPhotoCapture 对象和资源。

事件

AllPhotosCaptured

当高级照片捕获所需的所有帧都已捕获时发生。
OptionalReferencePhotoCaptured

在支持此功能的设备上捕获高级照片操作的参考照片时引发。

适用于

另请参阅