LowLagPhotoSequenceCapture 類別

  • 參考

定義

命名空間:
Windows.Media.Capture
編輯

提供快速取得低快門延遲相片序列的方法。

public ref class LowLagPhotoSequenceCapture sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
class LowLagPhotoSequenceCapture final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
public sealed class LowLagPhotoSequenceCapture
Public NotInheritable Class LowLagPhotoSequenceCapture
繼承
Object Platform::Object IInspectable LowLagPhotoSequenceCapture
屬性
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 需求

裝置系列
Windows 10 (已於 10.0.10240.0 引進)
API contract
Windows.Foundation.UniversalApiContract (已於 v1.0 引進)

備註

相片順序模式會採用快速的相片序列。 相片序列的主要案例是在使用者拍攝相片之前取得相片。 如果您想要擷取一系列具有不同設定的相片，例如曝光或快閃，請使用 VariablePhotoSequenceCapture。

您可以透過MediaCapture.VideoDeviceController存取擷取裝置的LowLagPhotoSequenceControl。 LowLagPhotoSequenceControl 可用來管理與相片順序會話相關的設定。

您可以檢查 LowLagPhotoSequenceControl.Supported來瞭解裝置是否支援相片序列模式。

使用 MediaCapture.PrepareLowLagPhotoSequenceCaptureAsync 初始化相片序列擷取。 這是非同步呼叫，會在完成時傳回 LowLagPhotoSequenceCapture 物件。 這必須在 StartAsync之前呼叫。

若要開始擷取相片，請呼叫 StartAsync。 應用程式會繼續從裝置接收相片，直到作業停止為止。

StopAsync 會停止作業，可使用 StartAsync重新開機。

將處理常式新增至 PhotoCaptured 事件，以取得序列中擷取的相片。 PhotoCapturedEventArgs 會提供所擷取畫面格的資料。 PhotoCapturedEventArgs.Frame 包含擷取的相片， 而 PhotoCapturedEventArgs.Thumbnail 則包含縮圖。

FinishAsync 會停止相片序列擷取作業，並釋放相片順序作業所使用的 LowLagPhotoSequenceCapture 物件和資源。 如果您想要在呼叫 FinishAsync之後重新開機相片序列作業，您必須呼叫 MediaCapture.PrepareLowLagPhotoSequenceCaptureAsync，以初始化新的 LowLagPhotoSequenceCapture 物件。

如果媒體類型變更或新增效果，您必須呼叫 MediaCapture.PrepareLowLagPhotoSequenceCaptureAsync 來建立新的 LowLagPhotoCapture 物件。

LowLagPhotoSequenceControl.GetCurrentFrameRate 會指定拍攝相片的畫面播放速率。

PhotoCapturedEventArgs.CaptureTimeOffset 可用來判斷框架是否在未來、大於 0 或過去小於 0。

如果應用程式想要限制每秒取得的畫面數，可以使用 LowLagPhotoSequenceControl.PhotosPerSecondLimit。 這在裝置上的感應器可以處理 30fps 的情況下很有用，但應用程式只需要 4fps。

若要啟用縮圖，請將 LowLagPhotoSequenceControl.ThumbnailEnabled 設定為 true。

您可以透過 LowLagPhotoSequenceControl.DesiredThumbnailSize 設定所需的縮圖大小，並透過 LowLagPhotoSequenceControl.ThumbnailFormat設定縮圖格式。

過去相片的數目不能超過 LowLagPhotoSequenceControl.MaxPastPhotos，這是驅動程式支援的過去相片數目上限。 傳回的過去相片數目會是下列值的較小值： LowLagPhotoSequenceControl.PastPhotoLimit、 LowLagPhotoSequenceControl.MaxPastPhotos或目前可用的過去相片數目。

方法

FinishAsync()

以非同步方式釋放 Photo 序列擷取作業所使用的 LowLagPhotoSequenceCapture 物件和資源。
StartAsync()

以非同步方式開始擷取相片。
StopAsync()

以非同步方式停止擷取相片。

事件

PhotoCaptured

發生于擷取相片時。

適用於

另請參閱