jrtp学习笔记.doc

jrtp学习笔记RTPSession 对于大多数的RTP应用程序，RTPSession类可能是JRTPLIB唯一使用的类。它能完全处理RTCP部份的数据包，所以用户可以把精力集中在真正的数据收发。 要知道RTPSession类在多线程下并不是安全的，因此，用户要通过某些锁同步机制来保证不会出现在不同线程当中调用同一个RTPSession实例。 RTPSession类有如下的接口。 ? RTPSession(RTPTransmitter::TransmissionProtocol proto = RTPTransmitter::IPv4UDPProto) 使用proto类型传输层创建一个PRTSession实例。如果proto使用用户自定义（user-defined）传输层，则相应的NewUserDefinedTransmitter()函数必须实现。ps:这里默认就行了，默认就是IPV4网络。 ? int Create(const RTPSessionParams sessparams, const RTPTransmissionParams*transparams = 0) 使用RTPSession参数sessparams和RTPTransmission参数transparams 真正创建一个RTP会话。如果transparams 为NULL，则使用默认的参数。ps:RTPSessionParams 我们可能要设得比较多，RTPTransmissionParams参数就只要设置其中的端口就行了，端口一定要设对，不然进行组播时，这个进程将不接收数据。设置方式可以看example.cpp。 ? void Destroy() 离开一个会话但不向其它组成员发送BYE包。ps:我不推荐用这个函数除非是错误处理，正常离开我们应该用ByeDestroy()。 ? void BYEDestroy(const RTPTime maxwaittime, const void *reason,size t reasonlength) 发送一个BYE包并且离开会话。在发送BYE包前等待maxwaittime，如果超时，会不发送BYE包直接离开，BYE包会包含你的离开原因reason。相应的reasonlength表示reason长度。ps:因为BYE包是一个RTCP包，RTCP不是要发就发的，它的发送时间是为了平衡带宽通过计算得出来的，那就很有可能到了要发的时候以经超过了maxwaittime时间了，作者可能认一直保留个这会话这么久没意义。当然，我常常把maxwaittime设得很大。 ? bool IsActive() 看看这个RTPSession实例是否以经通过Create建立了真实的会话。 ? uint32 t GetLocalSSRC() 返回我们的SSRC。ps:至于什么是SSRC，去看看RFC3550吧。我说过JRTPLIB只是RTP协议的包装，并没有做任何应用的事情。 ? int AddDestination(const RTPAddress addr) 添加一个发送目标。ps: 当然，如果我们使用组播，这里只用调用一次，把我们的组播地址写进去。这样，这组的全部人都能收到你发的包。但是组播可因特网的上设置很烦。而且用组播测试也很烦（组播必须BIND一个端口，如果你想在同一台机器上运行两个软件实例来没试，你就会发现同一个端口BIND两次，当然，后面那次会失败，也就是说测试不了，要测？找两台机器，或用虚拟机），如果组播不满足，我们就要把组播变在单播，这时就要返复调用这个函数把其它组成员的IP都加进来了。具体可以看看example3.cpp。 ? int DeleteDestination(const RTPAddress addr) 从发送地址列表中删除一下地址。 ? void ClearDestinations() 清除发送地址列表。 ? bool SupportsMulticasting() 返回JRTPLIB是否支持组播。ps:这里指JRTPLIB本身，不是你的真实网络。编译JRTPLIB库时可能指定。 . ? int JoinMulticastGroup(const RTPAddress addr) 加入一个组播组addr。 ? int LeaveMultica