学习libopus(1) Encoder编码器

来自：http://www.opus-codec.org/docs/html_api-1.1.0/group__opus__encoder.html#gaefeb7dc1d6e3b59dea5ea674c86e9c18

详细说明

此页面描述了用于编码的使用过程和功能。


因为Opus是状态编解码，进行编码前，首先需要创建一个编码器。你可以这样做：


int error;
OpusEncoder *enc;
enc = opus_encoder_create(Fs, channels, application, &error);


从这起，enc就可以用来对音频流进行编码。这个编码器不能同时对多个流进行编码 (线程不安全)。同时，对多帧进行编码时，编码器不需要重复初始化。


调用opus_encoder_create（）时，会创建内存空间，它也可以初始化预分配内存：


int size;
int error;
OpusEncoder *enc;
size = opus_encoder_get_size(channels);
enc = malloc(size);
error = opus_encoder_init(enc, Fs, channels, application);


opus_encoder_get_size（）会返回编码器所需的内存大小。请注意，这个大小可能在未来的版本中有所修改，所以尽量不要使用常量代替。


这个编码器会分配到连续的内存块中，可以通过浅拷贝获取他(例如memcpy)


你可以通过opus_encoder_ctl（）对编码器的内部设置进行修改。这些设定默认使用推荐值。以下为最常见的修改项：


opus_encoder_ctl(enc, OPUS_SET_BITRATE(bitrate));//波特率
opus_encoder_ctl(enc, OPUS_SET_COMPLEXITY(complexity));//复杂度
opus_encoder_ctl(enc, OPUS_SET_SIGNAL(signal_type));//信号
在这里
bitrate的单位是比特每秒（B / S）


complexity是一个值从1至10，其中1最低和10最高


signal_type要么OPUS_AUTO（默认），OPUS_SIGNAL_VOICE或OPUS_SIGNAL_MUSIC


参看编码器相关的CTL和通用的CTL可以知道完整的设置列表。大多数参数可以在流编码时，进行设置或修改。


在调用opus_encode（）或者opus_encode_float（）时必须是一个完整的音频数据（2.5，5，10，20，40或60毫秒）：


len = opus_encode(enc, audio_frame, frame_size, packet, max_packet);
在这里


audio_frame是opus_int16音频数据（或是opus_encode_float（））


frame_size是帧中的样本的持续时间（每个通道）


packet是音频数据需要写入的字节数组


max_packet是可写在包的最大字节数（4000字节建议）。不要通过max_packet来控制VBR的比特率，如果需要请使用OPUS_SET_BITRATE CTL。


opus_encode（）和opus_encode_float（）返回实际写入到分组的字节数。返回值可以是负的，这表示发生了错误。如果返回值是1字节，则分组不需要被发送（DTX）。


当需要释放编码器时，可以通过:
opus_encoder_destroy（enc）;


如果编码器，用opus_encoder_init（）创建，而不是opus_encoder_create（），则不执行任何操作，只需要释放预先分配的内存,调用free(enc)