AudioEncodingProperties 类

定义

命名空间:

Windows.Media.MediaProperties

描述音频流的编码属性。

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

function AudioEncodingProperties()

Public NotInheritable Class AudioEncodingProperties

继承

Object Platform::Object IInspectable AudioEncodingProperties

属性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

实现

IMediaEncodingProperties

Windows 要求

设备系列	Windows 10 (在 10.0.10240.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

注解

编码质量 “自动 ”是一种特殊的预设，可根据当前相机设置填充正确的设置。 将忽略手动修改的设置。 例如，如果使用静态创建方法之一（如 CreateWav）创建预设配置文件，并将 “自动 ”指定为编码质量，则对属性所做的任何更改都将根据当前相机设置使用值覆盖。

注意

可以创建在特定设备上不支持的 AudioEncodingProperties 。 例如，可以成功调用 CreateMp3，但如果设备上不存在 mp3 编码器，则尝试使用此方法返回的属性对音频进行编码将失败。 有关每个设备系列默认存在的编解码器的列表，请参阅 支持的编解码器。

有关为捕获的音频设置编码属性的操作指南，请参阅 使用 MediaCapture 捕获基本照片、视频和音频。

版本历史记录

Windows 版本	SDK 版本	增值
1703	15063	CreateAlac
1703	15063	CreateFlac
1703	15063	IsSpatial
1803	17134	复制

构造函数

AudioEncodingProperties()

创建 AudioEncodingProperties 类的新实例。

属性

Bitrate	获取或设置音频比特率。
BitsPerSample	获取或设置每个音频样本的位数。
ChannelCount	获取或设置音频声道的数量。
IsSpatial	获取一个值，该值指示音频是否使用空间音频信息进行编码。
Properties	获取音频流的其他格式属性。
SampleRate	获取或设置音频采样率。
Subtype	获取或设置格式的子类型。
Type	获取格式类型。

方法

Copy()	创建 AudioEncodingProperties 对象的副本。
CreateAac(UInt32, UInt32, UInt32)	创建 AudioEncodingProperties 的实例，用于高级音频编码 (AAC) 音频。
CreateAacAdts(UInt32, UInt32, UInt32)	创建 AudioEncodingProperties 的一个实例，用于高级音频编码 (AAC) 音频 (ADTS) 格式的音频。
CreateAlac(UInt32, UInt32, UInt32)	为 Apple 无损音频编解码器创建 AudioEncodingProperties 的实例， (ALAC) 音频。
CreateFlac(UInt32, UInt32, UInt32)	为免费无损音频编解码器创建 AudioEncodingProperties 的实例， (FLAC) 音频。
CreateMp3(UInt32, UInt32, UInt32)	为 MPEG 音频第 3 层创建 AudioEncodingProperties 的实例， (MP3) 音频。
CreatePcm(UInt32, UInt32, UInt32)	创建 AudioEncodingProperties 的一个实例，用于脉冲代码调制 (PCM) 音频。
CreateWma(UInt32, UInt32, UInt32)	为 Windows Media Audio (WMA) 创建 AudioEncodingProperties 的实例。
GetFormatUserData(Byte[])	获取媒体格式用户数据。
SetFormatUserData(Byte[])	设置媒体格式用户数据。

另请参阅

• 支持的编解码器。
• 使用 MediaCapture 捕获基本的照片、视频和音频