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