1,Linphone简介
1.1 简介
LinPhone是一个遵循GPL协定的开源网络电话或者IP语音电话(VOIP)零碎,其次要如下。应用linphone,开发者能够在互联网上随便的通信,包含语音、视频、即时文本音讯。linphone应用SIP协定,是一个规范的开源网络电话零碎,能将linphone与任何基于SIP的VoIP运营商连接起来,包含咱们本人开发的收费的基于SIP的Audio/Video服务器。
LinPhone是一款自由软件(或者开源软件),你能够随便的下载和在LinPhone的根底上二次开发。LinPhone是可用于Linux, Windows, MacOSX 桌面电脑以及Android, iPhone, Blackberry挪动设施。
学习LinPhone的源码,开源从以下几个局部着手:
Java层框架实现的SIP三层协定架构: 传输层,事务层,语法编解码层;
linphone动静库C源码实现的SIP性能: 注册,申请,申请超时,邀请会话,挂断电话,邀请视频,收发短信…
linphone动静库C源码实现的音视频编解码性能;
Android平台上的音视频捕捉,播放性能;
1.2 根本应用
如果是Android零碎用户,能够从谷歌利用商店装置或者从这个链接下载Linphone 。装置实现后,点击左上角的菜单按钮,抉择进入助手界面。在助手界面,能够设定SIP账户或者Linphone账号,如下图:
对于咱们来说,就是设置SIP账户,须要填入几个参数:
- 用户名:就是SIP账户号码或名称。
- 明码:该SIP账户对应的明码。
- 域名:填写SIP服务器(IPPBX)的IP地址或域名。
- 显示名:该SIP账户的显示名,是可选的。
- 传输:该SIP服务器反对传输协定,个别是UDP,也能够依据须要抉择TCP或者TLS。
注册胜利之后呢,软电话APP会有提示信息,左上角显示连贯状态,如下图。
而后,输出对方的SIP账户,就能够通话了,如下图。
1.3 相干文档
上面是Linphone开发可能会用到的一些材料:
- Linphone官网 :http://www.linphone.org/technical-corner/liblinphone
- 官网文档:https://wiki.linphone.org/xwiki/wiki/public/view/Lib/Getting%20started/Android/
- 官网Android Demo:https://gitlab.linphone.org/BC/public/linphone-android
- 各个版本的aar库:https://linphone.org/releases/maven_repository/org/linphone/linphone-sdk-android/
2,疾速上手
2.1 编译App
首先,应用 Android Studio关上我的项目,而后构建/装置应用程序即可,可能编译过程中会比较慢。当然,也能够应用命令形式进行编译:
./gradlew assembleDebug
//或者
./gradlew installDebug
2.2 编译SDK
在Android利用程序开发中,引入第三方库的形式有源码依赖和sdk依赖。当然,咱们也能够把sdk的代码下载下来,而后执行本地编译。
git clone https://gitlab.linphone.org/BC/public/linphone-sdk.git --recursive
而后装置官网文档的阐明编译sdk。
2.3 集成Linphone
首先,须要引入linphone依赖,能够间接下载aar包执行本地以来,也能够应用gradle形式引入。此处,咱们应用他人曾经编译好的sdk:
dependencies {
//linphone
debugImplementation "org.linphone:linphone-sdk-android-debug:5.0.0"
releaseImplementation "org.linphone:linphone-sdk-android:5.0.0"
}
CoreManager
为了不便调用,咱们须要对Linphone进行简略的封装。首先,依照官网文档的介绍,创立一个CoreManager类,此类是sdk外面的治理类,用来管制复电铃声和启动CoreService,无非凡需要不需调用。须要留神的是,启动复电铃声须要导入media包,否则不会有复电铃声,如下:
implementation 'androidx.media:media:1.2.0'
而后,咱们新建一个LinphoneManager类用来治理Linphone sdk,比方将Linphone注册到服务器、拨打语音电话等。
class LinphoneManager private constructor(private val context: Context) {
... //省略其余代码
/**
* 注册到服务器
*
* @param username 账号名
* @param password 明码
* @param domain IP地址:端口号
*/
fun createProxyConfig(
username: String,
password: String,
domain: String,
type: TransportType? = TransportType.Udp
) {
core.clearProxyConfig()
val accountCreator = core.createAccountCreator(corePreferences.xmlRpcServerUrl)
accountCreator.language = Locale.getDefault().language
accountCreator.reset()
accountCreator.username = username
accountCreator.password = password
accountCreator.domain = domain
accountCreator.displayName = username
accountCreator.transport = type
accountCreator.createProxyConfig()
}
/**
* 勾销注册
*/
fun removeInvalidProxyConfig() {
core.clearProxyConfig()
}
/**
* 拨打电话
* @param to String
* @param isVideoCall Boolean
*/
fun startCall(to: String, isVideoCall: Boolean) {
try {
val addressToCall = core.interpretUrl(to)
addressToCall?.displayName = to
val params = core.createCallParams(null)
//启用通话录音
// params?.recordFile = LinphoneUtils.getRecordingFilePathForAddress(context, addressToCall!!)
//启动低宽带模式
if (LinphoneUtils.checkIfNetworkHasLowBandwidth(context)) {
Log.w(TAG, "[Context] Enabling low bandwidth mode!")
params?.enableLowBandwidth(true)
}
if (isVideoCall) {
params?.enableVideo(true)
core.enableVideoCapture(true)
core.enableVideoDisplay(true)
} else {
params?.enableVideo(false)
}
if (params != null) {
core.inviteAddressWithParams(addressToCall!!, params)
} else {
core.inviteAddress(addressToCall!!)
}
} catch (e: Exception) {
e.printStackTrace()
}
}
... //省略其余代码
}
CoreService
接下来就是CoreService类,该类的作用是一个保活服务,在复电时会调用触动办法和启动告诉,所以必须在AndroidManifest.xml里注册。
<service
android:name="org.linphone.core.tools.service.CoreService"
android:foregroundServiceType="phoneCall|camera|microphone"
android:label="@string/app_name"
android:stopWithTask="false" />
官网Demo那样继承CoreService而后本人实现 。
class CoreService : CoreService() {
override fun onCreate() {
super.onCreate()
Log.i("[Service] Created")
}
override fun onStartCommand(intent: Intent?, flags: Int, startId: Int): Int {
Log.i("[Service] Ensuring Core exists")
if (corePreferences.keepServiceAlive) {
Log.i("[Service] Starting as foreground to keep app alive in background")
if (!ensureCoreExists(applicationContext, pushReceived = false, service = this, useAutoStartDescription = false)) {
coreContext.notificationsManager.startForeground(this, false)
}
} else if (intent?.extras?.get("StartForeground") == true) {
Log.i("[Service] Starting as foreground due to device boot or app update")
if (!ensureCoreExists(applicationContext, pushReceived = false, service = this, useAutoStartDescription = true)) {
coreContext.notificationsManager.startForeground(this, true)
}
coreContext.checkIfForegroundServiceNotificationCanBeRemovedAfterDelay(5000)
}
return super.onStartCommand(intent, flags, startId)
}
override fun createServiceNotificationChannel() {
// Done elsewhere
}
override fun showForegroundServiceNotification() {
Log.i("[Service] Starting service as foreground")
coreContext.notificationsManager.startCallForeground(this)
}
override fun hideForegroundServiceNotification() {
Log.i("[Service] Stopping service as foreground")
coreContext.notificationsManager.stopCallForeground()
}
override fun onTaskRemoved(rootIntent: Intent?) {
if (!corePreferences.keepServiceAlive) {
if (coreContext.core.isInBackground) {
Log.i("[Service] Task removed, stopping Core")
coreContext.stop()
} else {
Log.w("[Service] Task removed but Core in not in background, skipping")
}
} else {
Log.i("[Service] Task removed but we were asked to keep the service alive, so doing nothing")
}
super.onTaskRemoved(rootIntent)
}
override fun onDestroy() {
if (LinphoneApplication.contextExists()) {
Log.i("[Service] Stopping")
coreContext.notificationsManager.serviceDestroyed()
}
super.onDestroy()
}
}
3,其余优化
对于局部设施可能存在啸叫、乐音的问题,能够批改assets/linphone_factory 文件下的语音参数,默认曾经配置了一些,如果不能满足你的要求,能够增加上面的一些参数。
回声打消
- echocancellation=1:回声打消这个必须=1,否则会听到本人谈话的声音
- ec_tail_len= 100:尾长示意回声时长,越长须要cpu解决能力越强
- ec_delay=0:延时,示意回声从话筒到扬声器工夫,默认不写
- ec_framesize=128:采样数,必定是刚好一个采样周期最好,默认不写
回声克制
- echolimiter=0:等于0时不散会有空洞的声音,倡议不开
- el_type=mic:这个选full 和 mic 示意克制哪个设施
- eq_location=hp:这个示意均衡器用在哪个设施
- speaker_agc_enabled=0:这个示意是否启用扬声器增益
- el_thres=0.001:零碎响应的阈值 意思在哪个阈值以上零碎有响应解决
- el_force=600 :管制收音范畴 值越大收音越广,意思是否收到很远的背景音
- el_sustain=50:管制发声到缄默工夫,用于管制声音是否拉长,意思说完一个字是否被拉长丢包时心愿拉长防止断断续续
降噪
- noisegate=1 :这个示意开启降乐音,不散会有背景音
- ng_thres=0.03:这个示意声音这个阈值以上都能够通过,用于判断哪些是乐音
- ng_floorgain=0.03:这个示意低于阈值的声音进行增益,用于弥补声音太小被吃掉
网络抖动延时丢包
- audio_jitt_comp=160:这个参数用于抖动解决,值越大解决抖动越好,但声音延时较大 理论值是80依据理论调整160
- nortp_timeout=20:这个参数用于丢包解决,值越小丢包越快声音不会断很长时间,同时要跟el_sustain配合声音才好听
源码参考:
https://github.com/MattLjp/LinphoneCall
发表回复