语音通话模块介绍(三) CSipSimple介绍
CSipSimple简介
CSipSimple是基于PJSIP开源协议库实现的Android程序,这里主要围绕CSipSimple的功能实现讲解。凡是在CSipSimple中涉及到的Android知识点以及PJSIP相关内都会进一步的分析。
项目中主要有几个包:
api
包下主要是一些静态的常量,关于
sip
的管理。
db
包当然是数据库了,它也使用了标准的
ContentProvider
,其中一些建表的语句还是用
api
包中的类。
pjsip
就是这个库相关的类了,具体没有研究。在编译
jni
前,这部分是有问题的,因为它需要
jni
的调用,工程也会报错。编译后生成一些
jni
对应的调用文件就正常了,生成的文件在
org.pjsip
下。
utils
包就是一些帮助类,比如配置管理,音频自动聚焦。联系人,剪切版。
widgets
包是一些自定义的控件。
wizards
包是辅助用户的引导用的。
plugins
包是插件,没看出有什么用处。
service
包也是这里的重点:
MediaManager
音频管理的,控制不同的音频流,来电时的音频,蓝牙,静音等。
OutgoingCall
是呼出接收器,先通过这个拦截,可以拦截到系统电话的呼叫,与程序内的呼叫。然后自定义了选择器。
Downloader
处理下载的,更新的时候就是用这个下载的。默认使用的是
cacheDir
目录。
SipNotifications
是一个通知类,主要管理了通知。
SipService
这里的主要服务。
ui
包下就是关于界面的一些类了,
account
是添加帐户的。
filters
是关于帐户的过滤的,还使用了拖动排序的
ListView
。
calllog
就是通话日志了。日志有选择保存在系统的通话中还是软件中。
incall
就是来电的,与通话界面了。
dialpad
是拨号面板
还有一个包是
org.webrtc.videoengine
,这里是视频通话时用到的,一看名字就知道了
camera
。
暂时没有找到视频的插件的源码在哪里下载。但有编译好的
apk
。使用
x264
编码。
CSipSimple框架介绍
CSipSimple由应用层,JNI层,驱动层等组成。其中应用层和JNI层是该程序的核心,而驱动层根据设备提供。在应用层中,主要围绕了Android四大组件进行。其中:
Activity:完成界面UI显示;
Intent:主要是实现在Activity和Activity之间的切换
Service:完成activity和后台之间的联系以及进程间的通信
ContentProvider:完成数据保存及共享,主要保存一些设置,用户状态,好友等信息
Broadcast:主要完成在系统内信息的广播,一般会和ContentProvider结合,如当数据改变了,就携带信息发送广播,当所有已注册的广播接收器接收到内容之后进行解析之后进行相应的操作。
在JNI层,因为PJSIP核是基于C语言的,如果要用java调用,就必须封装本地的JNI库,从而实现从上到下的调用。
1 主界面
主界面是SipHome这个Activity。在该Activity中,引入了Andriod新版本才有的actionBar。ActionBar的作用可以统一页面导航和切换方式,可以突出显示一些重要的操作,而把一些不那么重要的或者使用频率低的放在overflow中。所以这里引入了4个Tab,分别对应DialerFragment ,CallLogListFragment,FavListFragListFragment和ConversationFragment后通过使用ViewPager实现多页面切换就可以实现这几个activity的呈现。如图1.1:
![](https://img-blog.csdn.net/20131120101151875?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQvdXAxdXAydXAz/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/Center)
2一些基本参数设置
在进行相关操作,如添加用户,打电话,发送信息之前。一些必要的设置如,只使用WIFI,开启ICE功能,开启STUN功能等参数设置必不可少。所以在刚开始使用时,一般我们会打开上面介绍的设置菜单项,其路径为:com.csipsimple.ui.prefs.hc.MainPrefs这个MainPrefs。 这里讲解MainPrefs这个Acitivty是如何实现的。首先该activity使用“headers”来进行屏幕显示。其界面如图2所示,共有6个header。而通过xml文件下进行相关的xml编写然后在MainPrefs中的onBuilder方法进行加载即可。而各个header都有相应的class。如图1.2:Andriod使用ContentProvider来保存数据。这里参数保存,文件配置在DBProvider.class和Preference中,其中DBProvider中主要和添加用户注册,信息,filter等关联。
![](https://img-blog.csdn.net/20131120101235734?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQvdXAxdXAydXAz/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/Center)
3 添加用户(注册用户)
1
在
AccountsEditListFragment
中设置完相关参数信息后,跳转到
BasePrefsWizard
(
Intent
携带
wizardId
,我们这里使用的是
Basic
类型),可根据
wizardId
进行相应
wizard
的实例显示
2
当设置好注册用户的相关数据之后,点击保存按钮之后进入
BasePrefsWizard
下的
saveAccount
函数,在该函数中进行了
getContentResolver
().insert
语句,即关于操作
ContentProvider
的语句。这里根据
Uri
查询后进入
DBProvider
的
insert
方法,进而执行广播命令
getContext
().
sendBroadcast
(
publishIntent
).
3
Csipsimple
在这里注册了两个广播,一个
AccountWidgetProvider
和
DynamicReceiver4
,我们这里只用到
DynamicReceiver4
,其注册方式为动态注册(在
SipService
注册了
DynamicReceiver4
广播接收器 )
4
当上面第二点分析的发出广播信息后,主要有两个
reciever
会做出相应的操作,分别
DynamicReceiver4
和
AccountWidgetProvider
。
5
在
DynamicReceiver4
中重写了
onReceive
,
即也是接收信息的函数。然后进入判断语句,上面发送的广播所携带的信息为
ACTION_SIP_ACCOUNT_CHANGED
这样的
action
,
根据这个
action
,
执行了
SipService.setAccountRegistration
()
这个函数,从而跳转到
service
中执行。这里也就是用户开始注册的位置。
6
PJSUA
操作
:
在上面的添加用户操作中,其实已经和底层的
JNI
打交道了,如执行
SipService.setAccountRegistration
()
这个函数之后就会调用底层的
JNI
库。而在执行这些
JNI
库之前。又关于
PJSUA
的一些初始化设置。这一节主要说明这个。在说明进行初始化之前,先说明下
PJSIP
库框架
(
语音通话模块介绍(一))
7
通过
SipService
的
onStart
()
函数,加载
JNI
库
(
会跳到
PjSipService
的
tryToLoadStack
方法执行
) ,
而何时进行
PJSUA
初始化,
CSipSimple
中,在
SipService
开始,当注册完广播接收器之后还进行了这一步:
deviceStateReceiver.startMonitoring
()
,程序进入
DynamicReciever4
的
startMonitoring
()
函数,进而在
onConnectivityChanged
()
函数中调用了
SipService
的
restartSipStack
函数,从而进入
startSipStack
()
函数并调用了
pjService.sipStart
()
方法。而这个
sipStart
()
函数就是
PJSUA
初始化的所在处。
8 在
sipStart
函数中,结合
PJSIP
开发文档。从开发文档中我们知道,基础的
PJSUA-API
控制
PJSUA
的创建,初始化,启动,同时还提供各种辅助功能。在
sipStart
函数中,通过
status =
pjsua.create
();
完成
pjsua
的创建,除其他事项外,还初始化
PJLIB
,
PJLIB-UTIL
,并创建了一个
SIP endpoint
。在调用任何
PJLIB
功能之前这是至关重要的一步。
9 进行了上面的初始化之后,并进行一些
General Configure
。一般情况下,应用程序都将通常需要执行一些任务,使用
pjsua_transport_create
()
方法(该方法是
C
语言)来创建
SIP
传输。故在
CSipSimple
中有
createTransport
这样的方法来创建
SIP
传输。完成这些初始化之后,应用程序必须调用
status =
pjsua.start
()
开始
PJSUA
,此函数将检查所有的配置是否正确,如果没有则采用默认配置
10 在前面步骤中,用户添加是从接收器
DynamicReceiver4
执行了
SipService.setAccountRegistration
这个函数开始的,确切的讲,连接底层
JNI
库的都在
PjSipService
中进行,此处也是这样。进入到
PjSipService
中的
setAccountRegistration
方法。然后根据
account
的不同情况进行不同的操作,首次添加用户将会进行这一步
status =
pjsua.acc_add
(
account.cfg
,
pjsuaConstants.PJ_FALSE
,
accId
)
。
这里
acc_add
即调用了底层的
JNI
库的
pjsuaJNI.acc_add
,
从而返回添加成功与否的状态。根据该状态进行相应状态的改变,从而改变显示界面,这个是内容观察者
ContentObserver
的作用,下面这个步骤分析下这个内容观察器。
11 在
CSipSimple
中很多地方使用了
ContentObserver
进行更新。
ContentObserver
是个内容观察者。看过
HeadFirst
模式的话就知道,其实
ContentObserver
正是基于观察者模式实现的。所谓观察者,目的就是观察(捕捉)特定的
Uri
引起的数据库变化,当其所观察的
Uri
发生改变了,便进行触发。正是因为
ContentObserver
的实现是基于观察者模式的,所以其使用显得尤其简单,我们只需创建一个特定的
ContentObserver
派生类(如图),重载父类构造函数以及
onChang
()
方法处理回调后的功能实现(即观察者模式中某一事件发生变化之后进行
notify
),然后要进行相应的注册,即注册内容观察者和取消注册的步骤即基本完成操作
4 拨打电话
Java
层接口调用的是
placeCall
()
函数,进入
placeCall
函数之后,如判断为
SIP
用户,则进行
SipService
方法调用,否则直接进行基本用户拨打,如图程序
:
![](https://img-blog.csdn.net/20131120101527468?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQvdXAxdXAydXAz/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/Center)
这里只说明使用
SIP
电话拨打情况。程序调用了
SipService
的
makeCallWithOptions
方法。进而进入
SipService
的
makeCallWithOptions
方法。如图所示:
![](https://img-blog.csdn.net/20131120101553765?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQvdXAxdXAydXAz/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/Center)
这样,最终调用
PJsipService
的
makeCall
。如图所示:
![](https://img-blog.csdn.net/20131120101615968?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQvdXAxdXAydXAz/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/Center)
米糊软件开发室:http://shop62437931.taobao.com/?spm=0.0.0.0