中文翻译:pjsip文档(四)之ICE Session的使用方法

  1:pjsip教程(一)之PJNATH简介

  2:pjsip教程(二)之ICE穿越打洞:Interactive Connectivity Establishment简介

  3:pjsip教程(三)之ICE stream transport的使用

  4:pjsip文档(四)之ICE Session的使用方法

本文原文连接:http://www.pjsip.org/docs/latest/pjnath/docs/html/group__PJNATH__ICE__SESSION.htm

Detailed Description

这个模块描述的pj_ice_sess对象是PJNATH库的组成部分同时它是与数据包的传输无关的对象(a transport independent)。

ICE Session

ICE Session 是PJNATH库中关于ICE的最底层的抽象,它使用一个单一的媒体流来执行两端的连接检测(双方通过互发数据包进行协商,从而确定一条从A到B可以互通的路径)。ICE Session 使用pj_ice_sess结构体来表示.

此处描绘的ICE Session它不做数据的传输(is independent from any transports),那么这也表明网络的IO得是由应用程序本身或者由它更高的抽象层来执行。使用这个框架,应用程序就可以使用ICE Session来处理所有接收到的数据包,并且该框架也为ICE Session提供了向外发送数据的回调接口。

关于ICE更高级的抽象,请查看ICE stream transport进行了解.

Using The ICE Session

下面是ICE Session的详细使用步骤,当然,开发者也可使用ICE stream transport的API,它对ICE进行了更高级的封装,并且提供了ICE socket的集成。

ICE Session的使用步骤类似于报告/答复模式(offerer and answerer):

  • 使用pj_ice_sess_create()创建ICE Session,其中用户需要指定一下几个参数:
    • STUN 的配置:STUN的一些设置,比如超时时间以及STUN 中需要用到的timer heap、ioqueue实例.
    • Session名称,可用于在日志中标识唯一的会话.
    • 初始化ICE的角色(pj_ice_sess_role).角色的设置可以在初始化完成之后通过pj_ice_sess_change_role()改变。ICE Session也可以在检测到角色冲突之后自动更改。
    • 媒体会话中构件的数目.
    • 触发ICE事件之后的回调函数的设置(pj_ice_sess_cb)
    • 本地ICE用户名称和密码,不过不设置此项时,系统将会随机生成.
  • 使用pj_ice_sess_cand结构体来表示候选者实例,使用pj_ice_sess_add_cand()为每一个构建添加本地地址候选. 每个构件初始化过程中必须至少有一个候选地址,并且所有的控件必须拥有相同的候选地址数,不然会导致配对过程的失败。
  • 创建本地信息的实例(用于描述本地ICE候选者):ICE session没有提供创建该实例的功能,但是应用程序应该实现该功能。如果应用程序使用ICE stream transport的时候,可以使用pj_ice_strans_enum_cands()方法来枚举所有本地候选者。应用程序可使用pj_ice_sess_find_default_cand() 来让ICE Session选择使用在SDP c= and m= lines中的默认的传输地址.
  • 通过某一种信令(比方说SIP)将承载本地信息的实例发送至对端.
  • 当本地接收到对端的应答(包含了对端的候选者信息),应马上解析该消息,建立关于对端的候选者列表,并且通过pj_ice_sess_create_check_list()来建立check lists,这个过程就称为配对.
  • 配对完成后,就可以调用pj_ice_sess_start_check()开始执行连接测试,查看上步中哪个配对是有效的.
  • 最后,在连接测试完成后,应用程序会在pj_ice_sess_create()回调中收到测试结果.

使用pj_ice_sess_send_data()方法来发送数据。如果发送数据的时候是在ICE协商还没完成时,那么ICE session 将直接丢弃该数据并且给调用者返回错误信息;如果是在ICE协商完成后,那么ICE session 将会调用pj_ice_sess_cbon_tx_pkt来发送数据.

由于ICE Session本身没有传输机制,所以应用程序必须把从底层接收到的所有数据包都通过pj_ice_sess_on_rx_pkt()方法传递给ICE Session,ICE Session判断该包是否为STUN包,如果是,则处理;如果不是,则使用on_rx_data回调把数据包向上传递给应用上层.

  转载请注明:

  名称:中文翻译:pjsip文档(四)之ICE Session的使用方法

  作者:大雪先生

  链接:http://www.cnblogs.com/ishang/p/3413271.html

上一篇:Spring学习之切入点表达式


下一篇:Fastdfs文件服务器搭建