中文翻译：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_cb的on_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