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	在支援此功能的裝置上擷取進階相片作業的參考相片時引發。

另請參閱

• PrepareAdvancedPhotoCaptureAsync(ImageEncodingProperties)
• 高動態範圍 (HDR) 和弱光相片擷取