Endpoint
Endpoint类是一个单例类,应用程序必须创建一个,最多只能创建一个此类实例,然后才能执行其他任何操作,类似地,一旦该类被销毁,应用程序就不能调用任何库API。这个类是PJSUA2的核心类,它提供了以下功能:
- 启动和关闭
- 定制配置,如核心UA(用户代理)SIP配置,媒体配置和日志记录配置
本章将介绍上述功能。
要使用Endpoint类,通常应用程序不需要对其进行子类化,除非:
应用程序想要实现/覆盖端点回调方法以获取传输状态更改或NAT检测完成等事件
应用程序使用Endpoint.utilTimerSchedule()API调度计时器。在这种情况下,应用程序需要实现onTimer()回调以在计时器到期时获取通知。
实例化端点
在其他任何事情之前,您必须实例化Endpoint类:
Endpoint ep = new Endpoint();
可以通过静态方法来检索Endpoint 实例。
创建库
通过调用它的libCreate()方法创建库:其实是调用pjsua2JNI.Endpoint_libCreate(swigCPtr, this)这个公共管理jni类来调用底层代码:
try{
ep - > libCreate ();
} catch ( Error & err ) {
cout << "Startup error: " << err.info() << endl;
}
如果发生错误,libCreate()方法将引发异常,所以我们需要使用上面的try / catch子句来捕获异常。
初始化库和配置设置
EpConfig类提供了允许定制以下设置的端点配置:
- UAConfig,指定核心SIP用户代理设置。
- MediaConfig来指定各种媒体全局设置
- LogConfig来自定义日志设置。
要定制自己的协议配置信息,可以自定义EpConfig类的实现,并在端点初始化期间指定它们
接下来,您可以通过调用libInit()来初始化库,调用pjsua2JNI.Endpoint_libInit(swigCPtr, this, EpConfig.getCPtr(prmEpConfig), prmEpConfig)
底层代码实现:
try{
EpConfig ep_cfg ;
//指定ep_cfg中设置的自定义
ep - > libInit ( ep_cfg );
} catch ( Error & err ) {
cout << “Startup error: ” << err 。info () << endl ;
}
上面的代码片段使用默认设置初始化库。
创建一个或多个传输
应用程序需要创建一个或多个传输才能发送或接收SIP消息:
TransportConfig sipTpConfig = new TransportConfig();
sipTpConfig.setPort(5060);
ep.transportCreate(pjsip_transport_type_e.PJSIP_TRANSPORT_UDP, sipTpConfig);
transportCreate()方法返回新创建的传输ID,它使用传输类型和TransportConfig对象来自定义传输设置,如绑定地址和侦听端口号。没有这个,默认情况下,传输将被绑定到INADDR_ANY和任何可用的端口。
除了创建无用户帐户(使用Account.create())外,没有实际使用Transport ID,如后面将解释的那样),并且可能在应用程序需要时显示传输列表给用户。
启动库
现在我们准备开始图书馆了。我们需要启动库来完成初始化阶段,例如完成初始STUN地址解析,初始化/启动声音设备等。要启动库,请调用libStart()方法:
关闭库
一旦应用程序退出,库需要关闭,以便资源可以释放回操作系统。虽然这可以通过删除Endpoint实例来完成,该实例将在内部调用libDestroy()
ep.libDestroy();
ep.delete();
关于上述详细类信息参考可以参照官方文档pjsip-book