pjsip開發(fā)——Endpoint

Endpoint

Endpoint類是一個單例類,應(yīng)用程序必須創(chuàng)建一個,最多只能創(chuàng)建一個此類實例,然后才能執(zhí)行其他任何操作,類似地,一旦該類被銷毀,應(yīng)用程序就不能調(diào)用任何庫API。這個類是PJSUA2的核心類,它提供了以下功能:

  • 啟動和關(guān)閉
  • 定制配置,如核心UA(用戶代理)SIP配置,媒體配置和日志記錄配置
    本章將介紹上述功能。

要使用Endpoint類,通常應(yīng)用程序不需要對其進行子類化,除非:

應(yīng)用程序想要實現(xiàn)/覆蓋端點回調(diào)方法以獲取傳輸狀態(tài)更改或NAT檢測完成等事件
應(yīng)用程序使用Endpoint.utilTimerSchedule()API調(diào)度計時器。在這種情況下,應(yīng)用程序需要實現(xiàn)onTimer()回調(diào)以在計時器到期時獲取通知。

實例化端點

在其他任何事情之前,您必須實例化Endpoint類:

Endpoint ep = new Endpoint();

可以通過靜態(tài)方法來檢索Endpoint 實例。

創(chuàng)建庫

通過調(diào)用它的libCreate()方法創(chuàng)建庫:其實是調(diào)用pjsua2JNI.Endpoint_libCreate(swigCPtr, this)這個公共管理jni類來調(diào)用底層代碼:

try{ 
    ep - > libCreate (); 
}  catch ( Error & err ) { 
    cout << "Startup error: " << err.info() << endl;
}

如果發(fā)生錯誤,libCreate()方法將引發(fā)異常,所以我們需要使用上面的try / catch子句來捕獲異常。

初始化庫和配置設(shè)置

EpConfig類提供了允許定制以下設(shè)置的端點配置:

  • UAConfig,指定核心SIP用戶代理設(shè)置。
  • MediaConfig來指定各種媒體全局設(shè)置
  • LogConfig來自定義日志設(shè)置。

要定制自己的協(xié)議配置信息,可以自定義EpConfig類的實現(xiàn),并在端點初始化期間指定它們

接下來,您可以通過調(diào)用libInit()來初始化庫,調(diào)用pjsua2JNI.Endpoint_libInit(swigCPtr, this, EpConfig.getCPtr(prmEpConfig), prmEpConfig)底層代碼實現(xiàn):

try{ 
    EpConfig ep_cfg ; 
    //指定ep_cfg中設(shè)置的自定義
     ep - > libInit ( ep_cfg ); 
}  catch ( Error & err ) { 
    cout <<  “Startup error: ”  << err 。info () << endl ; 
}

上面的代碼片段使用默認設(shè)置初始化庫。

創(chuàng)建一個或多個傳輸

應(yīng)用程序需要創(chuàng)建一個或多個傳輸才能發(fā)送或接收SIP消息:

TransportConfig sipTpConfig = new TransportConfig();
sipTpConfig.setPort(5060);
ep.transportCreate(pjsip_transport_type_e.PJSIP_TRANSPORT_UDP, sipTpConfig);

transportCreate()方法返回新創(chuàng)建的傳輸ID,它使用傳輸類型和TransportConfig對象來自定義傳輸設(shè)置,如綁定地址和偵聽端口號。沒有這個,默認情況下,傳輸將被綁定到INADDR_ANY和任何可用的端口。

除了創(chuàng)建無用戶帳戶(使用Account.create())外,沒有實際使用Transport ID,如后面將解釋的那樣),并且可能在應(yīng)用程序需要時顯示傳輸列表給用戶。

啟動庫

現(xiàn)在我們準備開始圖書館了。我們需要啟動庫來完成初始化階段,例如完成初始STUN地址解析,初始化/啟動聲音設(shè)備等。要啟動庫,請調(diào)用libStart()方法:

關(guān)閉庫

一旦應(yīng)用程序退出,庫需要關(guān)閉,以便資源可以釋放回操作系統(tǒng)。雖然這可以通過刪除Endpoint實例來完成,該實例將在內(nèi)部調(diào)用libDestroy()

ep.libDestroy();
ep.delete();

關(guān)于上述詳細類信息參考可以參照官方文檔pjsip-book

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時請結(jié)合常識與多方信息審慎甄別。
平臺聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點,簡書系信息發(fā)布平臺,僅提供信息存儲服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

  • Spring Cloud為開發(fā)人員提供了快速構(gòu)建分布式系統(tǒng)中一些常見模式的工具(例如配置管理,服務(wù)發(fā)現(xiàn),斷路器,智...
    卡卡羅2017閱讀 136,678評論 19 139
  • Spring Boot 參考指南 介紹 轉(zhuǎn)載自:https://www.gitbook.com/book/qbgb...
    毛宇鵬閱讀 47,283評論 6 342
  • http://liuxing.info/2017/06/30/Spring%20AMQP%E4%B8%AD%E6%...
    sherlock_6981閱讀 16,211評論 2 11
  • 1. Java基礎(chǔ)部分 基礎(chǔ)部分的順序:基本語法,類相關(guān)的語法,內(nèi)部類的語法,繼承相關(guān)的語法,異常的語法,線程的語...
    子非魚_t_閱讀 34,806評論 18 399
  • 220期 努力一組 谷雨嬰幼兒玩具有限公司 【日精進打卡第8天】 【知~學(xué)習(xí)】 《六項精進》1遍 今天5遍共39遍...
    一池清水_8fd9閱讀 232評論 0 0

友情鏈接更多精彩內(nèi)容