pjsip开发——Endpoint

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