本文链接:https://blog.csdn.net/alwaysrun/article/details/103939541, 感谢作者。
PJSIP注册呼叫流程简介
注册注销
电话呼叫
在《SIP开源库pjSIP简介》中介绍了pjSIP的基本框架,本节对pjSIP中SIP的注册与呼叫具体流程进行简要说明。
注册注销
SIP通过register
进行注册请求:
-
终端向VoIP服务器发送register请求:URL中包含注册服务器的域名地址,To头域中包含准备生成的地址记录,Contact头域中表明此次注册所要绑定的地址(其中Expire表示绑定失效时长);
-
VoIP服务器返回401响应,要求用户鉴权;
-
终端发送带鉴权信息的注册请求;
-
注册完成;
SIP的注销流程与注册流程基本相同,只是Expires参数为0(标识注销)
注册接口
pjSIP中通过pjsua_acc_add来添加用户信息并完成注册;若不用默认的5060注册端口,则需要增加代理设置,以便客户端能正确地连接;注册成功后会返回注册账户id(非负数)。
-
-
-
-
-
-
pj_acc_id g_accId = -1;
-
-
int pjRegister(){
-
pjsua_acc_config accConfig;
-
psua_acc_config_default(&accConfig);
-
accConfig.id = pj_str("sip:" PJ_User "@" PJ_Server);
-
accConfig.reg_uri = pj_str("sip:" PJ_Server); // Comment, if not need register
-
-
// Cred
-
accConfig.cred_count = 1;
-
auto &cred = accConfig.cred_info[0];
-
cred.realm = pj_str(PJ_Server);
-
cred.scheme = pj_str("digest");
-
cred.username = pj_str(PJ_User);
-
cred.data_type = PJSIP_CRED_DATA_PLAIN_PASSWD;
-
cred.data = pj_str(PJ_Psw);
-
-
if(stod(PJ_Port) != 5060){
-
accConfig.proxy_cnt=1;
-
accConfig.proxy[0]=pj_str("sip:" PJ_Server ":" PJ_Port)
-
}
-
-
auto nStatus = pjsua_acc_add(&accConfig, PJ_FALSE, &g_accId);
-
if (!PjRetsuccess(nStatus)){
-
...
-
}
-
-
...
-
}
pjsua_acc_add主要是添加客户端账户信息,后续呼叫时,就使用此账户信息;即使直呼(不需要注册直接呼叫,此时不要设定reg_uri)也需用调用此接口增加账户信息。账户不再需要时,通过pjsua_acc_del来删除账户(若注册过,则会自动注销)。
注册事件
注册完成后(无论成功还是失败),都会触发注册状态改变事件(初始化pjSUA时设定的Onregstate回调);在此事件中,即可获取注册状态。
-
static void OnRegState(pjsua_acc_id accId){
-
pjsua_acc_info accInfo;
-
auto nStatus = pjsua_acc_get_info(accId, &accInfo);
-
-
bool bReged = accInfo.has_registration
-
&& (accInfo.expires > 0)
-
&& (accInfo.status / 100 == 2);
-
-
// To log wheather registered
-
}
电话呼叫
SIP终端通过向代理(如,VoIP Server)发invite
消息实现:
-
SIP终端A向代理发送invite请求:消息体中有终端A的媒体属性SDP描述;
-
代理返回407响应,要求鉴权;
-
SIP终端A重发带鉴权信息的invite请求;
-
代理返回
100 Tring
响应,并转发invite请求到终端B; -
终端B振铃,并返回(给代理)
180 Ringing
响应,代理再转发给终端A; -
终端B摘机,返回
200 OK
响应:消息体中有终端B的媒体属性SDP描述,代理再转发给终端A; -
终端A返回ACK确认;
A与B注册在不同代理的情形:
呼叫接口
pjSIP中通过pjsua_call_make_call实现电话呼叫,呼叫之前必须保证已添加了账户信息;通话完成后,通过pjsua_call_hangup/pjsua_call_hangup_all挂机,有来电时通过pjsua_call_answer接听。
-
-
int pjMakeCall(){
-
auto toCall = pj_str("sip:" PJ_Called "@" PJ_Server)
-
auto nStatus = pjsua_call_make_call(g_accId, &toCall, NULL, NULL, NULL, NULL);
-
if (!PjRetsuccess(nStatus)){
-
...
-
}
-
-
...
-
}
呼叫事件
呼叫状态改变时,会触发呼叫状态改变事件(初始化pjSUA时设定的OnCallState回调);在此事件中可获取具体通话状态。
-
static void OnCallState(pjsua_call_id callId, pjsip_event *pEvent){
-
pjsua_call_info callInfo;
-
auto nStatus = pjsua_call_info(callId, &callInfo);
-
-
if(callInfo.state == PJSIP_INV_STATE_DISCONNECTED){
-
// Call hanguped
-
ToStopMedia(callInfo);
-
// ... other clear
-
}
-
}
通话真正开始(RTP媒体流建立),会触发媒体状态改变事件(初始化pjSUA时设定的OnMediaState回调),此时可以对媒体处理(如关联麦克风、扬声器等)。
-
static void OnMediaState(pjsua_call_id callId){
-
pjsua_call_info callInfo;
-
auto nStatus = pjsua_call_info(callId, &callInfo);
-
-
if(callInfo.media_status == PJSUA_CALL_MEDIA_ACTIVE){
-
// has started trans media
-
ToStartMedia(callInfo);
-
-
// 若只是与声卡设备连接,执行连接0端口即可
-
// pjsua_conf_connect(ci.conf_slot, 0);
-
// pjsua_conf_connect(0, ci.conf_slot);
-
}
-
}
如若非直接通过声卡收发媒体,则需要自己去创建媒体处理端口,具体如何处理后续章节再讲。