SceneAnalysisEffect 類別

定義

命名空間:

Windows.Media.Core

表示分析視訊畫面的效果，以判斷是否有任何支援的可變相片序列擷取技術可能會產生高品質擷取的影像。

public ref class SceneAnalysisEffect 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 SceneAnalysisEffect 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 SceneAnalysisEffect

Public NotInheritable Class SceneAnalysisEffect

繼承

Object Platform::Object IInspectable SceneAnalysisEffect

屬性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

實作

IMediaExtension

Windows 需求

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

備註

將 SceneAnalysisEffectDefinition 物件傳遞至 MediaCapture.AddVideoEffectAsync，以取得這個類別的實例。

就像其他效果一樣，場景分析器效果會藉由呼叫 AddEffectAsync新增至擷取管線。 啟動擷取之後，會引發 SceneAnalyzed 事件。 在此事件的處理常式中，您可以存取輸出物件，指出特定技術將改善所擷取影像的可能性。 輸出物件也會提供一組 FrameController 物件，其中包含建議的設定，可直接指派給 VariablePhotoSequenceController.DesiredFrameControllers 集合，以啟用擷取技術。

在目前版本中，唯一支援的分析器是 HIGH Dynamic Range (HDR) 分析器。

如需使用 SceneAnalysisEffect的作法指引，請參閱 MediaCapture 的場景 anlysis。

屬性

DesiredAnalysisInterval	取得或設定分析視訊畫面的時間範圍持續時間。
HighDynamicRangeAnalyzer	取得 HighDynamicRangeControl 物件，用來啟用或停用 High Dynamic Range (HDR) 分析。

方法

SetProperties(IPropertySet)

設定 IMediaExtension上的屬性。

事件

SceneAnalyzed

場景分析完成時引發。 請參閱 SceneAnalyzedEventArgs

另請參閱

• IMediaExtension
• VariablePhotoSequenceController
• AddEffectAsync(MediaStreamType, String, IPropertySet)
• MediaCapture 的場景分析