EMIPLIB使用入门Word下载.docx
- 文档编号:17963342
- 上传时间:2022-12-12
- 格式:DOCX
- 页数:12
- 大小:22.79KB
EMIPLIB使用入门Word下载.docx
《EMIPLIB使用入门Word下载.docx》由会员分享,可在线阅读,更多相关《EMIPLIB使用入门Word下载.docx(12页珍藏版)》请在冰豆网上搜索。
http:
//research.edm.uhasselt.be/emiplib/documentation/index.html
下面我们就针对windows平台下展开吧,因为我的EMIPLIB经验基本上是在windows平台地...
第一步:
编译库(最基本编译)
先说说我的平台及环境:
windowsxpsp2,vc8(第一次使用这个新的IDE,因为这个lib只提供了VC8的项目文件,时间原因我没办法尝试mingw及vc6等)。
可以到下面地址下载到源代码:
EMIPLIB
//research.edm.uhasselt.be/emiplib/emiplib-0.14.0.zip
JTHREAD
//research.edm.uhasselt.be/jori/jthread/jthread-1.2.1.zip
JRTPLIB
//research.edm.uhasselt.be/jori/jrtplib/jrtplib-3.7.0.zip
下载完以后,开始编译JTHREAD,用vc8打开源代码中的sln文件,在项目设置中C++项目下代码生成中选择多线程调试(/Mtd),以同样方法编译JRTPLIB。
这两个库使用vc6和vc8都可以很轻松的编译,需要注意的是生成静态库时候要统一代码生成中的选项,我这里使用了/Mtd。
完成后,在你的debug或者release目录线面会有这两个库:
JRTPLIB.LIBJTHREAD.lib。
如果编译这两个库的时候有问题,可以给我mail,或者直接去mail到作者那里,之前我也问过他一些问题,他是个不错的人。
然后我们需要来编译最大个的EMIPLIB库了,在EMIPLIB的源代码目录有README文件,上面有在windows下编译此库的参考。
比较麻烦的问题是对于视频,我们可能需要添加QT支持(这可能需要我们在windows下先安装好QT,并自己手动完成一些文件)。
对于最基本的编译我们先不去管它。
上面的README文件中也说明了,在源代码目录的src\core\目录下面有一个配置文件mipconfig_win.h,我们可以在编译前进行一些选择,来得到更多功能支持的库。
不过现在我们只使用默认的,只有speex支持被添加了。
用vc8打开sln文件吧,要正确的进行编译,我们最好先把上面需要的两个库,以及一些头文件放在一个合适的地方,让IDE可以找到它们。
这需要你设置vc的目录(在工具--选项里面)添加include目录及lib目录。
然后也在项目设置中设定多线程调试(/Mtd),现在应该可以编译EMIPLIB了。
(PS:
我们可能需要安装Dshow,新的版本MS已经把它从DxSDK中踢出来鸟,放到了PlatFormSDK中)。
最基本的编译应该不会花去我们太多时间。
让我们先尝尝鲜,看看怎么用这个库。
第二步:
helloworld
在EMIPLIB源代码目录里面有一个examples目录,里面给了几个例子。
我们找一个功能比较全的叫做feedbackexample.cpp,来看看怎么使用这个库:
我们省略了其中一些代码,只贴出来比较重要的。
/*
这个demo它打开一个叫做soundfile.wav的文件,并对其进行采样、uLaw编码、RTP编码然后设定好RTP的目的地(这里它发送给了自己),再经过RTP解码、uLAW解码、采样编码,发给声卡让它播放出来。
*/
MIPTimeinterval(0.020);
//设定间隔为ms
MIPAverageTimertimer(interval);
//设定计时器
MIPWAVInputsndFileInput;
//声音文件输入
MIPSamplingRateConvertersampConv,sampConv2;
//采样转换
MIPSampleEncodersampEnc,sampEnc2,sampEnc3;
//采样编码
MIPULawEncoderuLawEnc;
//uLaw编码
MIPRTPULawEncoderrtpEnc;
//rtp编码
MIPRTPComponentrtpComp;
//rtp组建
MIPRTPDecoderrtpDec;
//rtp解码
MIPRTPULawDecoderrtpULawDec;
//rtpulaw解码
MIPULawDecoderuLawDec;
//uLaw解码
MIPAudioMixermixer;
//混音
MIPWinMMOutputsndCardOutput;
//声卡输出
MyChainchain("
Soundfileplayer"
);
//链:
用来把上面组建串起来的对象。
RTPSessionrtpSession;
//RTP会话,来自jrtplib
boolreturnValue;
//返回值
intsamplingRate=8000;
//采样率默认为kHz
intnumChannels=1;
//声道设置默认为单声道
//打开一个wav文件。
returnValue=sndFileInput.open("
soundfile.wav"
interval);
//初始化采样转换,设置了采样率以及声道
returnValue=sampConv.init(samplingRate,numChannels);
//初始化采样编码,参数用于设定音频数据在计算机中的保存形式
returnValue=sampEnc.init(MIPRAWAUDIOMESSAGE_TYPE_S16);
//初始化ulaw编码
returnValue=uLawEnc.init();
//初始化rtp编码,这个组建可以创建发送到RTP组件的RTP消息。
returnValue=rtpEnc.init();
//初始化RTPSession,需要设置包括端口采样率等等与传输有关的参数
RTPUDPv4TransmissionParamstransmissionParams;
RTPSessionParamssessionParams;
intportBase=60000;
intstatus;
transmissionParams.SetPortbase(portBase);
sessionParams.SetOwnTimestampUnit(1.0/((double)samplingRate));
sessionParams.SetMaximumPacketSize(64000);
sessionParams.SetAcceptOwnPackets(true);
//建立一个RTPSession
status=rtpSession.Create(sessionParams,&
transmissionParams);
//添加一个目的地,RTPSession将往此目的发送RTP数据。
这里我们发送给自己。
status=rtpSession.AddDestination(RTPIPv4Address(ntohl(inet_addr("
127.0.0.1"
)),portBase));
//初始化RTP组件,使用我们刚才定义的RTPSession为参数
returnValue=rtpComp.init(&
rtpSession);
//初始化RTP解码器
returnValue=rtpDec.init(true,0,&
//设置RTP解码器使用ulaw规则
returnValue=rtpDec.setPacketDecoder(0,&
rtpULawDec);
//初始化ulaw解码,转换被U-law解码的采样数据为线性解码采样
returnValue=uLawDec.init();
//初始化采样编码,转换接受到的音频数据为浮点数形式存储
returnValue=sampEnc2.init(MIPRAWAUDIOMESSAGE_TYPE_FLOAT);
//初始化采样转换,设置参数采样率及声道
returnValue=sampConv2.init(samplingRate,numChannels);
//初始化混音
returnValue=mixer.init(samplingRate,numChannels,interval);
//初始化声卡输出
returnValue=sndCardOutput.open(samplingRate,numChannels,interval);
//声卡输出使用的数据形式
returnValue=sampEnc3.init(MIPRAWAUDIOMESSAGE_TYPE_S16LE);
//建立整个链:
看看这个顺序,这是整个程序工作的逻辑
returnValue=chain.setChainStart(&
timer);
returnValue=chain.addConnection(&
timer,&
sndFileInput);
sndFileInput,&
sampConv);
sampConv,&
sampEnc);
sampEnc,&
uLawEnc);
uLawEnc,&
rtpEnc);
rtpEnc,&
rtpComp);
rtpComp,&
rtpDec);
rtpDec,&
uLawDec,true);
uLawDec,&
sampEnc2,true);
sampEnc2,&
sampConv2,true);
sampConv2,&
mixer,true);
mixer,&
sampEnc3);
sampEnc3,&
sndCardOutput);
//启动这个链
returnValue=chain.start();
//这里添加等待停止的代码
returnValue=chain.stop();
rtpSession.Destroy();
要想运行这个程序,需要我们的编译器可以找到jrtplib.lib,jrtplib.lib,emiplib.lib
以及
这些lib导出符号需要的一些.H文件。
比较好的方法是,把它们分别放到相应目录中,在vc目录中设置。
另外,还需要在lib中添加ws2_32.lib,winmm.lib。
运行时库选项统一为"
/MTd"
其它的问题,可能还需要你在忽略库列表中把一些冲突的库加上,比如libc.lib、libcmt.lib、msvcrt.lib、libcd.lib、msvcrtd.lib...
源代码中没有给你提供上面所说的那个wav文件,你需要自己找一个。
能听到那个XXX.wav的声音了,大功告成。
第三步:
一些介绍
我们来大体了解一下EMIPLIB,以及怎么使用它。
EMIPLIB为了提供一个灵活性比较好的框架,此库的目的是建立一些列相关的小组件,每个组件提供一些特定的工作,如音频取样,写音频到文件或者传输音频包等等。
这些组件可以放置到一个chain(链)中,在这个链上,这些组件可以相互通信。
这样,(按照需求)通过连接这些组件到一条链上,可以建立复杂的引用程序。
另外,EMIPLIB为了大家使用方便也提供了一些更高级的类,它们包装好了一些常用的功能,给我们更好的interface。
比如上面helloworld中的那一串的定义,初始化,貌似都差不多的chain,MIPAudioSession类都给我们包装好了。
如果这些功能已经提供了足够的功能,使用它们就好了,如果你有特殊的要求,你也可以像上面例子一样,自己写那一堆组件,按照你的思路让他们工作。
大部分可以放到MIPComponentChain上的组件都派生自MIPComponent类。
我们需要作的工作就是从这些派生类里面选择合适的组件,把它们放在一个chain上面,它就可以开始工作了。
即使不使用EMIPLIB提供给我们的包装类,这些工作也不会很繁琐。
比较详细的描述,大家可以参考EMIPLIB主页上的LibraryCore部分。
第四步:
一个语音会议的demo
最后我们来做一个局域网的语音会议的demo,也算做个入门结业。
我们的语音会议的demo设计为这样:
没有服务器,会议中每一方都可以listen来自局域网的声音,也可以往自己的列表中添加目标位置,向它(们)发送你的语音。
这样要完成一个三人的对话,我们需要三方都打开listen,并且添加另外两个人的地址,发送自己的声音。
我们开两个独立的线程,一个负责在端口12000接受来自局域网的声音,一个负责往发送列表中的目的地发送本地语音。
之前我们的例子中只是在本地做了一个wav文件的播放,我们需要解决另外几个问题:
得到声卡输入、如何向目的地发送RTP、如何接收RTP。
第一个问题比较好解决,我们仿照例子中声卡播放使用的对象,找到了这个类:
MIPWAVInput,把它放在某个chain的最开始处,我们就可以得到声音的输入了。
代码类似于下面:
MIPWinMMInputsndCardInput;
returnValue=sndCardInput.open(
samplingRate,numChannels,interval,buffertime,false);
在初始化chain时候:
chain.setChainStart(&
sndCardInput);
就可以了。
RTP的发送和接收主要是对于RTPsession的参数设置。
接收端代码我们设置端口为监听端口,发送端SetPortbase(portBase)为发送端口,而在RTPSession:
:
AddDestination函数中端口使用目的地的监听端口;
我们的发送语音的线程大致是这样的:
DWORDWINAPIWorkerThread(LPVOIDlpParameter)
{
IpAddrList*ipl=(IpAddrList*)lpParameter;
//把目的列表传过来鸟
WSADATAdat;
WSAStartup(MAKEWORD(2,2),&
dat);
MIPTimeinterval(0.020);
//We'
lluse20millisecondintervals.
MIPTimebuffertime(10);
MIPAverageTimertimer(interval);
MIPWAVInputsndFileInput;
MIPSamplingRateConvertersampConv;
MIPSampleEncodersampEnc;
MIPULawEncoderuLawEnc;
MIPRTPULawEncoderrtpEnc;
MIPRTPComponentrtpComp;
MIPWinMMInputsndCardInput;
MIPWinMMOutputsndCardOutput;
MyChainchain("
MPVC"
RTPSessionrtpSession;
boolreturnValue;
intsamplingRate=8000;
intnumChannels=1;
//We'
llstartmicrophone
returnValue=sndCardInput.open(
returnValue=sampEnc.init(MIPRAWAUDIOMESSAGE_TYPE_S16);
returnValue=uLawEnc.init();
returnValue=rtpEnc.init();
RTPUDPv4TransmissionParamstransmissionParams;
RTPSessionParamssessionParams;
intportBase=BASEPORT_SEND;
intstatus;
transmissionParams.SetPortbase(portBase);
sessionParams.SetOwnTimestampUnit(1.0/((double)samplingRate));
sessionParams.SetMaximumPacketSize(64000);
status=rtpSession.Create(sessionParams,&
for(inti=0;
i<
ipl->
count;
i++)
//这个for是从一个列表中读目的地址,
//大家可以自己按自己的要求实现,几个目的地就调用几个AddDestination。
{
status=rtpSession.AddDestination(
RTPIPv4Address(ntohl(inet_addr(ipl->
ipaddr[i])),
BASEPORT_LISTEN));
}
returnValue=rtpComp.init(&
returnValue=chain.setChainStart(&
returnValue=chain.addConnection(&
sndCardInput,&
returnValue=chain.start();
while(stop_f)
Sleep(SLEEP_TIME);
rtpSession.BYEDestroy(RTPTime(10,0),0,0);
returnValue=chain.stop();
rtpSession.Destroy();
WSACleanup();
return0;
}
listen端的代码类似下面:
DWORDWINAPIWorkerThread_Listen(LPVOIDlpParameter)
MIPAver
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- EMIPLIB 使用 入门