关闭

基于webrtc的gips 语音引擎库及测试程序

标签: 测试引擎apicodecnullsignal
1346人阅读 评论(0) 收藏 举报
分类:

测试程序源代码下载地址:http://download.csdn.net/detail/dotphoenix/3674515

gips库头文件解释:

#pragma once


#ifdef LIBGIPS_WEBRTC_EXPORTS
#define LIB_GIPSVE_API extern "C" __declspec(dllexport)
#else
#define LIB_GIPSVE_API extern "C" __declspec(dllimport)
#endif




/*
所有的函数都应该返回true,否则出错,应该使用GIPSVE_LastError来取得出错的原因。
不需返回true的函数包括:
*/


struct PPCodec
{
int pltype;
char plname[32];
int plfreq;
int pacsize;
int channels;
int rate;
};




//必需先调用这个函数,并且确保返回值是0,否则以后所有的调用都可能引起异常.本函数多次调用不会有异常
LIB_GIPSVE_API bool GIPSVE_Init(char* szAuthtication, int iYear, int iMonth, int iDay);


//如果调用了GIPSVE_Init(),则最后必须调用这个函数,否则会有大量的资源泄露
LIB_GIPSVE_API void GIPSVE_UnInit();


//创建一个Channel,Channel的值必须>= 0 ,否则出错
LIB_GIPSVE_API int GIPSVE_CreateChannel();


//删除一个Channel
LIB_GIPSVE_API bool GIPSVE_DeleteChannel(int channel);




//设置目的地址的ip和port
LIB_GIPSVE_API bool GIPSVE_SetSendDestination(int channel, char* ip, unsigned short port);


//设置本地的port
LIB_GIPSVE_API bool GIPSVE_SetLocalReceiver(int channel, unsigned short port);


//取得当前的codec类型
LIB_GIPSVE_API bool GIPSVE_GetSendCodec(int channel, PPCodec& codec);


//设置codec的类型
LIB_GIPSVE_API bool GIPSVE_SetSendCodec(int channel, const PPCodec& codec);


//开始播放声音
LIB_GIPSVE_API bool GIPSVE_StartPlayout(int channel);


//停止播放声音
LIB_GIPSVE_API bool GIPSVE_StopPlayout(int channel);


//开始发送数据
LIB_GIPSVE_API bool GIPSVE_StartSend(int channel);


//停止发送数据
LIB_GIPSVE_API bool GIPSVE_StopSend(int channel);


//开始接收数据
LIB_GIPSVE_API bool GIPSVE_StartListen(int channel);


//停止接收数据
LIB_GIPSVE_API bool GIPSVE_StopListen(int channel);


//使用自定义的传输方式,Free版不支持
LIB_GIPSVE_API bool GIPSVE_UseExternalTransport(int channel, int use, void* externalTransport = NULL);
//Free版不支持
LIB_GIPSVE_API bool GIPSVE_UseExternalMediaProcessIn(int channel, int use, void* externalMedia = NULL);


//使用自定义媒体处理方式,Free版不支持
LIB_GIPSVE_API bool GIPSVE_UseExternalMediaProcessOut(int channel, int use, void* externalMedia = NULL);
//
LIB_GIPSVE_API bool GIPSVE_UseExternalEncryption(int channel, int use, void* externalEncryption);




//用文件里面的声音代替 microphone, 文件内容必须是 16kHz的PCM
//Free版不支持
LIB_GIPSVE_API bool GIPSVE_PlayFileIn(int channel, char* filepath);
//
LIB_GIPSVE_API bool GIPSVE_StopPlayFileIn(int channel);


//用文件里的内容代替收到的远端数据, 文件内容必须是 16kHz的PCM
//Free版不支持
LIB_GIPSVE_API bool GIPSVE_PlayFileOut(int channel, char* filepath);
//
LIB_GIPSVE_API bool GIPSVE_StopPlayFileOut(int channel);




/*
设置degree of bandwidth reduction
0 lowest reduction
1
2
3 means highest reduction
set = false means not set, true means set.
*/


LIB_GIPSVE_API bool GIPSVE_SetVadMode(int channel, bool set, int mode);
LIB_GIPSVE_API bool GIPSVE_GetVadMode(int channel, bool& enabled, int& mode);
//设置静音
LIB_GIPSVE_API bool GIPSVE_SetMute(int channel, bool mute);


//使用SRTP,Free版不支持
LIB_GIPSVE_API bool GIPSVE_UseSRTPTx(int channel, int useForRTP, int useForRTCP);
//Free版不支持
LIB_GIPSVE_API bool GIPSVE_UseSRTPRx(int channel, int useForRTP, int useForRTCP);




//0 holds  all, 1 holds send, 2 holds play
//Free版不支持,Commercial支持
LIB_GIPSVE_API bool GIPSVE_SetHoldMode(int channel, bool held, int mode);


//
LIB_GIPSVE_API bool GIPSVE_GetHoldMode( int channel, bool& held, int& mode);








/*
设置接收端的Automatic Gain Control(AGC)的类型
0 预设模式
1 平台默认
2 adaptive mode for use when analog volume control exists (e.g. for PC softphone)
3 scaling takes place in the digital domain (e.g. for conference servers and embedded devices)
4 can be used on embedded devices where the the capture signal is level is predictable
*/
LIB_GIPSVE_API bool GIPSVE_SetRxAgcMode(int channel, bool enabled, int mode);


//取得接收端的Automatic Gain Control(AGC)的类型
LIB_GIPSVE_API bool GIPSVE_GetRxAgcMode(int channel, bool& enabled, int mode);


/*
设置接收端的Noise Suppression级别


0  previously set mode
1,         // platform default
2,      // conferencing default
3,  // lowest suppression
4,
5,
6,     // highest suppression
*/
LIB_GIPSVE_API bool GIPSVE_SetRxNsMode(int channel, bool enabled, int mode);


//
LIB_GIPSVE_API bool GIPSVE_GetRxNsMode(int channel, bool& enabled, int& mode);


//Free版不支持
LIB_GIPSVE_API bool GIPSVE_StartRecordingMicrophone(char* filepath); //默认为mono 16kHz pcm


//Free版不支持
LIB_GIPSVE_API bool GIPSVE_StopRecrodingMicrophone();
//当前不支持
LIB_GIPSVE_API bool GIPSVE_StartRecordingPlayout(int channel, char* filepath);
//
LIB_GIPSVE_API bool GIPSVE_StopRecordingPlayout(int channel);






LIB_GIPSVE_API bool GIPSVE_SetAgcMode(bool enabled, int mode);


LIB_GIPSVE_API bool GIPSVE_GetAgcMode(bool& enabled, int& mode);
LIB_GIPSVE_API bool GIPSVE_SetNsMode(bool enabled, int mode);


LIB_GIPSVE_API bool GIPSVE_GetNsMode(bool& enabled, int& mode);
/*
设置发送方的Echo Control (EC)类型
0  previously set mode
1  platform default
2  conferencing default (aggressive AEC)
3  Acoustic Echo Cancellation
4  AEC mobile
*/
LIB_GIPSVE_API bool GIPSVE_SetEcMode(bool enabled, int mode);


LIB_GIPSVE_API bool GIPSVE_GetEcMode(bool& enabled, int& mode);




LIB_GIPSVE_API bool GIPSVE_GetCPULoad(int& loadPercent);


//
LIB_GIPSVE_API bool GIPSVE_GetSystemCPULoad(int& loadPercent);




LIB_GIPSVE_API int GIPSVE_GetNumberOfCodecs();


//取得指定index的Codec
LIB_GIPSVE_API bool GIPSVE_GetCodec(int index, PPCodec& codec);


//取得Playout设备的数目
LIB_GIPSVE_API bool GIPSVE_GetNumberOfPlayoutDevice(int& nb);


//取得指定index的Playout设备的名字
LIB_GIPSVE_API bool GIPSVE_GetPlayoutDeviceName(int index, char name[128], char guid[128]);


//取得Recording设备的数目
LIB_GIPSVE_API bool GIPSVE_GetNumberOfRecordingDevice(int& nb);


//取得指定index的Recording设备的名字
LIB_GIPSVE_API bool GIPSVE_GetRecordingDeviceName(int index, char name[128], char guid[128]);




//设置想要使用的Playout设备的index,index值位于0到GetNumberOfPlayoutDevice()之间
//Free版不支持,Commercial支持
LIB_GIPSVE_API bool GIPSVE_SetPlayoutDevice(int index);


//设置想要使用的Recording设备的index,index值位于0到GetNumberOfRecordingDevice()之间
//Free版不支持,Commercial支持
LIB_GIPSVE_API bool GIPSVE_SetRecordingDevice(int index);




//取得当前speaker的volume,值位于0-255之间
LIB_GIPSVE_API bool GIPSVE_GetMicVolume(unsigned int& volume);


//设置Speaker的音量,volume必须位于0-255之间
LIB_GIPSVE_API bool GIPSVE_SetMicVolume(unsigned int volume);


//取得当前speaker的volume,值位于0-255之间
LIB_GIPSVE_API bool GIPSVE_GIPSVE_GetSpeakerVolume(unsigned int& volume);


//设置Speaker的音量,volume必须位于0-255之间
LIB_GIPSVE_API bool GIPSVE_SetSpeakerVolume(unsigned int volume);


//暂不支持该函数
LIB_GIPSVE_API bool GIPSVE_GetInnerVersionInfo(char version[1024]);


//返回版本(该版本的编译时间)
LIB_GIPSVE_API bool GIPSVE_GetVersionInfo(char version[64]);


//如果任何函数的调用返回了非0值,可以调用这个函数来取得错误的原因
LIB_GIPSVE_API int GIPSVE_LastError();
0
0

查看评论
* 以上用户言论只代表其个人观点,不代表CSDN网站的观点或立场
    个人资料
    • 访问:129314次
    • 积分:2173
    • 等级:
    • 排名:第18705名
    • 原创:67篇
    • 转载:93篇
    • 译文:0篇
    • 评论:16条
    最新评论