QuteCom手记:Phapi/exosip事件①拨号INVITE

最新推荐文章于 2023-01-05 11:22:11 发布

Vinc

最新推荐文章于 2023-01-05 11:22:11 发布

阅读量7.1k

点赞数

分类专栏： QuteCom手记文章标签：电话 callback ui gtk build api

本文链接：https://blog.youkuaiyun.com/lanzheng_1113/article/details/6584228

版权

QuteCom手记专栏收录该内容

20 篇文章

订阅专栏

本文介绍了QuteCom拨打电话时的事件链，从UI到底层SIP协议栈，详细阐述了电话状态变化、事件传递过程，涉及到phapi、exosip和osip2。拨号时，事件从UI出发，经过多个层级最终到达UI显示正在拨号，同时分析了事件回调和线程上下文的切换。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

@1、电话状态变化和电话事件传递

先看一下phapi的电话状态变化图，该图在phapi-old.h中可以找到

/**
 * @defgroup phAPI  Phone API
 * @{
 * 格式错误无法正常显示,见PHAPI-OLD.H*/

状态名字都很简单，不在赘述。在PHAPI中，当状态发生变化时都会触发对应的事件。

事件由owplFireCallEvent一系列系列函数发布，函数的声明在qutecom\wifo\phapi\phevents.h中定义。

事件的起源可能是从UI传递的命令，也可能是osip协议栈接收到的标识电话状态改变的数据包。用简单的流程图表示如下：

UI<==>owphone<==>SipWrapper(PhapiWrapper)<==>phapi<==>exosip<==>osip2

@2、拨打电话(makeCall)触发的事件链

按下界面下方拨号按钮拨打电话

$1、从UI传递消息给底层SIP协议栈的过程

QtCallBar::callButtonClickedSlot()//线程上下文在QCoreApplication::instance()中。

==>QtQuteCom::callButtonClicked()

==>CUserProfile::makeCall()

==>UserProfile::makeCall()//在QuteCom::getInstance()实例的上下文中执行

==>PhoneLine-::makeCall()

==>PhoneCall::setState(EnumPhoneCallState::PhoneCallStateDialing)

==>PhApiWrapper::makeCall()

==>owplCallConnect()// phapi

==>phLinePlaceCall_withCa()

| ==>eXosip_build_initial_invite()//exosip

| ==>eXosip_initiate_call()

|==> owplFireCallEvent(CALLSTATE_REMOTE_OFFERING);

owplFireCallEvent将一个CALLSTATE_REMOTE_OFFERING（通话邀请已经发出）的事件通过phapi发给一系列的callBack函数（对象）。

再看CALLSTATE_REMOTE_OFFERING如何传到UI上表示。

owplFireCallEvent(CALLSTATE_REMOTE_OFFERING)//phapi

==>owplFireEvent(EVENT_CATEGORY_CALLSTATE);

==>OWPL_EVENT_CALLBACK_PROC::cbFunc ()//回调函数，见①

==>phApiEventsHandler()//PhapiCallback.cpp

==>PhApiCallbacks::callProgress() //处理电话事件的回调，见②

==>PhApiWrapper::phoneCallStateChangedEvent()

==>PhApiWrapper::phoneCallStateChangedEventHandler()

|==>PhApiWrapper::phoneCallStateChangedEventHandler()//不做任何事，见③

| ==>SipCallbacks::phoneCallStateChangedEventHandler()

==>PhoneLine::setPhoneCallState()

==>PhoneCall::stateChangedEvent()

==>CPhoneCall::stateChangedEventHandler()//注意线程上下文切换至QCoreApplication（界面线程）④

==>QtPhoneCall::stateChangedEvent()//调整界面，显示正在拨号。

①通过PhApiCallbacks::startListeningPhApiEvents()为回调函数队列gEventSubscriber添加消息处理回调，phapi接收到事件后将逐个调用回调函数。因此如果需要监控所有的sip事件而不想修改原有的代码时，可以自己写一个函数xxxxxxxxEventHandler，然后用PhApiCallbacks::startListeningPhApiEvents()把自己写的回调挂上去。

②phApiEventsHandler()函数处理所有的sip事件，除了电话事件外还可以处理注册事件、message事件、notify事件、子状态sub state事件和错误error事件.

③这里PhApiWrapper接收事件，却又不处理，让我感到很疑惑。总之是在SipCallbacks的对象中处理事件。

④CPhoneCall::stateChangedEventHandler()使用PFactory::postEvent(event);，PFactory实际指向QtFactory（在使用GTK UI时指向GTKFactory）。见qutecom\qutecom\src\presentation\main.cpp line 262处。PFactory::postEvent(event)调用QtFactory::postEventImpl(event),最后调用QCoreApplication::postEvent().注意之前的代码执行都是在QuteCom::getInstance()的线程中执行。

但是注意不是所有的上下文切换都在QuteCom::getInstance()和QCoreApplication::getInstance()之间发生，如当收到sip消息时exosip2通信线程将传递事件给QCoreApplication::getInstance()线程处理。