博客园  :: 首页  :: 新随笔  :: 联系 :: 订阅 订阅  :: 管理

SIP注册呼叫流程简介

Posted on 2021-11-27 00:02  小翁好  阅读(1030)  评论(0编辑  收藏  举报

本文链接:https://blog.csdn.net/alwaysrun/article/details/103939541, 感谢作者。

PJSIP注册呼叫流程简介

标签: C++与VC  VoIP与音视频

 
 

注册注销

电话呼叫

 

在《SIP开源库pjSIP简介》中介绍了pjSIP的基本框架,本节对pjSIP中SIP的注册与呼叫具体流程进行简要说明。

注册注销

SIP通过register进行注册请求:

  • 终端向VoIP服务器发送register请求:URL中包含注册服务器的域名地址,To头域中包含准备生成的地址记录,Contact头域中表明此次注册所要绑定的地址(其中Expire表示绑定失效时长);

  • VoIP服务器返回401响应,要求用户鉴权;

  • 终端发送带鉴权信息的注册请求;

  • 注册完成;

SIP的注销流程与注册流程基本相同,只是Expires参数为0(标识注销)

 

注册接口

pjSIP中通过pjsua_acc_add来添加用户信息并完成注册;若不用默认的5060注册端口,则需要增加代理设置,以便客户端能正确地连接;注册成功后会返回注册账户id(非负数)。

  1.  
    #define PJ_User "1000"
  2.  
    #define PJ_Psw  "1234"
  3.  
    #define PJ_Server "192.168.1.100"
  4.  
    #define PJ_Port "5060"
  5.  
     
  6.  
    pj_acc_id g_accId = -1;
  7.  
     
  8.  
    int pjRegister(){
  9.  
      pjsua_acc_config accConfig;
  10.  
      psua_acc_config_default(&accConfig);
  11.  
      accConfig.id = pj_str("sip:" PJ_User "@" PJ_Server);
  12.  
      accConfig.reg_uri = pj_str("sip:" PJ_Server);  // Comment, if not need register
  13.  
     
  14.  
      // Cred
  15.  
      accConfig.cred_count = 1;
  16.  
      auto &cred = accConfig.cred_info[0];
  17.  
      cred.realm = pj_str(PJ_Server);
  18.  
      cred.scheme = pj_str("digest");
  19.  
      cred.username = pj_str(PJ_User);
  20.  
      cred.data_type = PJSIP_CRED_DATA_PLAIN_PASSWD;
  21.  
      cred.data = pj_str(PJ_Psw);
  22.  
     
  23.  
      if(stod(PJ_Port) != 5060){
  24.  
        accConfig.proxy_cnt=1;
  25.  
        accConfig.proxy[0]=pj_str("sip:" PJ_Server ":" PJ_Port)
  26.  
      }
  27.  
     
  28.  
      auto nStatus = pjsua_acc_add(&accConfig, PJ_FALSE, &g_accId);
  29.  
      if (!PjRetsuccess(nStatus)){
  30.  
        ...
  31.  
      }
  32.  
     
  33.  
      ...
  34.  
    }

pjsua_acc_add主要是添加客户端账户信息,后续呼叫时,就使用此账户信息;即使直呼(不需要注册直接呼叫,此时不要设定reg_uri)也需用调用此接口增加账户信息。账户不再需要时,通过pjsua_acc_del来删除账户(若注册过,则会自动注销)。

注册事件

注册完成后(无论成功还是失败),都会触发注册状态改变事件(初始化pjSUA时设定的Onregstate回调);在此事件中,即可获取注册状态。

  1.  
    static void OnRegState(pjsua_acc_id accId){
  2.  
      pjsua_acc_info accInfo;
  3.  
      auto nStatus = pjsua_acc_get_info(accId, &accInfo);
  4.  
     
  5.  
      bool bReged = accInfo.has_registration
  6.  
        && (accInfo.expires > 0)
  7.  
        && (accInfo.status / 100 == 2);
  8.  
     
  9.  
      // To log wheather registered
  10.  
    }

电话呼叫

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

  1.  
    #define PJ_Called 3000
  2.  
    int pjMakeCall(){
  3.  
      auto toCall = pj_str("sip:" PJ_Called "@" PJ_Server)
  4.  
      auto nStatus = pjsua_call_make_call(g_accId, &toCall, NULL, NULL, NULL, NULL);
  5.  
      if (!PjRetsuccess(nStatus)){
  6.  
        ...
  7.  
      }
  8.  
     
  9.  
      ...
  10.  
    }

呼叫事件

呼叫状态改变时,会触发呼叫状态改变事件(初始化pjSUA时设定的OnCallState回调);在此事件中可获取具体通话状态。

  1.  
    static void OnCallState(pjsua_call_id callId, pjsip_event *pEvent){
  2.  
      pjsua_call_info callInfo;
  3.  
      auto nStatus = pjsua_call_info(callId, &callInfo);
  4.  
     
  5.  
      if(callInfo.state == PJSIP_INV_STATE_DISCONNECTED){
  6.  
        // Call hanguped
  7.  
        ToStopMedia(callInfo);
  8.  
        // ... other clear
  9.  
      }
  10.  
    }

通话真正开始(RTP媒体流建立),会触发媒体状态改变事件(初始化pjSUA时设定的OnMediaState回调),此时可以对媒体处理(如关联麦克风、扬声器等)。

  1.  
    static void OnMediaState(pjsua_call_id callId){
  2.  
      pjsua_call_info callInfo;
  3.  
      auto nStatus = pjsua_call_info(callId, &callInfo);
  4.  
     
  5.  
      if(callInfo.media_status == PJSUA_CALL_MEDIA_ACTIVE){
  6.  
        // has started trans media
  7.  
        ToStartMedia(callInfo);
  8.  
     
  9.  
        // 若只是与声卡设备连接,执行连接0端口即可
  10.  
        // pjsua_conf_connect(ci.conf_slot, 0);
  11.  
        // pjsua_conf_connect(0, ci.conf_slot);
  12.  
      }
  13.  
    }

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

 

 
版权声明:本文为alwaysrun原创文章,遵循 CC 4.0 BY-SA 版权协议,转载请附上原文出处链接和本声明。
本文链接:https://blog.csdn.net/alwaysrun/article/details/103939541