VideoEncodingProperties 類別

定義

命名空間:

Windows.Media.MediaProperties

描述視訊資料流程的編碼屬性。

public ref class VideoEncodingProperties 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)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class VideoEncodingProperties 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)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class VideoEncodingProperties

function VideoEncodingProperties()

Public NotInheritable Class VideoEncodingProperties

繼承

Object Platform::Object IInspectable VideoEncodingProperties

屬性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

實作

IMediaEncodingProperties

Windows 需求

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

備註

從其中一個預設編碼設定檔建立的 VideoEncodingProperties 會忽略手動設定的屬性： CreateH264 和 CreateMpeg2。

編碼品質 Auto 是特殊的預設，會根據目前的相機設定填入適當的設定。 會忽略手動修改的設定。 例如，如果您使用一個靜態建立方法建立預設設定檔，例如 CreateM4a，並指定 Auto 做為編碼品質，則您對屬性所做的任何變更都會根據目前的相機設定以值覆寫。

注意

可以建立特定裝置不支援的 VideoEncodingProperties 。 例如，您可以成功呼叫 CreateH264，但如果裝置上沒有 h264 編碼器，則嘗試使用此方法傳回的屬性來編碼視訊將會失敗。 如需每個裝置系列預設存在的編解碼器清單，請參閱支援的編解碼器。

如需設定所擷取視訊編碼屬性的操作指南，請參閱 使用 MediaCapture 進行基本相片、視訊和音訊擷取。

版本歷程記錄

Windows 版本	SDK 版本	已新增值
1607	14393	StereoscopicVideoPackingMode
1703	15063	CreateHevc
1703	15063	SphericalVideoFrameFormat
1803	17134	複製

建構函式

VideoEncodingProperties()

建立 VideoEncodingProperties 類別的新實例。

屬性

Bitrate	取得或設定視訊位元速率。
FrameRate	取得或設定視訊畫面播放速率。
Height	取得或設定視訊影像高度。
PixelAspectRatio	取得或設定圖元外觀比例。
ProfileId	取得或設定媒體格式設定檔。
Properties	取得視訊資料流程的其他格式屬性。
SphericalVideoFrameFormat	取得值，指定視訊畫面的球面視訊格式。
StereoscopicVideoPackingMode	取得值，指出視訊資料流程的立體視訊封裝模式。
Subtype	取得或設定格式的子類型。
Type	取得格式類型。
Width	取得或設定視訊影像寬度。

方法

Copy()	建立 VideoEncodingProperties 物件的複本。
CreateAv1()	建立 AOMedia Video 1 (AV1) 視訊的 VideoEncodingProperties 實例。
CreateH264()	建立 H.264 影片的 VideoEncodingProperties 實例。
CreateHevc()	建立 VideoEncodingProperties 的實例，以進行高效能視訊編碼 (HEVC) 。
CreateMpeg2()	建立 MPEG-2 視 訊的 VideoEncodingProperties 實例。
CreateUncompressed(String, UInt32, UInt32)	為未壓縮的視 訊建立 VideoEncodingProperties 的實例。
CreateVp9()	建立 VP9 影片的 VideoEncodingProperties 實例。
GetFormatUserData(Byte[])	取得媒體格式使用者資料。
SetFormatUserData(Byte[])	設定媒體格式使用者資料。

另請參閱

• 使用 MediaCapture 進行基本相片、視訊和音訊的擷取