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（非负数）。

#define PJ_User "1000"
#define PJ_Psw  "1234"
#define PJ_Server "192.168.1.100"
#define PJ_Port "5060"

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接听。

#define PJ_Called 3000
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);
  }
}

如若非直接通过声卡收发媒体，则需要自己去创建媒体处理端口，具体如何处理后续章节再讲。