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 未満であったかを確認できます。

アプリで 1 秒あたりのフレーム数を制限する場合は、 LowLagPhotoSequenceControl.PhotosPerSecondLimit を使用できます。 これは、デバイス上のセンサーが 30fps を処理できるが、アプリで 4fps しか必要とできない状況で役立ちます。

サムネイルを有効にするには、 LowLagPhotoSequenceControl.ThumbnailEnabled を true に設定 します。

LowLagPhotoSequenceControl.DesiredThumbnailSize を使用して目的のサムネイル サイズを設定し、LowLagPhotoSequenceControl.ThumbnailFormat を使用してサムネイル形式を設定できます。

過去の写真の数は LowLagPhotoSequenceControl.MaxPastPhotos を超えることはできません。これは、ドライバーによってサポートされている過去の写真の最大数です。 返される過去の写真の数は、 LowLagPhotoSequenceControl.PastPhotoLimit、 LowLagPhotoSequenceControl.MaxPastPhotos、または現在使用可能な過去の写真の数の小さい値になります。

メソッド

FinishAsync()

写真シーケンス キャプチャ操作で使用される LowLagPhotoSequenceCapture オブジェクトとリソースを非同期的に解放します。
StartAsync()

写真のキャプチャを非同期的に開始します。
StopAsync()

写真のキャプチャを非同期的に停止します。

イベント

PhotoCaptured

写真がキャプチャされたときに発生します。

適用対象

こちらもご覧ください