linphoneandroid工程解读Word格式.docx

1、registrationState这个事件反馈的是用户的SIP账号到SIP服务器的注册状态，是成功注册还是注册失败等。 LinphoneManager实现了LinphoneCoreListener, LinphoneChatMessage.LinphoneChatMessageListener这两个接口的部分方法，负责系统需要使用的资源的管理与初始化，管理着LinphoneCore的实例，负责了LinphoneCore的初始化和它的整个生命周期，同时又响应接收到文件消息与文件消息的响应，感觉它的整体职责是有点混乱的，可能作者开始是把它作为全局的统一资源管理器的，可是后来开发着开发着就什么东西都

2、往里面放，就成了这样了。 LinphoneActivity是整个APP的核心界面组件，它采用了容器的结构模式来组织它所要包含的各个Fragment。它维护了一个专门用于存放各个Fragment实例的Fragment列表。它采用的布局文件是main.xml，针对手机与平板电脑分别做了一套布局文件，呵呵。这个布局文件主要是分为上下两个部分，然后上边部分主要是菜单与状态栏，下边那部分再分为两大个部分，一个部分是Fragment的容器，另一个部分是代表功能模块的TAB形式的工具栏。LinphoneActivity也会生成一个LinphoneCoreListenerBase的实例并注册到Linphone

3、Core这个核心实例的事件监听器中，它监听的事件是messageReceived（有用户给自己发信息，这个信息可能是文件也可能是文本），registrationState，callState。当有电话呼入的时候，这个时间当前的组件也会接收到这个事件，然后将界面切换到CallIncomingActivity这个界面组件。 CallIncomingActivity界面组件就是提供一个界面给用户选择接听还是挂断，并设置相关的接听参数。这个界面组件当中也生成一个LinphoneCoreListenerBase的实例并注册到LinphoneCore这个核心实例的事件监听器中，它监听的事件是callSta

4、te，状态是State.CallEnd，这样在对方结束了电话呼入时好通知当前界面对方已经结束通话，不再呼入，那个APP应该结束当前界面，回到主界面状态。在CallIncomingActivity界面组件下，用户选择了接听电话，那么APP将切换到CallActivity这个界面组件下，同时判断当前用户是否接受视频电话，从而决定是视频通话，还是语音通话。 CallActivity这个界面组件是通话界面，这个界面组件当中也生成一个LinphoneCoreListenerBase的实例并注册到LinphoneCore这个核心实例的事件监听器中，它监听的事件是callState，callEncrypti

5、onChanged。callState会通知新的来电呼入，对方暂停通话，对方更新通话设置等相应的事件消息，发便当前界面针对这些消息作出相应的反馈。这个通话界面主要是控制两个Fragment的动态切换，一个是语音通话的CallAudioFragment，在这个Fragment里，用户可以启用不启用麦克风和摄像头等。同时还可以向新的用户发起电话呼叫，不过从目前的界面看是只允许当前用户向某一个用户进行通话的，如果再邀请一个用户进入通话的话，它是把上一个通话的用户设置为暂停通话状态，然后当前用户与多个用户通话的话，就是不断地切换当前通话的用户。另一个是视频通话的CallVideoFragment，这个

6、Fragment主要是展现两个视频流的窗口，一个是当前用户自己的视频在界面的右下角，另一个是通话对方的视频。默认是展现CallVideoFragment，当用户点击CallVideoFragment这个界面的时候，又切换回CallAudioFragment，这样用户才能看到功能栏方便操作。 CallVideoFragment里有两个关键的SurfaceView，分别用户展现当前用户的视频和对方用户的视频。private SurfaceView mVideoView; 这个是对方用户的视频展现控件。private SurfaceView mCaptureView;这个是当前用户的视频展现控件。首

7、先CallVideoFragment 会生成一个androidVideoWindowImpl的实例，这个实例再通过LinphoneManager.getLc（）.setVideoWindow（androidVideoWindowImpl）传入到linphone的核心当中，androidVideoWindowImpl的实例当中的相关事件监听器后续就能接收到内核的想着事件消息通知，从而将视频流传递到对应的SurfaceView当中，设置对方用户视频流到SurfaceView 当中的方法是LinphoneManager.getLc（）.setVideoWindow（vw），设置当前用户视频流到Sur

8、faceView 当中的方法是LinphoneManager.getLc（）.setPreviewWindow（mCaptureView）。 DialerFragment界面组件，提供一个拨号的键盘，用来输入需要呼叫的SIP号码，然后进行呼叫。拨号呼叫调用的是LinphoneManager.getInstance（）.newOutgoingCall（mAddress）这个方法，传递的参数是对方的SIP号码或是SIP地址。newOutgoingCall这个方法里会先对当前使用的网络类型进行检测，用的是LinphoneUtils.isHighBandwidthConnection（）方法。然后最终

9、调用CallManager.inviteAddress（）方法进行呼叫，这个方法最终又调用的LinphoneCore.inviteAddressWithParams（lAddress, params）方法进行呼叫。当LinphoneActivity 订阅的callState事件的state = State.OutgoingInit | state = State.OutgoingProgress的时候，APP界面组件切换到CallOutgoingActivity，由这个界面来展现正在呼出的状态。 CallOutgoingActivity这个界面组件，当中也生成一个LinphoneCoreLis

10、tenerBase的实例并注册到LinphoneCore这个核心实例的事件监听器中，它监听的事件是callState，状态是StateConnected或是StreamsRunning的时候，说明对方接听成功，界面组件再切换回CallActivity，并显示是语音通话界面还是视频通话界面。 CallManager是专门用来进行电话呼叫的管理者类，专门负责对进行呼叫，或是对当前进行的呼叫进行参数设置的更新。 PreferencesListFragment和SettingsFragment界面组件是负责APP的参数设置，设置的参数非常的丰富，有账号，网络，音频，视频等。它们采用的是android框

11、架自带的PreferenceScreen技术来建立整个参数设置的界面与功能，这样就省去了自己来做界面一个个实现相应的参数设置的功能。定义PreferenceScreen最关键的就是编写它对应的XML文件，这个XML文件编写好后，系统会根据它的内容来生成相应的设置界面，非常的方便，相应的技术点可以XX一下。一个PreferenceScreen里还可以嵌套多个PreferenceScreen，从而构建多层级的设置界面。系统里自带有多种类型的设置界面，如ListPreference，CheckBoxPreference等。但是这个PreferenceScreen它并不会保存相关的配置信息，所以这些配

12、置参数的保存还是得由外部来进行保存，随后加载PreferenceScreen界面的时候，重新给里面的各个组件设置上相应的状态。目前在APP中是由LinphonePreferences这个类来负责了配置信息的保存的，而这个类又是依赖LpConfig这个具体负责读写配置文件的类来提供相应的功能，它真正的保存配置的文件是一个类似ini配置文件的文本文件，也就是讲linphone是自己实现的配置保存与读取功能，呵呵，没有用系统自带的，那我们也就沿用它的吧。默认的配置文件就在工程的res/raw下边，而PreferenceScreen配置文件就是在工程的res/xml下。 HistoryListFrag

13、ment是呼入呼出历史列表的展现界面组件，这些呼入呼出的历史记录数据LinphoneCore是直接自己用数据记录下来了的，所以APP不需要考虑记录这些信息，除非需要自己定制地保存这些信息，不想用LinphoneCore的。通过LinphoneManager.getLc（）.getCallLogs（）可以获得呼入呼出的历史记录。 LinphoneCore是整个linphone内核基于JNI的封装接口，LinphoneCoreImpl是linphone内核针对JAVA开发语言的封装。所有linphone内核的相关方法都是通过它来向android系统暴露。它里面有方法非常的多，这里需要关注几个关键的

14、方法。public void iterate（）;最为关键的主循环方法，应用程序应该经常调用它，因为它在后台会完成多件事情，如接收SIP指令，注册，认证，超时检测等，它必须要运行在LihpnoCore其它的方法所运行的线程里，说白了就是要保证LinphoneCore的方法运行在一至的线程里，不然就出错了。public LinphoneCall invite（LinphoneAddress to）throws LinphoneCoreException;向对方发起一个电话呼叫请求。public void terminateCall（LinphoneCall aCall）;结束当前的电话呼叫。public void declineCall（LinphoneCall call, Reason reason）;直接挂断当前正在呼入的电话请求。public LinphoneCall getCurrentCall（）;获取当前正在进行电话通话的实例。public LinphoneAddress getRemoteAddress（）;获取当前通话下对方的SIP