首页 > 代码库 > PJSUA2开发文档--第七章 呼叫 Calls类
PJSUA2开发文档--第七章 呼叫 Calls类
7 呼叫Calls
呼叫由Call类处理
7.1 子类化Call类
要使用Call类,应用程序应创建子类,如:
class MyCall : public Call { public: MyCall(Account &acc, int call_id = PJSUA_INVALID_ID) : Call(acc, call_id) { } ~MyCall() { } // Notification when call‘s state has changed. virtual void onCallState(OnCallStateParam &prm); // Notification when call‘s media state has changed. virtual void onCallMediaState(OnCallMediaStateParam &prm); };
在其子类中,应用程序可以实现呼叫回调,基本上用于处理与呼叫有关的事件,如呼叫状态更改或来电转接请求。
7.2 呼出 Making Outgoing Calls
拨出电话很简单,只需调用Call对象的makeCall()方法即可。假设在“dest_uri”中将Account对象作为acc变量和目标URI字符串,可以使用下面的代码段发起呼出:
Call *call = new MyCall(*acc); CallOpParam prm(true); // Use default call settings try { call->makeCall(dest_uri, prm); } catch(Error& err) { cout << err.info() << endl; }
上面的代码段创建一个Call对象,并使用默认的呼叫设置启动到dest_uri的呼出。对呼叫的后续操作可以使用呼叫实例中的方法,并且将呼叫的事件报告给回调。有关回调的更多内容将稍后解释。
7.3 接收来电 Receiving Incoming Calls
来电将被报告为Account类的onIncomingCall()。必须从Account类派生一个类来处理来电。
以下是回调实现的示例代码:
void MyAccount::onIncomingCall(OnIncomingCallParam &iprm)
{
Call *call = new MyCall(*this, iprm.callId);
CallOpParam prm;
prm.statusCode = PJSIP_SC_OK;
call->answer(prm);
}
对于来电,如以上所示,在回调函数中创建呼叫实例。应用程序应确保在呼叫生命周期内存储呼叫实例(直到呼叫断开连接)。
7.4 呼叫属性
所有呼叫属性,如状态,媒体状态,远端(远程对等体)信息等都存储为CallInfo类,可以使用Call的getInfo()方法获取。
7.5 呼叫断开
呼叫断开事件是一个特殊的事件,因为一旦报告此事件的回调返回,该调用将不再有效,并且调用对象的任何操作将引发错误异常。因此,建议删除回调中的调用对象。
Call的onCallState()方法报告呼叫断开,可以检测如下:
void MyCall::onCallState(OnCallStateParam &prm) { CallInfo ci = getInfo(); if (ci.state == PJSIP_INV_STATE_DISCONNECTED) { /* Delete the call */ delete this; } }
7.6 与通话的音频媒体工作
当呼叫的音频媒体准备就绪(或激活)时,只能使用呼叫的音频媒体(例如,连接会议电话中的声音设备的呼叫)。呼叫媒体状态的更改在onCallMediaState()回调中报告,如果呼叫音频媒体已准备就绪(或活动),则Call.getMedia()函数将返回有效的音频媒体。
以下是当媒体处于活动状态时将呼叫连接到声音设备的示例代码:
void MyCall::onCallMediaState(OnCallMediaStateParam &prm) { CallInfo ci = getInfo(); // Iterate all the call medias for (unsigned i = 0; i < ci.media.size(); i++) { if (ci.media[i].type==PJMEDIA_TYPE_AUDIO && getMedia(i)) { AudioMedia *aud_med = (AudioMedia *)getMedia(i); // Connect the call audio media to sound device AudDevManager& mgr = Endpoint::instance().audDevManager(); aud_med->startTransmit(mgr.getPlaybackDevMedia()); mgr.getCaptureDevMedia().startTransmit(*aud_med); } } }
当音频媒体变得不活动时(例如当呼叫被保持)时,不需要停止到/从声音设备的音频媒体传输,因为(当音频媒体不再有效时)呼叫的音频媒体将自动从会议桥被移除,这也将自动删除来自或连接到该呼叫的所有连接。
7.7 呼叫操作
可以调用Call对象的操作,例如挂断,保持呼叫,发送re-INVITE等。请参阅Call的参考文档以获取更多信息。
7.8 即时消息(IM)
可以使用Call.sendInstantMessage()在通话中发送IM。Call.onInstantMessageStatus()回调方法报告传出即时消息的传输状态。
除了发送即时消息,还可以使用Call.sendTypingIndication()发送打字指示。
在呼叫中收到的IM和打字指示将在回调函数Call.onInstantMessage()和Call.onTypingIndication()中报告。
或者,您可以通过使用Buddy.sendInstantMessage()和Buddy.sendTypingIndication()发送IM和打电话外的指示。有关更多信息,请参阅文档。
7.9 类参考
7.9.1 Call
class pj::Call Call.
Public Functions
Call(Account & acc, int call_id = PJSUA_INVALID_ID)
PJSUA2开发文档--第七章 呼叫 Calls类