libmp3lame及API介绍和使用详解

来自:网络
时间:2023-07-25
阅读:
目录

API介绍

API地址是对libmp3lame.so的编码部分最基础接口的介绍,本库特包含了增加id3标签和mp3的解码的支持。这里并不是完整的文档,但是你可以通过查看"include/lame.h"找到他们,并且通过查看frontend/main.c看到部分编解码的源代码。

  • (可选) 如果你感兴趣,可以获取编码器的版本号.
   void get_lame_version(char *strbuf, size_t buflen, const char *prefix);
  • 错误信息。

LAME默认情况下会使用vfprintf()将错误信息给stderr,在一些有界面的应用下,可能获取方面会有问题,所以支持你设置自己的错误信息Handlers:

   lame_set_errorf(gfp,error_handler_function);
   lame_set_debugf(gfp,error_handler_function);
   lame_set_msgf(gfp,error_handler_function);

可以通过查看lame.h找到更多的细节。

  • 初始化编码器。

为所有的编码参数设置默认值。

   #include "lame.h"
   lame_global_flags *gfp;
   gfp = lame_init();

默认情况(如果什么都没设置),输出格式为J-Stereo, 44.1khz 128kbps CBR quality=5,的mp3,如果需要可以调用代码重写下面的设置:

   lame_set_num_channels(gfp,2);
   lame_set_in_samplerate(gfp,44100);
   lame_set_brate(gfp,128);
   lame_set_mode(gfp,1);
   lame_set_quality(gfp,2);   /* 2=high  5 = medium  7=low */ 

可以查看lame.h获取所有的可以调用的API列表。需要注意的是有很多lame_set_*()并没有在lame.h里,这些功能是试验性的仅仅用来测试,可能在后续的版本中移除。

  • 设置编码参数

调用下面的代码来设置上面设置的不同的设置,返回ret_code >= 0表明设置成功。

   ret_code = lame_init_params(gfp);
  • 编码逻辑

输入pcm数据,输出MP3帧,lame_encode_buffer会完成所有所需的缓冲,重采样,过滤操作。需要的mp3buffer_size参数可以通过num_samples, samplerateencoding rate计算出来,这里有一个最坏情况的估算:

mp3buffer_size (in bytes) = 1.25 * num_samples + 7200

num_samples为PCM每个channel包含的采样数量,不是L通道和R通道中样本数量的总和,也就是单个channel的采样数量。
返回值为mp3buffer中包含的byte的数量,可以为0,如果是负值说明发生了错误。

   int lame_encode_buffer(lame_global_flags *gfp,
         short int leftpcm[], short int rightpcm[],
         int num_samples,char *mp3buffer,int  mp3buffer_size);

还有用于各种类型输入的例子(float, long, interleaved等等),具体可以查看lame.h.

  • flush清空缓存

lame_encode_flush将刷新缓冲区并可能返回最后几个mp3帧,mp3buffer应该至少有7200 bytes,返回值同样是输出到mp3buffer的数量,可以为0.

int lame_encode_flush(lame_global_flags *,char *mp3buffer, int mp3buffer_size);
  • 向mp3文件中写入Xing VBR/INFO标签
void lame_mp3_tags_fid(lame_global_flags *,FILE* fid);

这将添加一个有效的mp3帧,其中包含关于比特流有些音乐播放器可能会觉得有用。用于CBR,ABR和VBR。将尝试回到输出流的开头并写入标签,但有可能会失败,(比如,输出到了其他地方),这时候就需要在上面的步骤3之前调用lame_set_bWriteVbrTag(gfp,0),并且调用lame_mp3_tags_fid() with fid=NULL,如果尝试回到开头失败比特流的第一个mp3帧都是0。

  • 释放内部数据结构体
void lame_close(lame_global_flags *); 

简单使用

其实API的介绍已经把用法说的很清楚了,除了第一第二步,顺着走下来就好了。
这里感觉没有什么好说的,写我在用它的时候遇到的问题吧。

编码结束之后发现MP3时长变成了源音频的4倍,使用Audacity查看如图所示:

libmp3lame及API介绍和使用详解

并且放大之后发现每一帧后面都是空的,只有前面的小部分是有效的。

libmp3lame及API介绍和使用详解

查看之后其实最主要的就是 lame_encode_buffer_interleaved的调用:

int lame_encode_buffer_interleaved(lame_global_flags * gfp,
                               short int pcm[], int nsamples,
                               unsigned char *mp3buf, int mp3buf_size)

看他的参数,两个要注意的点:

  • 他需要的是short int pcm[],在准备数据的时候如果是用了uint8_t或者char之类的作为容器的话,需要注意size需要除以二,变成short int的size.
  • nsamples的参数理解,是单个channel含有的short int类型数据的size。如果输入源是双声道的uint8_t数组,那就需要除以四。

代码查看 Mp3Lame.cpp

以上就是libmp3lame及API介绍和使用详解的详细内容,更多关于libmp3lame API介绍使用的资料请关注其它相关文章!

返回顶部
顶部