前段时间,在学习试用FFmpeg播放音频的时候总是有杂音,网上的很多教程是基于之前版本的FFmpeg的,而新的FFmepg3中audio增加了平面(planar)格式,而SDL播放音频是不支持平面格式的,所以通过FFmpeg解码出来的数据不能直接发送到SDL进行播放,需要进行一个格式转换。通过网上一些资料,也能够正确的播放音频了,但是对具体的音频转换过程不是很了解,这里就对FFmpeg的对音频的存储格式及格式转换做个总结。本文主要有以下几个方面的内容:
- AVSampleFormat 音频sample的存储格式
- channel layout 各个通道存储顺序
- 使用FFmpeg对音频数据进行格式转换
-
音频解码API de >avcodec_decode_audio4de>在新版中已废弃,替换为使用更为简单的de >avcodec_send_packetde>和de >avcodec_receive_framede>。本文简单的介绍了该API的使用。
AVSampleFormat
在FFmpeg中使用枚举de >AVSampleFormatde>表示音频的采样格式,其声明如下:
de >enum AVSampleFormat { AV_SAMPLE_FMT_NONE = -1, AV_SAMPLE_FMT_U8, ///< unsigned 8 bits AV_SAMPLE_FMT_S16, ///< signed 16 bits AV_SAMPLE_FMT_S32, ///< signed 32 bits AV_SAMPLE_FMT_FLT, ///< float AV_SAMPLE_FMT_DBL, ///< double AV_SAMPLE_FMT_U8P, ///< unsigned 8 bits, planar AV_SAMPLE_FMT_S16P, ///< signed 16 bits, planar AV_SAMPLE_FMT_S32P, ///< signed 32 bits, planar AV_SAMPLE_FMT_FLTP, ///< float, planar AV_SAMPLE_FMT_DBLP, ///< double, planar AV_SAMPLE_FMT_NB ///< Number of sample formats. DO NOT USE if linking dynamically };de>
和图像的像素存储格式类似,可以使用8位无符号整数、16位有符号整数、32位有符号整数以及单精度浮点数,双精度浮点数表示一个采样。但是,没有使用
24位的有符号整数,这是因为这些不同的格式使用的是原生的C类型,而C中是没有24位的长度的类型的。
Sample value can be expressed by native C types,hence the lack of a signed 24-bit sample format even though
it is a common raw audio data format.
对于浮点格式,其值在[-1.0,1.0]之间,任何在该区间之外的值都超过了最大音量的范围。
和YUV的图像格式格式,音频的采样格式分为平面(planar)和打包(packed)两种类型,在枚举值中上半部分是packed类型,后面(有P后缀的)是planar类型。
对于planar格式的,每一个通道的值都有一个单独的plane,所有的plane必须有相同的大小;对于packed类型,所有的数据在同一个数据平面中,不同通道的数据
交叉保存。
另外,在de >AVFramede>中表示音频采样格式的字段de >formatde>是一个int型,在使用de >AVSampleFormatde>时候需要进行一个类型转换,将int转换为de >AVSampleFormatde>枚举值。
在头文件de >samplefmt.hde>提供了和音频采样格式相关的一些函数,现列举一些如下:
- de >const char *av_get_sample_fmt_name(enum AVSampleFormat sample_fmt)de>
根据枚举值获取其相应的格式名称(字符串) - de >enum AVSampleFormat av_get_sample_fmt(const char *name)de>
根据格式名字(字符串)获取相应的枚举值 - de >enum AVSampleFormat av_get_packed_sample_fmt(enum AVSampleFormat sample_fmt)de>
传入planar类型的采样格式,返回其可转换的packed类型的采样格式。例如传入 de >AV_SAMPLE_FMT_S32Pde>,其返回值为 de >AV_SAMPLE_FMT_S32de>。 - de >enum AVSampleFormat av_get_planar_sample_fmt(enum AVSampleFormat sample_fmt)de>
和上面函数类似,不同的是传入的是packed类型的格式。 - de >int av_sample_fmt_is_planar(enum AVSampleFormat sample_fmtde>
判断一个采样格式是不是planar类型的 - de >int av_get_bytes_per_sample(enum AVSampleFormat sample_fmt)de>
每个采样值所占用的字节数 - de >int av_samples_get_buffer_size(int *linesize, int nb_channels, int nb_samples,enum AVSampleFormat sample_fmt, int align)de>
根据输入的参数,计算其所占用空间的大小(字节数)。de >linesizede>可设为null,align是buff空间的对齐格式(0=default,1 = no alignment)
channel_layout
从上面可知,sample有两种类型的存储方式:平面(planar)和打包(packed),在planar中每一个通道独自占用一个存储平面;在packed中,所有通道的sample交织存储在同一个
平面。但是,对于planar格式不知道具体的某一通道所在的平面;对于packed格式各个通道的数据是以怎么样的顺序交织存储的。这就需要借助于channel_layout。
首先来看下FFmpeg对channel_layout的定义:
channel_layout是一个64位整数,每个值为1的位对应一个通道。也就说,de >channel_layoutde>的位模式中值为1的个数等于其通道数量。
A channel_layout is a 64-bits interget with a bit set for every channel.The number of bits set must be equal to the number of channels.
在头文件de >channel_layout.hde>中为将每个通道定义了一个mask,其定义如下:
de >#define AV_CH_FRONT_LEFT 0x00000001 #define AV_CH_FRONT_RIGHT 0x00000002 #define AV_CH_FRONT_CENTER 0x00000004 #define AV_CH_LOW_FREQUENCY 0x00000008 #define AV_CH_BACK_LEFT 0x00000010 #define AV_CH_BACK_RIGHT 0x00000020 #define AV_CH_FRONT_LEFT_OF_CENTER 0x00000040 #define AV_CH_FRONT_RIGHT_OF_CENTER 0x00000080 #define AV_CH_BACK_CENTER 0x00000100 #define AV_CH_SIDE_LEFT 0x00000200 #define AV_CH_SIDE_RIGHT 0x00000400 #define AV_CH_TOP_CENTER 0x00000800 #define AV_CH_TOP_FRONT_LEFT 0x00001000 #define AV_CH_TOP_FRONT_CENTER 0x00002000 #define AV_CH_TOP_FRONT_RIGHT 0x00004000 #define AV_CH_TOP_BACK_LEFT 0x00008000 #define AV_CH_TOP_BACK_CENTER 0x00010000 #define AV_CH_TOP_BACK_RIGHT 0x00020000 #define AV_CH_STEREO_LEFT 0x20000000 ///< Stereo downmix. #define AV_CH_STEREO_RIGHT 0x40000000 ///< See AV_CH_STEREO_LEFT.de>
这样,一个channel_layout就是上述channel mask的组合,部分定义如下:
de >#define AV_CH_LAYOUT_MONO (AV_CH_FRONT_CENTER) #define AV_CH_LAYOUT_STEREO (AV_CH_FRONT_LEFT|AV_CH_FRONT_RIGHT) #define AV_CH_LAYOUT_2POINT1 (AV_CH_LAYOUT_STEREO|AV_CH_LOW_FREQUENCY) #define AV_CH_LAYOUT_2_1 (AV_CH_LAYOUT_STEREO|AV_CH_BACK_CENTER) #define AV_CH_LAYOUT_SURROUND (AV_CH_LAYOUT_STEREO|AV_CH_FRONT_CENTER) #define AV_CH_LAYOUT_3POINT1 (AV_CH_LAYOUT_SURROUND|AV_CH_LOW_FREQUENCY) #define AV_CH_LAYOUT_4POINT0 (AV_CH_LAYOUT_SURROUND|AV_CH_BACK_CENTER) #define AV_CH_LAYOUT_4POINT1 (AV_CH_LAYOUT_4POINT0|AV_CH_LOW_FREQUENCY) #define AV_CH_LAYOUT_2_2 (AV_CH_LAYOUT_STEREO|AV_CH_SIDE_LEFT|AV_CH_SIDE_RIGHT) #define AV_CH_LAYOUT_QUAD (AV_CH_LAYOUT_STEREO|AV_CH_BACK_LEFT|AV_CH_BACK_RIGHT) #define AV_CH_LAYOUT_5POINT0 (AV_CH_LAYOUT_SURROUND|AV_CH_SIDE_LEFT|AV_CH_SIDE_RIGHT) #define AV_CH_LAYOUT_5POINT1 (AV_CH_LAYOUT_5POINT0|AV_CH_LOW_FREQUENCY) ...de>
de >AV_CH_LAYOUT_STEREOde>是立体声(2通道),其通道的存放顺序为de >LEFT | RIGHTde>;de >AV_CH_LAYOUT_4POINT0de>是4通道,其通道的存放顺序为
de >LEFT|RIGHT|FRONT-CENTER|BACK-CENTERde>;其它数量的声道与此类似。
下面列举一些和channel_layout相关的函数
- de >uint64_t av_get_channel_layout(const char *name)de> 根据传入的字符串,返回相对应的channel_layout。传入的参数可以是:
- 常用的channel layout的名称:mono,stereo,4.0,quad,5.0,5.0(side),5.1等。
- 一个单通道的名称:FL,FR,FC,BL,BR,FLC,FRC等
- 通道的数量
- channel_layout mask,以"0x"开头的十六进制串。
更多详细的说明,参见该函数的文档。
- de >int av_get_channel_layout_nb_channels(uint64_t channel_layout)de> 根据通道的layout返回通道的个数
- de >int64_t av_get_default_channel_layout(int nb_channels)de> 根据通道的个数返回默认的layout
-
de >int av_get_channel_layout_channel_index(uint64_t channel_layout,uint64_t channel);de> 返回通道在layout中的index,也就是某一通道
在layout的存储位置。
de >av_get_channel_layout_channel_indexde>的实现如下:de >int av_get_channel_layout_channel_index(uint64_t channel_layout, uint64_t channel) { if (!(channel_layout & channel) || av_get_channel_layout_nb_channels(channel) != 1) return AVERROR(EINVAL); channel_layout &= channel - 1; return av_get_channel_layout_nb_channels(channel_layout); }de>
首先判断传入的layout包含该通道,并且保证该传入的通道是一个单通道。
以4通道de >AV_CH_LAYOUT_4POINT0de>为例,说明下计算方法。de >AV_CH_LAYOUT_4POINT0 = AV_CH_FRONT_LEFT | AV_CH_FRONT_RIGHT | AV_CH_FRONT_CENTER | AV_CH_BACK_CENTERde>
其二进制表示为de >0001,0000,0111de>,假如想找de >AV_CH_BACK_CENTERde>在该layout中的index。de >AV_CH_BACK_CENTERde>的十六进制为de >0x0100de>,二进制为de >0001,0000,0000de>,那么
de >AV_CH_BACK_CENTER - 1 = 1111,1111de>。 de >0001,0000,0111 & 0000,1111,1111 = 0111de>,函数de >av_get_channel_layout_nb_channelsde>是获取某个layout对应的通道的数量,
前面提到,layout中值为1的位的个数和通道的数量相等,所以de >AV_CH_BACK_CENTERde>在layoutde >AV_CH_LAYOUT_4POINT0de>的index为3。
Audio 格式转换
在FFmpeg中进行音频的格式转换主要有三个步骤
- 实例化de >SwrContextde>,并设置转换所需的参数:通道数量、channel layout、sample rate
有以下两种方式来实例de >SwrContextde>,并设置参数:
-
使用de >swr_allocde>
de > SwrContext *swr = swr_alloc(); av_opt_set_channel_layout(swr, "in_channel_layout", AV_CH_LAYOUT_5POINT1, 0); av_opt_set_channel_layout(swr, "out_channel_layout", AV_CH_LAYOUT_STEREO, 0); av_opt_set_int(swr, "in_sample_rate", 48000, 0); av_opt_set_int(swr, "out_sample_rate", 44100, 0); av_opt_set_sample_fmt(swr, "in_sample_fmt", AV_SAMPLE_FMT_FLTP, 0); av_opt_set_sample_fmt(swr, "out_sample_fmt", AV_SAMPLE_FMT_S16, 0);de>
-
使用 de >swr_alloc_set_optsde>
de > SwrContext *swr = swr_alloc_set_opts(NULL, // we're allocating a new context AV_CH_LAYOUT_STEREO, // out_ch_layout AV_SAMPLE_FMT_S16, // out_sample_fmt 44100, // out_sample_rate AV_CH_LAYOUT_5POINT1, // in_ch_layout AV_SAMPLE_FMT_FLTP, // in_sample_fmt 48000, // in_sample_rate 0, // log_offset NULL); // log_ctxde>
上述两种方法设置那个的参数是将5.1声道,channel layout为AV_CH_LAYOUT_5POINT1,采样率为48KHz转换为2声道,channel_layout为AV_SAMPLE_FMT_S16,采样率为44.1KHz。
-
计算转换后的sample个数
转后后的sample个数的计算公式为:src_nb_samples * dst_sample_rate / src_sample_rate,其计算如下:de >int dst_nb_samples = av_rescale_rnd(swr_get_delay(swr_ctx, frame->sample_rate) + frame->nb_samples, frame->sample_rate, frame->sample_rate, AVRounding(1));de>
函数de >av_rescale_rndde>是按照指定的舍入方式计算a * b / c 。
函数de >swr_get_delayde>得到输入sample和输出sample之间的延迟,并且其返回值的根据传入的第二个参数不同而不同。如果是输入的采样率,则返回值是输入sample个数;如果输入的是输出采样率,则返回值是输出sample个数。 -
调用 de >swr_convertde>进行转换
de >int nb = swr_convert(swr_ctx, &audio_buf, dst_nb_samples, (const uint8_t**)frame->data, frame->nb_samples);de>
其返回值为转换的sample个数。
SDL播放音频时的格式转换
-
首先使用de >avcodec_send_packetde>和de >avcodec_receive_framede>获取解码后的原始数据
de >int ret = avcodec_send_packet(aCodecCtx, &pkt); if (ret < 0 && ret != AVERROR(EAGAIN) && ret != AVERROR_EOF) return -1; ret = avcodec_receive_frame(aCodecCtx, frame); if (ret < 0 && ret != AVERROR_EOF) return -1;de>
这里不再使用de >avcodec_decode_audio4de>进行音频的解码,在FFmpeg3中该函数已被废弃,使用de >avcodec_send_packetde>和de >avcodec_receive_framede>替代。新的解码API使用更为方便,
具体参见官方文档send/receive encoding and decoding API overview。 -
设置通道数量和channel layout
在编码的时候有可能丢失通道数量或者channel layout ,这里根据获取的参数设置其默认值de >if (frame->channels > 0 && frame->channel_layout == 0) frame->channel_layout = av_get_default_channel_layout(frame->channels); else if (frame->channels == 0 && frame->channel_layout > 0) frame->channels = av_get_channel_layout_nb_channels(frame->channel_layout);de>
如果channel layout未知(channel_layout = 0),根据通道数量获取其默认的channel layout;如同通道的数量未知,则根据其channel layout得到其通道数量。
-
设置输出格式
由于SDL2的sample格式不支持浮点型(FFmpeg中是支持的浮点型的),这里简单的设置输出格式为de >AV_SAMPLE_FMT_S16de>(16位有符号整型),输出的channel layout也
根据通道数量设置为默认值 de >dst_layout = av_get_default_channel_layout(frame->channels)de>(SDL2不支持planar格式)。实例化de >SwrContextde>de >swr_ctx = swr_alloc_set_opts(nullptr, dst_layout, dst_format, frame->sample_rate, frame->channel_layout, (AVSampleFormat)frame->format, frame->sample_rate, 0, nullptr); if (!swr_ctx || swr_init(swr_ctx) < 0) return -1;de>
在设置完参数后,一定要调用de >swr_initde>进行初始化。
-
转换
de >// 计算转换后的sample个数 a * b / c int dst_nb_samples = av_rescale_rnd(swr_get_delay(swr_ctx, frame->sample_rate) + frame->nb_samples, frame->sample_rate, frame->sample_rate, AVRounding(1)); // 转换,返回值为转换后的sample个数 int nb = swr_convert(swr_ctx, &audio_buf, dst_nb_samples, (const uint8_t**)frame->data, frame->nb_samples); data_size = frame->channels * nb * av_get_bytes_per_sample(dst_format);de>
最后de >data_sizede>中保存的是转换的数据的字节数:通道数 * sample个数 * 每个sample的字节数。
总结
本文主要介绍了在FFmepg中对音频两个重要属性:采样格式和channel layout的表示方法,并简单的实现了一个音频的格式转换。
- 采样格式 使用AVSampleFormat枚举值表示,并可分为planar和packed两类。
- channel layout 是一个64位的整数,表示各个通道数据的存放顺序,其二进制位中1的个数等于其通道的数量。
本文代码 FFmpeg-playAudio.cpp