MediaCaptureVideoProfile 類別

  • 參考

定義

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

表示視訊設定檔，表示視訊擷取裝置支援的設定。

public ref class MediaCaptureVideoProfile 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 MediaCaptureVideoProfile 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 MediaCaptureVideoProfile
Public NotInheritable Class MediaCaptureVideoProfile
繼承
Object Platform::Object IInspectable MediaCaptureVideoProfile
屬性
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 需求

裝置系列
Windows 10 (已於 10.0.10240.0 引進)
API contract
Windows.Foundation.UniversalApiContract (已於 v1.0 引進)
應用程式功能
backgroundMediaRecording

備註

影片設定檔提供簡單的方法，可讓您使用一組保證使用特定擷取裝置的設定來設定視訊擷取裝置，並針對您想要的擷取案例進行優化。 系統針對常見案例提供一組已知的視訊設定檔，例如擷取高品質的相片或視訊、擷取相片序列或視訊會議。 若要取得指定視訊裝置的已知影片配置檔案清單，請使用 MediaCapture.FindKnownVideoProfiles。 有些硬體廠商可能會公開其他您可以透過呼叫 MediaCapture.FindAllVideoProfiles取得的視訊設定檔。

影片設定檔會公開三個 MediaCaptureVideoProfileMediaDescription 物件、 SupportedPhotoMediaDescription、 SupportedPreviewMediaDescription和 SupportedRecordMediaDescription的清單。 這些清單中的每個專案都是對應作業支援的一組設定。 例如，單一視訊設定檔可支援使用 HDR 視訊支援以 30 fps 錄製 720p 視訊，也支援在 30 fps 支援 HDR 視訊的情況下錄製 1080p 視訊。 在此情況下，其中每一個都會以影片設定檔SupportedRecordMediaDescription清單中的MediaCaptureVideoProfileMediaDescription物件來表示。

您可以使用 MediaCaptureInitializationSettings 物件，將擷取裝置設定為使用特定視訊設定檔。 設定裝置時所使用的視訊設定檔必須與其他初始化設定相容。 如需如何在 MediaCaptureInitializationSettings中正確使用媒體設定檔描述的詳細資訊，請參閱 MediaCaptureInitializationSettings.VideoProfile。

使用影片設定檔之前，您應該先檢查 MediaCapture.IsVideoProfileSupported 傳回的值，以確定擷取裝置支援視訊設定檔。

如需使用視訊設定檔的作法指引，請參閱 探索及選取相機設定檔的相機功能。

版本歷程記錄

Windows 版本 SDK 版本 新增值
1803 17134 FrameSourceInfos
1803 17134 屬性

屬性

FrameSourceInfos

取得 MediaFrameSourceInfo 物件的唯讀清單，其中提供 MediaFrameSource功能的詳細資料。
Id

取得影片設定檔的唯一識別碼。
Properties

取得擷取裝置製造商所提供的自訂屬性唯讀對應。
SupportedPhotoMediaDescription

取得 MediaCaptureVideoProfileMediaDescription 物件的清單，這些物件代表相片擷取支援的視訊裝置設定。
SupportedPreviewMediaDescription

取得 MediaCaptureVideoProfileMediaDescription 物件的清單，這些物件代表影片預覽支援的視訊裝置設定。
SupportedRecordMediaDescription

取得 MediaCaptureVideoProfileMediaDescription 物件的清單，這些物件代表影片錄製支援的視訊裝置設定。
VideoDeviceId

取得與影片設定檔相關聯之視訊裝置的裝置識別碼。

方法

GetConcurrency()

取得可以與此視訊設定檔同時使用的 MediaCaptureVideoProfile 物件清單。

適用於

另請參閱