MediaEncodingProfile 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
描述音频或视频文件的编码配置文件。 编码配置文件包括音频和视频编码格式的说明以及媒体容器的说明。
public ref class MediaEncodingProfile sealed
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [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.MTA)]
class MediaEncodingProfile final
/// [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.MTA)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class MediaEncodingProfile final
[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[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.MTA)]
public sealed class MediaEncodingProfile
[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.MTA)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class MediaEncodingProfile
function MediaEncodingProfile()
Public NotInheritable Class MediaEncodingProfile
- 继承
- 属性
Windows 要求
设备系列 |
Windows 10 (在 10.0.10240.0 中引入)
|
API contract |
Windows.Foundation.UniversalApiContract (在 v1.0 中引入)
|
注解
编码质量 “自动 ”是一种特殊的预设,可根据当前相机设置填充正确的设置。 将忽略手动修改的设置。 例如,如果使用静态创建方法(例如 CreateM4a)创建预设配置文件,并将 “自动 ”指定为编码质量,则对属性所做的任何更改都将被基于当前相机设置的值覆盖。
注意
可以创建特定设备上不支持的 MediaEncodingProfile 。 例如,可以成功调用 CreateMp3,但如果设备上不存在 mp3 编码器,则尝试使用此方法返回的属性对音频进行编码将失败。 有关每个设备系列默认存在的编解码器的列表,请参阅支持的编解码器。
注意
只有视频编码配置文件类型支持“自动”的编码质量设置。音频配置文件不支持此设置,在使用此设置时将生成错误。 例如:如果使用 MediaEncodingProfile.CreateMp3 和 AudioEncodingQuality.Auto 创建配置文件,然后调用 PrepareStreamTranscodeAsync,则会收到 NullReferenceException 错误。 在这种情况下,需要选择“自动”以外的编码质量设置,以便创建功能配置文件。
有关使用 MediaEncodingProfile 为捕获的图像设置编码属性的操作指南,请参阅 使用 MediaCapture 捕获基本照片、视频和音频。 有关在转 码媒体文件时使用 MediaEncodingProfile 的信息,请参阅 转码媒体文件。
版本历史记录
Windows 版本 | SDK 版本 | 已添加值 |
---|---|---|
1703 | 15063 | CreateAlac |
1703 | 15063 | CreateFlac |
1703 | 15063 | CreateHevc |
1709 | 16299 | GetAudioTracks |
1709 | 16299 | GetVideoTracks |
1709 | 16299 | SetAudioTracks |
1709 | 16299 | SetVideoTracks |
1803 | 17134 | GetTimedMetadataTracks |
1803 | 17134 | SetTimedMetadataTracks |
构造函数
MediaEncodingProfile() |
创建 MediaEncodingProfile 类的新实例。 |
属性
Audio |
获取或设置音频流的编码属性。 |
Container |
获取或设置媒体容器的属性。 |
Video |
获取或设置视频流的编码属性。 |