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

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 213,752评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,100评论 3 387
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 159,244评论 0 349
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,099评论 1 286
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,210评论 6 385
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,307评论 1 292
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,346评论 3 412
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,133评论 0 269
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,546评论 1 306
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,849评论 2 328
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,019评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,702评论 4 337
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,331评论 3 319
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,030评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,260评论 1 267
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,871评论 2 365
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,898评论 2 351

推荐阅读更多精彩内容

  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,644评论 18 139
  • Spring Boot 参考指南 介绍 转载自:https://www.gitbook.com/book/qbgb...
    毛宇鹏阅读 46,789评论 6 342
  • http://liuxing.info/2017/06/30/Spring%20AMQP%E4%B8%AD%E6%...
    sherlock_6981阅读 15,899评论 2 11
  • 1. Java基础部分 基础部分的顺序:基本语法,类相关的语法,内部类的语法,继承相关的语法,异常的语法,线程的语...
    子非鱼_t_阅读 31,605评论 18 399
  • 220期 努力一组 谷雨婴幼儿玩具有限公司 【日精进打卡第8天】 【知~学习】 《六项精进》1遍 今天5遍共39遍...
    一池清水_8fd9阅读 207评论 0 0