eXosip用户手册：1.1 如何初始化libeXosip2

最新推荐文章于 2023-09-26 14:30:23 发布

cheneymei

最新推荐文章于 2023-09-26 14:30:23 发布

阅读量7.8k

点赞数 2

分类专栏： SIP 文章标签： null header include api socket action

SIP 专栏收录该内容

12 篇文章 15 订阅

订阅专栏

说明：本文的内容是根据官方的eXosip_User_Manual来翻译，为了省时间提高效率，部分内容是意译，部分内容个人觉得没有必要，所以不翻译。后续的相关文章亦如此。

1.1 如何初始化libeXosip2

使用eXosip时，第一步工作是初始化eXosip和libosip库（解析器和状态机）。在使用libeXosip2前必须必须先做这一步。

   ＃include <eXosip2/eXosip.h>

   int i;

   i = eXosip_init(); // 初始化eXosip和osip协议栈

    if (i != 0)
        return -1;

    i = eXosip_listen_addr (IPPROTO_UDP, NULL, 5060, AF_INET, 0); // 打开信号socket

    if (i != 0) // 传输层初始化失败
    {
        eXosip_quit();

        return -1;
    }

然后可以发送消息，等待并处理eXosip事件。

    eXosip_event_t *je = NULL;

    while (1)
    {    
        je = eXosip_event_wait(0,50); // 侦听是否有消息到来

         eXosip_lock();
        eXosip_default_action(je);
        eXosip_unlock ();

        if (je == NULL) // 没有接收到消息
            continue;

        switch (je->type)
        {
         case EXOSIP_MESSAGE_NEW:
             break;

         case EXOSIP_CALL_INVITE:
             break;

         case EXOSIP_CALL_ACK:
             break;

         case EXOSIP_CALL_CLOSED:   
             break;

          case ...:
              break; 

          default:
               break;      
          }

          eXosip_event_free(je);
    }

    每当发送一个SIP消息，都会收到一个事件。每个事件包含受影响事务的原始请求，以及触发有效事件的最后应答，
    你可以从这些信息获取所有的头部，并存储起来，以方便后续的操作或者显示。
    例如：当收到一个呼叫传输REFER请求时，你可以检索“refer-To”头部：

    osip_header_t *referto_head = NULL;
    i  = osip_message_header_get_byname(evt->sip, "refer-To", 0, &referto_head);
    if (referto_head == NULL || referto_head->value == NULL)

eXosip_event包含呼叫标识符、注册信息、传入订阅、呼出订阅等。这些标识符将会被API用于控制呼叫、注册、传入或呼出订阅，这些API将会建立默认的带SIP头的信息头(From, To, Call-ID, CSeq, Route, Record-Route,Max-Forward...)，并为你发送信息。