pjsip学习笔记12 -- SIP 会话与事务
关于模块的博文在这里： https://blog.csdn.net/smllyy/article/details/40824491
一） 关于invite 会话
参考博文内容摘录如下：
1） DialogINVITE会话和usage在单独的静态库中实现，即pjsip-ua库
2） DialogINVITE会话是一个在一个Dialog中的INVITE会话。如果应用决定使用高层的INVITE会话管理，它需要为每一个Dialog创建唯一一个Dialog INVITE会话实例
3） DialogINVITE usage是一个注册到endpoint的PJSIP模块。
当一个Dialog有Dialog INVITE session时，这个模块需要作为Dialog usage注册到特定的Dialog。这将在INVITE会话创建的时候自动实现
3） INVITE会话状态机， 上半部分为caller（UAC）， 下半部分为callee（USA）
4） 外呼的Dialog（即拨打电话的），应用需要使用pjsip_dlg_create_uac()创建一个UAC Dialog。
接着调用pjsip_inv_create_uac()来创建invite会话，并将这个UAC实例作为这个函数的一个参数传入。
禁止在invite会话被创建之前发送INVITE请求。
5） 呼入的Dialog，应用可以通过调用pjsip_inv_verify_request()来验证是否这个请求可以被接收。
这个函数验证Supported，Require，和请求的消息体来确认这个请求是否可以被接收。
如果这个请求不能被接收，应用将才拒绝的响应。
如果这个请求可以被接收，应用创建通过调用pjsip_dlg_create_uas()来创建UAS Dialog。
接着调用pjsip_inv_create_uas()来为这个Dialog创建invite会话，并将这个UAS Dialog实例，作为一个参数传入。
应用禁止在invite会话创建之前发送任何响应。
6） Invite会话创建函数pjsip_inv_create_uac()和pjsip_inv_create_uas()函数）将自动注册invite会话usage到这个dialog。
应用不需要调用pjsip_dlg_add_usage()来添加invite usage模块到这个Dialog
7） Invite会话处理所有能改变会话状态的SIP方法。如： INVITE，BYE，ACK，CANCEL，UPDATE和PRACK方法
8） 应用必须使用invite会话API来创建和发送请求和响应消息以确保请求和响应消息被正确处理并包含了会话正在使用的特性（如可靠临时响应）
9） 应用可以使用基本的Dialog API来创建和发送除了上面列出的之外的方法的请求和响应消息。例如，应用可以使用基本的Dialog API来创建和发送一个Dialog中的MESSAGE请求
二） 关于事务
https://blog.csdn.net/smllyy/article/details/40822507
PJSIP中的transation表示为pjsip_transaction结构
通过pjsip_tsx_endpt_create_uac()/pjsip_tsx_create_uas()创建
在初始化UAS之后，应用将需要调用pjsip_tsx_recv_msg()传入初始的请求消息，这样这个transaction的状态就从NULL变为TRYING。后续的重传请求将被这个事务终止。
当应用想要使用这个Transaction发送请求或响应消息时，它将调用pjsip_tsx_send_msg()
当有消息传给Transaction时（Endpoint传给的到来消息或TU传给的外出消息），或定时器超时，事务状态会自动改变，并且TU通过on_tsx_state()回调函数将被通知。
如果Transaction的状态变为PJSIP_TSX_STATE_TERMINATED时，这个Transaction将被销毁。应用也可以调用pjsip_tsx_terminate()来强制终止这个Transaction。
Transaction有两种类型的定时器：重传定时器和超时定时器。这两种定时器的值将被Transaction根据Transaction的类型（UAS或UAC）/transport（可靠或不可靠）/请求方法（INVITE和non-INVITE）来设置
Transaction处理包括到来和外出的重传。到来的重传会被Transaction安静地终止和忽略；Transaction不会发出任何通知。Transaction在需要时，会自动重传外出消息；同样也不发出任何通（回调）
*** Transaction使用核心API pjsip_endpt_send_request_stateless()和pjsip_endpt_send_response()来发送外出消息
*** Transaction会增加使用的transport中的引用计数器
三) 关于SDP协商
http://blog.chinaunix.net/uid-790245-id-2037592.html
https://blog.csdn.net/u011062712/article/details/23761139
https://blog.csdn.net/smllyy/article/details/40824199
*** PJSIP中SDP offer/answer框架是基于RFC3264”An Offer/Answer模型使用会话描述协议（SDP）
*** Dialog invite会话提供SDP offer/answer和SIP协议的整合
**** 拒绝某个Offer的流，该流的端口值必须设置为0
*** Offer如果是sendonly，则Answer必须为recvonly或者inactive；
Offer如果是recvonly，则Answer必须为sendonly或者inactive；
Offer如果是sendrecv，则Answer必须为sendrecv、recvonly、 sendonly或者inactive；
Offer如果是inactive，则Answer必须为inactive。
即使Offer是recvonly型，Answer的地址和端口也必须存在，因为需要传送RTCP, 端口为0表示拒绝。
一） 关于invite 会话
参考博文内容摘录如下：
1） DialogINVITE会话和usage在单独的静态库中实现，即pjsip-ua库
2） DialogINVITE会话是一个在一个Dialog中的INVITE会话。如果应用决定使用高层的INVITE会话管理，它需要为每一个Dialog创建唯一一个Dialog INVITE会话实例
3） DialogINVITE usage是一个注册到endpoint的PJSIP模块。
当一个Dialog有Dialog INVITE session时，这个模块需要作为Dialog usage注册到特定的Dialog。这将在INVITE会话创建的时候自动实现
3） INVITE会话状态机， 上半部分为caller（UAC）， 下半部分为callee（USA）
4） 外呼的Dialog（即拨打电话的），应用需要使用pjsip_dlg_create_uac()创建一个UAC Dialog。
接着调用pjsip_inv_create_uac()来创建invite会话，并将这个UAC实例作为这个函数的一个参数传入。
禁止在invite会话被创建之前发送INVITE请求。
5） 呼入的Dialog，应用可以通过调用pjsip_inv_verify_request()来验证是否这个请求可以被接收。
这个函数验证Supported，Require，和请求的消息体来确认这个请求是否可以被接收。
如果这个请求不能被接收，应用将才拒绝的响应。
如果这个请求可以被接收，应用创建通过调用pjsip_dlg_create_uas()来创建UAS Dialog。
接着调用pjsip_inv_create_uas()来为这个Dialog创建invite会话，并将这个UAS Dialog实例，作为一个参数传入。
应用禁止在invite会话创建之前发送任何响应。
6） Invite会话创建函数pjsip_inv_create_uac()和pjsip_inv_create_uas()函数）将自动注册invite会话usage到这个dialog。
应用不需要调用pjsip_dlg_add_usage()来添加invite usage模块到这个Dialog
7） Invite会话处理所有能改变会话状态的SIP方法。如： INVITE，BYE，ACK，CANCEL，UPDATE和PRACK方法
8） 应用必须使用invite会话API来创建和发送请求和响应消息以确保请求和响应消息被正确处理并包含了会话正在使用的特性（如可靠临时响应）
9） 应用可以使用基本的Dialog API来创建和发送除了上面列出的之外的方法的请求和响应消息。例如，应用可以使用基本的Dialog API来创建和发送一个Dialog中的MESSAGE请求
二） 关于事务
https://blog.csdn.net/smllyy/article/details/40822507
PJSIP中的transation表示为pjsip_transaction结构
通过pjsip_tsx_endpt_create_uac()/pjsip_tsx_create_uas()创建
在初始化UAS之后，应用将需要调用pjsip_tsx_recv_msg()传入初始的请求消息，这样这个transaction的状态就从NULL变为TRYING。后续的重传请求将被这个事务终止。
当应用想要使用这个Transaction发送请求或响应消息时，它将调用pjsip_tsx_send_msg()
当有消息传给Transaction时（Endpoint传给的到来消息或TU传给的外出消息），或定时器超时，事务状态会自动改变，并且TU通过on_tsx_state()回调函数将被通知。
如果Transaction的状态变为PJSIP_TSX_STATE_TERMINATED时，这个Transaction将被销毁。应用也可以调用pjsip_tsx_terminate()来强制终止这个Transaction。
Transaction有两种类型的定时器：重传定时器和超时定时器。这两种定时器的值将被Transaction根据Transaction的类型（UAS或UAC）/transport（可靠或不可靠）/请求方法（INVITE和non-INVITE）来设置
Transaction处理包括到来和外出的重传。到来的重传会被Transaction安静地终止和忽略；Transaction不会发出任何通知。Transaction在需要时，会自动重传外出消息；同样也不发出任何通（回调）
*** Transaction使用核心API pjsip_endpt_send_request_stateless()和pjsip_endpt_send_response()来发送外出消息
*** Transaction会增加使用的transport中的引用计数器
三) 关于SDP协商
http://blog.chinaunix.net/uid-790245-id-2037592.html
https://blog.csdn.net/u011062712/article/details/23761139
https://blog.csdn.net/smllyy/article/details/40824199
*** PJSIP中SDP offer/answer框架是基于RFC3264”An Offer/Answer模型使用会话描述协议（SDP）
*** Dialog invite会话提供SDP offer/answer和SIP协议的整合
**** 拒绝某个Offer的流，该流的端口值必须设置为0
*** Offer如果是sendonly，则Answer必须为recvonly或者inactive；
Offer如果是recvonly，则Answer必须为sendonly或者inactive；
Offer如果是sendrecv，则Answer必须为sendrecv、recvonly、 sendonly或者inactive；
Offer如果是inactive，则Answer必须为inactive。
即使Offer是recvonly型，Answer的地址和端口也必须存在，因为需要传送RTCP, 端口为0表示拒绝。