jrtplib库的使用

一、sample是一个简单的IPv4的列子,它实现了RTP在本机上的数据的传输。
 
1、初始化。
我们知道RTP是通常是使用UDP协议来实现数据的传输,在windows环境下,当然要用到我们熟悉的套接字的使用,所以我们先要进行初始化,加载套接字库。
view plaincopy to clipboardprint?
#ifdef WIN32  
WSADATA dat;  
WSAStartup(MAKEWORD(2,2),&dat);  
#endif // WIN32  
RTPSession sess;  
   
//当然在我们程序结束的时候,我们要清理套接字库。  
#ifdef WIN32  
               WSACleanup();  
#endif // WIN32  
   
//还有关于头文件,我们需要用到以下一些:  
#include "rtpsession.h"          //定义了RTPSession  
#include "rtppacket.h"           //定义了RTPPacket数据包  
#include "rtpudpv4transmitter.h" //定义了RTPSession的第二个参数  
 //RTPUDPv4TransmissionParams  
#include "rtpipv4address.h"      //定义了rtpipv4address  
#include "rtpsessionparams.h"    //定义了RTPSession的第一个参数  
                                 // RTPSessionParams  
#include "rtperrors.h"           //定义了RTP中的错误信息  
   
//获得出错信息,我们在使用时不可避免地要出错,故我们可以通过//jrtplib的函数来获得我们出错的信息,方法如下:  
void checkerror(int rtperr)  
{  
if (rtperr < 0)  
{  
std::cout << "ERROR: " << RTPGetErrorString(rtperr) << std::endl;  
exit(-1);  
}  

#ifdef WIN32
WSADATA dat;
WSAStartup(MAKEWORD(2,2),&dat);
#endif // WIN32
RTPSession sess;
 
//当然在我们程序结束的时候,我们要清理套接字库。
#ifdef WIN32
               WSACleanup();
#endif // WIN32
 
//还有关于头文件,我们需要用到以下一些:
#include "rtpsession.h"          //定义了RTPSession
#include "rtppacket.h"           //定义了RTPPacket数据包
#include "rtpudpv4transmitter.h" //定义了RTPSession的第二个参数
 //RTPUDPv4TransmissionParams
#include "rtpipv4address.h"      //定义了rtpipv4address
#include "rtpsessionparams.h"    //定义了RTPSession的第一个参数
                                 // RTPSessionParams
#include "rtperrors.h"           //定义了RTP中的错误信息
 
//获得出错信息,我们在使用时不可避免地要出错,故我们可以通过//jrtplib的函数来获得我们出错的信息,方法如下:
void checkerror(int rtperr)
{
if (rtperr < 0)
{
std::cout << "ERROR: " << RTPGetErrorString(rtperr) << std::endl;
exit(-1);
}
}
函数RTPGetErrorString(…)根据出错返回的一个负数来判断,利用jrtplib采用的统一出错机制返回的是一个C++中标准的字符串std::string,表示出错的信息,比喻我们指定的Portbase不是一个偶数。(为什么,以下要讲)
2、关于RTPSession对象设置
   由于要使用套接字,故我们在使用之前一定要为我们的监听socket指定一个监听端口,也就是这里的portbase的值。我们可以通过调用RTPSession的第二个参数RTPUDPv4TransmissionParams的成员函数来设定,
   transparams.SetPortbase(portbase);
 
   还有就是我们要通过RTPSession的第一个参数来设定以下一些值:
  
sessparams.SetOwnTimestampUnit(1.0/10.0);
//注意这个值我们一定要设置,The local timestamp unit MUST be set, otherwise
//RTCP Sender Report info will be calculated wrong, In this case, we'll be sending
//10 samples each second, so we'll put the timestamp unit to (1.0/10.0)     
//设置时间戳是一件很重要的事情,是RTP会话初始化过程所要进行的另外一项重要工
//作,他的单位是秒,如:当使用RTP会话传输8000Hz采样的音频数据时,由于时戳
//每秒钟将递增8000,所以时戳单元相应地应该被设置成1/8000:
sessparams.SetAcceptOwnPackets(true);
//通过这个函数我们可以设置是不是接收我们自定义的数据包。
 
3、数据发送
   我想当我们要想建立连接的时候,我们就要让发送端知道要发送到的主机的IP地址,在jrtplib中我们可以通过RTPSession成员函数AddDestination()、DeleteDestination()和 ClearDestinations()来完成。如下面是将数据发送给本机的6000号端口:
 
unsigned long addr = ntohl(inet_addr("127.0.0.1"));
sess.AddDestination(addr, 6000);
 
当然我们还可以这样来完成加入一个客户端,
 
RTPIPv4Address addr(destip,destport);//destip为客户端IP地址,destport为客户端//端口号
status = sess.AddDestination(addr);
checkerror(status);  
  
   目标地址全部指定之后,接着就可以调用RTPSession类的SendPacket()方法,向所有的目标地址发送流媒体数据。SendPacket()是RTPSession类提供的一个重载函数,它具有下列多种形式:
int SendPacket(void *data,int len)
int SendPacket(void *data,int len,unsigned char pt,bool mark,
unsigned long timestampinc)
int SendPacket(void *data,int len,unsigned short hdrextID,void *hdrextdata,
int numhdrextwords)
int SendPacket(void *data,int len,unsigned char pt,bool mark,
unsigned long timestampinc,unsigned short hdrextID,
void *hdrextdata,int numhdrextwords)
SendPacket()最典型的用法是类似于下面的语句,其中第一个参数是要被发送的数据,而第二个参数则指明将要发送数据的长度,再往后依次是RTP负载类型、标识和时戳增量。如下所示:
status = sess.SendPacket((void *)"1234567890",10,0,false,10);
checkerror(status);
对于同一个RTP会话来讲,负载类型、标识和时戳增量通常来讲都是相同的,JRTPLIB允许将它们设置为会话的默认参数,这是通过调用 RTPSession类的SetDefaultPayloadType()、SetDefaultMark()和 SetDefaultTimeStampIncrement()方法来完成的。为RTP会话设置这些默认参数的好处是可以简化数据的发送,例如,如果为 RTP会话设置了默认参数:
session.SetDefaultPayloadType(96);//注意这个参数不能随便设置,参考RFC3551
session.SetDefaultMark(false);
session.SetDefaultTimestampIncrement(160);
在设置了以上的值后,我们可以这样来发送数据:
status = sess.SendPacket((void *)"1234567890",10);
3、数据接收
对于流媒体数据的接收端,首先需要调用RTPSession类的PollData()方法来接收发送过来的RTP或者RTCP数据报。由于同一个 RTP会话中允许有多个参与者(源),你既可以通过调用RTPSession类的GotoFirstSource()和GotoNextSource() 方法来遍历所有的源,也可以通过调用RTPSession类的GotoFirstSourceWithData()和 GotoNextSourceWithData()方法来遍历那些携带有数据的源。在从RTP会话中检测出有效的数据源之后,接下去就可以调用 RTPSession类的GetNextPacket()方法从中抽取RTP数据报,当接收到的RTP数据报处理完之后,一定要记得及时释放。下面的代码示范了该如何对接收到的RTP数据报进行处理:
view plaincopy to clipboardprint?
session.BeginDataAccess();  
if (session.GotoFirstSource()){  
do{  
      RTPPacket *packet;  
while ((packet = session.GetNextPacket()) != 0){  
            cout << "Got packet with extended sequence number " 
                  << packet->GetExtendedSequenceNumber()  
                 << " from SSRC " << packet->GetSSRC() <              session.DeletePacket(packet);  
}  
     } while (session.GotoNextSource());  
   }  
   session.EndDataAccess(); 
session.BeginDataAccess();
if (session.GotoFirstSource()){
do{
      RTPPacket *packet;
while ((packet = session.GetNextPacket()) != 0){
            cout << "Got packet with extended sequence number "
                  << packet->GetExtendedSequenceNumber()
                 << " from SSRC " << packet->GetSSRC() <              session.DeletePacket(packet);
}
     } while (session.GotoNextSource());
   }
   session.EndDataAccess();
JRTPLIB为RTP数据报定义了三种接收模式,其中每种接收模式都具体规定了哪些到达的RTP数据报将会被接受,而哪些到达的RTP数据报将会被拒绝。通过调用RTPSession类的SetReceiveMode()方法可以设置下列这些接收模式:
① RECEIVEMODE_ALL 缺省的接收模式,所有到达的RTP数据报都将被接受;
② RECEIVEMODE_IGNORESOME  除了某些特定的发送者之外,所有到达的RTP数据报都将被接受,而被拒绝的发送者列表可以通过调用AddToIgnoreList()、ClearIgnoreList()     和DeleteFromIgnoreList()方法来进行设置;
③ RECEIVEMODE_ACCEPTSOME  除了某些特定的发送者之外,所有到达的RTP数据报都将被拒绝,而被接受的发送者列表可以通过调用AddToAcceptList ()、ClearAcceptList ()和eleteFromAcceptList方法来进行设置。
4、运行程序
   在运行程序之前,我们要知道,这是基于UDP协议的数据报服务。我们的example1是在本机上实现的RTP传输,并且只有一个RTPSession对象,所以我们的监听和接收的端口是同一个,所以此时我们的portBase要和我们加入到RTPSession对象中的客户端的端口一致,如上面我们可以都设置成6000.但是如果是在两个线程中,我们就要注意了,服务器端口和客户端口一定不一样,这也是基本的知识,用的时候要注意,多思考。


本文来自CSDN博客,转载请标明出处:http://blog.csdn.net/li_007/archive/2007/07/13/1689005.aspx

你可能感兴趣的:(网络编程)