美文网首页
pjsip开发——Endpoint

pjsip开发——Endpoint

作者: samychen | 来源:发表于2018-02-25 12:36 被阅读0次

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

相关文章

  • pjsip开发——Endpoint

    Endpoint Endpoint类是一个单例类,应用程序必须创建一个,最多只能创建一个此类实例,然后才能执行其他...

  • PJSIP开发VoIP记录3-通话的实现

    PJSIP开发VoIP记录1 - 编译与集成 PJSIP开发VoIP记录2 - 配置 开发工具:Xcode9.2开...

  • pjsip开发——Call

    呼叫使用Call来实现,一般根据需要我们需要自定义Call的实现 在具体实现类中,通过重写呼叫回调,用于处理与呼叫...

  • pjsip开发——Buddy

    PJSUA2的功能是围绕Buddy类为中心展开的。该类表示一个远端链接。 要使用Buddy类,需要根据需求实现其子...

  • pjsip开发——Account

    Account提供正在使用该应用程序的用户的身份(或身份)。一个帐户有一个与之相关的SIP统一资源标识符(URI)...

  • PJSIP开发VoIP记录2 - 配置

    PJSIP开发VoIP记录1 - 编译与集成 开发工具:Xcode9.2开发语言:swift 4.0 自从写了上一...

  • PJSIP开发VoIP记录1 - 编译与集成

    本文仅用于记录使用PJSIP开发VoIP,会陆续更新... 开发工具:Xcode9.2开发语言:swift 4.0...

  • pjsip开发——呼叫流程

    SIP呼叫流程 注册注销过程   SIP为用户定义了注册和注销过程,其目的是可以动态建立用户的逻辑地址和其当前联系...

  • libpjsua2.so.2: cannot open shar

    遇到问题: pjsip安装好之后,编译运行 pjproject-2.12.1/pjsip-apps/src/swi...

  • pjsip开发——sip日志分析

      这一节将通过一个简单的例子来介绍一些基本的 SIP 操作。先让我们来诊视下图展示的两个用户代理之间的消息顺序。...

网友评论

      本文标题:pjsip开发——Endpoint

      本文链接:https://www.haomeiwen.com/subject/lbucxftx.html