JRTPLIB rtp 实时流媒体传输

http://javahigh1.iteye.com/blog/1206495

linux 下基于jrtplib库的实时传送实现
一、RTP 是进行实时流媒体传输的标准协议和关键技术

实 时传输协议（Real-time Transport Protocol，PRT）是在 Internet 上处理多媒体数据流的一种网络协议，利用它能 够在一对一（unicas，单播）或者一对多（multicas，多播）的网络环境中实现传流媒体数据的实时传输。RTP 通常使用 UDP 来进行 多媒体数据的传输，但如果需要的话可以使用 TCP 或者 ATM 等其它协议。
协议分析 ：每一个RTP数据报都由头部（Header）和负载（Payload）两个部分组成，其中头部前 12 个字节的含义是固定的，而负载则可以是音频或者视频数据。
RTP 是 目前解决流媒体实时传输问题的最好办法，要在 Linux 平台上进行实时传送编程，可以考虑使用一些开放源代码的 RTP 库，如 LIBRTP、 JRTPLIB 等。JRTPLIB 是一个面向对象的 RTP 库，它完全遵循 RFC 1889 设计，在很多场合下是一个非常不错的选择。 JRTPLIB 是一个用 C++ 语言实现的 RTP 库，这个库使用socket 机制实现网络通讯 因此可以运行在 Windows、Linux、 FreeBSD、Solaris、Unix和VxWorks 等多种操作系统上。

二、JRTPLIB 库的使用方法及程序实现

(1)JRTPLIB 函数 的使用
a、 在使用 JRTPLIB 进行实时流媒体数据传输之前，首先应该生成 RTPSession 类的一个实例来表示此次 RTP 会话，然后调 用 Create() 方法来对其进行初始化操作。RTPSession 类的 Create() 方法只有一个参数，用来指明此次 RTP 会话所采用 的端口号。
RTPSession sess; sess.Create(5000); 
b、设置恰当的时戳单元，是 RTP 会话初始化过程所要进行的另外一项重要工作，这是通过调用 RTPSession 类的 SetTimestampUnit() 方法来实现的，该方法同样也只有一个参数，表示的是以秒为单元的时戳单元。
sess.SetTimestampUnit(1.0/8000.0);
c、 当 RTP 会话成功建立起来之后，接下去就可以开始进行流媒体数据的实时传输了。首先需要设置好数据发送的目标地址，RTP 协议允许同一会话存在多个 目标地址，这可以通过调用 RTPSession 类的 AddDestination()、 DeleteDestination() 和 ClearDestinations() 方法来完成。例如，下面的语句表示的是让 RTP 会话将数据发 送到本地主机的 6000 端口： 
unsigned long addr = ntohl(inet_addr("127.0.0.1")); 
sess.AddDestination(addr, 6000);
d、目标地址全部指定之后，接着就可以调用 RTPSession 类的 SendPacket() 方法，向所有的目标地址发送流媒体数据。SendPacket() 是 RTPSession 类提供的一个重载函数
对 于同一个 RTP 会话来讲，负载类型、标识和时戳增量通常来讲都是相同的，JRTPLIB 允许将它们设置为会话的默认参数，这是通过调 用 RTPSession 类的 SetDefaultPayloadType()、 SetDefaultMark() 和 SetDefaultTimeStampIncrement() 方法来完成的。为 RTP 会话设置这些默认参 数的好处是可以简化数据的发送，例如，如果为 RTP 会话设置了默认参数： 
sess.SetDefaultPayloadType(0);
sess.SetDefaultMark(false); 
sess.SetDefaultTimeStampIncrement(10);

之后在进行数据发送时只需指明要发送的数据及其长度就可以了： 
sess.SendPacket(buffer, 5);

e、 对于流媒体数据的接收端，首先需要调用 RTPSession 类的 PollData() 方法来接收发送过来的 RTP 或者 RTCP 数据报。由 于同一个 RTP 会话中允许有多个参与者（源），你既可以通过调用 RTPSession 类 的 GotoFirstSource() 和 GotoNextSource() 方法来遍历所有的源，也可以通过调用 RTPSession 类 的 GotoFirstSourceWithData() 和 GotoNextSourceWithData() 方法来遍历那些携带有数据的源。在 从 RTP 会话中检测出有效的数据源之后，接下去就可以调用 RTPSession 类的 GetNextPacket() 方法从中抽取 RTP 数 据报，当接收到的 RTP 数据报处理完之后，一定要记得及时释放。
JRTPLIB 为 RTP 数据报定义了三种接收模式，其中每种接 收模式都具体规定了哪些到达的 RTP 数据报将会被接受，而哪些到达的 RTP 数据报将会被拒绝。通过调用 RTPSession 类 的 SetReceiveMode() 方法可以设置下列这些接收模式： 
? RECEIVEMODE_ALL　　缺省的接收模式，所有到达的 RTP 数据报都将被接受； 
? RECEIVEMODE_IGNORESOME 　　除了某些特定的发送者之外，所有到达的 RTP 数据报都将被接受，而被拒绝的发送者列表可以通过调用 AddToIgnoreList()、 DeleteFromIgnoreList() 和 ClearIgnoreList() 方法来进行设置； 
? RECEIVEMODE_ACCEPTSOME 　　除了某些特定的发送者之外，所有到达的 RTP 数据报都将被拒绝，而被接受的发送者列表可以通过调用 AddToAcceptList ()、 DeleteFromAcceptList 和 ClearAcceptList () 方法来进行设置。 下面是采用第三种接收模式的程序示例。
if (sess.GotoFirstSourceWithData()) { 
do { 
sess.AddToAcceptList(remoteIP, allports,portbase);
sess.SetReceiveMode(RECEIVEMODE_ACCEPTSOME);
RTPPacket *pack; 
pack = sess.GetNextPacket(); // 处理接收到的数据 
delete pack; } 
while (sess.GotoNextSourceWithData()); 
}

（2）程序流程图
发送：获得接收端的 IP 地址和端口号 创建 RTP 会话 指定 RTP 数据接收端 设置 RTP 会话默认参数 发送流媒体数据
接收：获得用户指定的端口号 创建RTP会话 设置接收模式 接受RTP数据 检索RTP数据源 获取RTP数据报 删除RTP数据报

三、环境搭建及编译方法

（1）Toolchain的安装
首先找到xscale-arm-toolchain.tgz文件，假设该文件包放在/tmp/下
#cd /
#tar -zxvf /tmp/xscale-arm-toolchain.tgz
再设置环境变量
#export PATH=/usr/local/arm-linux/bin:$PATH
最后检查一下交叉编译工具是否安装成功
#arm-linux-g++ --version
看是否显示arm-linux-g++的版本，如有则安装成功。
（2）JRTPLIB 库的交叉编译及安装
首先从 JRTPLIB 的网站（http://lumumba.luc.ac.be/jori/jrtplib/jrtplib.htmll） 下载最新的源码包，此处使用的是jrtplib-2.8.tar，假设下载后的源码包放在/tmp下，执 行下面的命令对其解压缩：
#cd /tmp
#tar -zxvf jrtplib-2.8.tar
然后要对jrtplib进行配置和编译
#cd jrtplib-2.8
#./configure CC=arm-linux-g++ cross-compile=yes
修改Makefile文件
将链接命令ld 和ar改为arm-linux-ld和 arm-linux-ar
#make
最后再执行如下命令就可以完成 JRTPLIB 的安装：
#make install
(3)程序编译
a、配置编译环境
可以用export来配置，也可以用编写Makefile的方法。这里采用Makefile。
编写Makefile&:
INCL = -I/usr/local/include
CFLAGS = -pipe -O2 -fno-strength-reduce
LFLAGS = /usr/local/lib/libjrtp.a -L/usr/X11R6/lib
LIBS = -LX11 -LXext /usr/local/lib/libjrtp.a
CC = arm-linux-g++
main:main.o
$(CC) $(LFLAGS) $(INCL) -o main main.o $(LIBS)
main.o:main.cpp
clean:
rm -f main
rm -f *.o
.SUFFIXES:.cpp
.cpp.o:
$(CC) -c $(CFLAGS) $(INCL) -o $@ $< /* $@表示目标的完整名字 */
/* $<表示第一个依赖文件的名字 */
b、编译
假设发送和接收程序分别放在/tmp/send和/tmp/receive目录下
#cd /tmp/send
#make
#cd /tmp/receive
#make
四、易出错误及注意问题
1、找不到一些标准的最 基本的一些头文件。
主要是因为Toolchain路径没安装对，要 严格按照步骤安装。
2、找不到使用的jrtplib库中的一些头文件。
在 jrtplib的安装目录下，include路径下不能再有别的目录。
3、recieve函数接收数据包不能正确提出所要数据。
由 于每一个RTP数据报都由头部（Header）和负载（Payload）两个部分组成，若使用getrawdata()是返回整个数据包的数据，包含传输 媒体的类型、格式、序列号、时间戳以及是否有附加数据等信息。getpayload()函数是返回所发送的数据。两者一定要分清。
4、设置RECEIVEMODE_ACCEPTSOME　　接收模式后，运行程序接收端不能接包。
IP地址格式出了问题。iner_addr()与ntohl()函数要用对，否则参数传不进去，接受列表中无值，当然接收不了数据包。
5、编译通过，但测试时接收端不能接收到数据。
可能是接收机防火墙未关闭。运行：
#iptables -F
也可能是IP地址没有设置好。运行：
#ifocnfig eth0 *.*.*.* netmask *.*.*.*
6、使用jrtolib库时，在程序中include 后最好加上库所在的路径。
五、程序
send:
#include
#include
#include "rtpsession.h"
// 错误处理函数
void checkerror(int err)
{
if (err < 0) {
char* errstr = RTPGetErrorString(err);
printf("Error:%s//n", errstr);
exit(-1);
}
}
int main(int argc, char** argv)
{
RTPSession sess;
unsigned long destip;
int destport;
int portbase = 6000;
int status, index;
char buffer[128];
if (argc != 3) {
printf("Usage: ./sender destip destport//n");
return -1;
}
// 获得接收端的IP地址和端口号
destip = inet_addr(argv[1]);
if (destip == INADDR_NONE) {
printf("Bad IP address specified.//n");
return -1;
}
destip = ntohl(destip);
destport = atoi(argv[2]);
// 创建RTP会话
status = sess.Create(portbase);
checkerror(status);
// 指定RTP数据接收端
status = sess.AddDestination(destip, destport);
checkerror(status);
// 设置RTP会话默认参数
sess.SetDefaultPayloadType(0);
sess.SetDefaultMark(false);
sess.SetDefaultTimeStampIncrement(10);
// 发送流媒体数据
index = 1;
do {
sprintf(buffer, "%d: RTP packet", index ++);
sess.SendPacket(buffer, strlen(buffer));
printf("Send packet !//n");
} while(1);
return 0;
}

receive:
#include
#include "rtpsession.h"
#include "rtppacket.h"
// 错误处理函数
void checkerror(int err)
{
if (err < 0) {
char* errstr = RTPGetErrorString(err);
printf("Error:%s//n", errstr);
exit(-1);
}
}
int main(int argc, char** argv)
{
RTPSession sess;
int localport,portbase;
int status;
unsigned long remoteIP;
if (argc != 4) {
printf("Usage: ./sender localport//n");
return -1;
}
// 获得用户指定的端口号

remoteIP = inet_addr(argv[1]);
localport = atoi(argv[2]);
portbase = atoi(argv[3]);
// 创建RTP会话
status = sess.Create(localport);
checkerror(status);

//RTPHeader *rtphdr;
unsigned long timestamp1;
unsigned char * RawData;
unsigned char temp[30];
int lengh ,i;
bool allports = 1;

sess.AddToAcceptList(remoteIP, allports,portbase);

do {
//设置接收模式
sess.SetReceiveMode(RECEIVEMODE_ACCEPTSOME);
sess.AddToAcceptList(remoteIP, allports,portbase);
// 接受RTP数据
status = sess.PollData();

// 检索RTP数据源
if (sess.GotoFirstSourceWithData()) {
do {

RTPPacket* packet;
// 获取RTP数据报
while ((packet = sess.GetNextPacket()) != NULL) {
printf("Got packet !/n");
timestamp1 = packet->GetTimeStamp();
lengh=packet->GetPayloadLength();
RawData=packet->GetPayload();

for(i=0;i temp[i]=RawData[i];
printf("%c",temp[i]);
}
temp[i]='/0';
printf(" timestamp: %d lengh=%d data:%s/n",timestamp1,lengh,&temp);
// 删除RTP数据报

delete packet;
}
} while (sess.GotoNextSourceWithData());
}
} while(1);
return 0;
}

这几天在看关于JRTPLIB方面的东西。在网上看了不少文章，其中有很大部分使用的JRTPLIB版本在3.0以下。
在网上下载了一个JRTPLIB-3.7的库，发现里面的函数接口做了一些修改。现奉上一篇基于JRTPLIB-3.7的网络
语音传送实例，希望有兴趣的朋友一起参详研究。
-------chuckGao
第一部分 JRTPLIB的编译及安装
这是必行的一步，在网上可以找到相关的文章，这里就不啰嗦了。不过可能有些朋友会遇到JRTPLIB
无法正常编译的情况，出现error: 'memcpy' was not declared in this scope的错误。这是由于JRTPLIB编
译中无法找到memcpy这个函数。在网上有memcpy的patch。内容如下：
diff --git a/src/rtcpcompoundpacketbuilder.cpp b/src/rtcpcompoundpacketbuilder.cpp
index 8172007..8fd4510 100644
--- a/src/rtcpcompoundpacketbuilder.cpp
+++ b/src/rtcpcompoundpacketbuilder.cpp
@@ -30,6 +30,8 @@

*/

+#include
+
#include "rtcpcompoundpacketbuilder.h"
#include "rtcpsrpacket.h"
#include "rtcprrpacket.h"
diff --git a/src/rtppacket.cpp b/src/rtppacket.cpp
index b6d5fda..8c516c7 100644
--- a/src/rtppacket.cpp
+++ b/src/rtppacket.cpp
@@ -30,6 +30,8 @@

*/

+#include
+
#include "rtppacket.h"
#include "rtpstructs.h"
#include "rtpdefines.h"
+代表添加，-代表删除相应内容

第二部分 JRTPLIB编程
下面先转载一部分网上的指南，红色标记是JRTPLIB-3.7修了后的使用方法
linux 下基于jrtplib库的实时传送实现
一、RTP 是进行实时流媒体传输的标准协议和关键技术
实时传输协议（Real-time Transport Protocol，PRT）是在 Internet 上处理多媒体数据流的一种网络协议
，利用它能够在一对一（unicast，单播）或者一对多（multicast，多播）的网络环境中实现传流媒体数据的
实时传输。RTP 通常使用 UDP 来进行多媒体数据的传输，但如果需要的话可以使用 TCP 或者 ATM 等其它协
议。
协议分析 ：每一个RTP数据报都由头部（Header）和负载（Payload）两个部分组成，其中头部前 12 个字节
的含义是固定的，而负载则可以是音频或者视频数据。
RTP 是目前解决流媒体实时传输问题的最好办法，要在 Linux 平台上进行实时传送编程，可以考虑使用
一些开放源代码的 RTP 库，如 LIBRTP、JRTPLIB 等。JRTPLIB 是一个面向对象的 RTP 库，它完全遵循 RFC 
1889 设计，在很多场合下是一个非常不错的选择。JRTPLIB 是一个用 C++ 语言实现的 RTP 库，这个库使用
socket 机制实现网络通讯 因此可以运行在 Windows、Linux、FreeBSD、Solaris、Unix和VxWorks 等多种操
作系统上。
二、JRTPLIB 库的使用方法及程序实现
(1)JRTPLIB 函数 的使用
a、在使用 JRTPLIB 进行实时流媒体数据传输之前，首先应该生成 RTPSession 类的一个实例来表示此次 RTP 
会话，然后调用 Create() 方法来对其进行初始化操作。RTPSession 类的 Create() 方法只有一个参数，用
来指明此次 RTP 会话所采用的端口号。
RTPSession sess; sess.Create(5000); 
JRTPLIB-3.7中已经修改了Create（prot）方法。新的Create方法被修改为Crea(sessparams,&transparams)。其中的两个参数需要如下先定义： 
RTPUDPv4TransmissionParams transparams;
RTPSessionParams sessparams;
sessparams.SetOwnTimestampUnit(1.0/8000.0);/*设置时间戳，1/8000表示1秒钟采样8000次，即录音时的8KHz*/
sessparams.SetAcceptOwnPackets(true);
transparams.SetPortbase(portbase);/*本地通讯端口*/
b、设置恰当的时戳单元，是 RTP 会话初始化过程所要进行的另外一项重要工作，这是通过调用 RTPSession 
类的 SetTimestampUnit() 方法来实现的，前面已经提过。
c、当 RTP 会话成功建立起来之后，接下去就可以开始进行流媒体数据的实时传输了。首先需要设置好数据发
送的目标地址，RTP 协议允许同一会话存在多个目标地址，这可以通过调用 RTPSession 类的 
AddDestination()、DeleteDestination() 和 ClearDestinations() 方法来完成。例如，下面的语句表示的
是让 RTP 会话将数据发送到本地主机的 6000 端口： 
unsigned long addr = ntohl(inet_addr("127.0.0.1")); 
sess.AddDestination(addr, 6000);
d、目标地址全部指定之后，接着就可以调用 RTPSession 类的 SendPacket() 方法，向所有的目标地址发送
流媒体数据。SendPacket() 是 RTPSession 类提供的一个重载函数
对于同一个 RTP 会话来讲，负载类型、标识和时戳增量通常来讲都是相同的，JRTPLIB 允许将它们设置为会
话的默认参数，这是通过调用 RTPSession 类的 SetDefaultPayloadType()、SetDefaultMark() 和 
SetDefaultTimeStampIncrement() 方法来完成的。为 RTP 会话设置这些默认参数的好处是可以简化数据的发
送，例如，如果为 RTP 会话设置了默认参数： 
sess.SetDefaultPayloadType(0);
sess.SetDefaultMark(false); 
sess.SetDefaultTimeStampIncrement(10);
之后在进行数据发送时只需指明要发送的数据及其长度就可以了： 
sess.SendPacket(buffer, 5); 
在真正的语音传输中，上面的buffer就是我们录音时所得到的buffer。使用上面的函数可以简单的发送，但无法真正的实现RTP传输，我们需要调用另一个接口：sess.SendPacket((void *)buffer,sizeof(buffer),0,false,8000);详细的说明可以查看JRTPLIB的说明文档。
e、对于流媒体数据的接收端，首先需要调用 RTPSession 类的 PollData() 方法来接收发送过来的 RTP 或者 
RTCP 数据报。
JRTPLIB-3.7中修改PollData（）方法为Poll（），使用都一样
由于同一个 RTP 会话中允许有多个参与者（源），你既可以通过调用 RTPSession 类的 
GotoFirstSource() 和 GotoNextSource() 方法来遍历所有的源，也可以通过调用 RTPSession 类的 
GotoFirstSourceWithData() 和 GotoNextSourceWithData() 方法来遍历那些携带有数据的源。在从 RTP 会
话中检测出有效的数据源之后，接下去就可以调用 RTPSession 类的 GetNextPacket() 方法从中抽取 RTP 数
据报，当接收到的 RTP 数据报处理完之后，一定要记得及时释放。
JRTPLIB 为 RTP 数据报定义了三种接收模式，其中每种接收模式都具体规定了哪些到达的 RTP 数据报将会被
接受，而哪些到达的 RTP 数据报将会被拒绝。通过调用 RTPSession 类的 SetReceiveMode() 方法可以设置
下列这些接收模式： 
RECEIVEMODE_ALL　　缺省的接收模式，所有到达的 RTP 数据报都将被接受； 
RECEIVEMODE_IGNORESOME　　除了某些特定的发送者之外，所有到达的 RTP 数据报都将被接受，而被拒绝
的发送者列表可以通过调用 AddToIgnoreList()、DeleteFromIgnoreList() 和 ClearIgnoreList() 方法来进
行设置； 
RECEIVEMODE_ACCEPTSOME　　除了某些特定的发送者之外，所有到达的 RTP 数据报都将被拒绝，而被接受
的发送者列表可以通过调用 AddToAcceptList ()、DeleteFromAcceptList 和 ClearAcceptList () 方法来进
行设置。 下面是采用第三种接收模式的程序示例。
if (sess.GotoFirstSourceWithData()) { 
do { 
sess.AddToAcceptList(remoteIP, allports,portbase);
sess.SetReceiveMode(RECEIVEMODE_ACCEPTSOME);
RTPPacket *pack; 
pack = sess.GetNextPacket(); // 处理接收到的数据 
delete pack; } 
while (sess.GotoNextSourceWithData()); 
}
完整的代码中，首先需调用Poll（）方法接收RTP数据报，然后在BeginDataAccess()和EndDataAccess()之间进行数据接收的操作。此时，我们设定程序一直do-while等待并处理数据
do{
#ifndef RTP_SUPPORT_THREAD
error_status = sess_client.Poll();
checkerror(error_status);
#endif // RTP_SUPPORT_THREAD
sess_client.BeginDataAccess();
// check incoming packets
if (sess_client.GotoFirstSourceWithData())
{
printf("Begin play/n");
do
{
RTPPacket *pack;
while ((pack = sess_client.GetNextPacket()) != NULL)
{
// You can examine the data here
printf("Got packet !/n");

timestamp1 = pack->GetTimestamp();
lengh=pack->GetPayloadLength();
RawData=pack->GetPayloadData(); //得到数据
printf(" timestamp: %d lengh=%d/n",timestamp1,lengh);
// we don't longer need the packet, so
// we'll delete it
//Begin play
int fd = open("/dev/dsp", O_RDWR);
int status = write(fd, RawData,lengh );
printf("Play bytes:%d/n",status);
if (status != lengh)
perror("wrote wrong number of bytes");
status = ioctl(fd, SOUND_PCM_SYNC, 0);
if (status == -1)
perror("SOUND_PCM_SYNC ioctl failed");
printf("Play end/n");
close(fd);
sess_client.DeletePacket(pack);
}
} while (sess_client.GotoNextSourceWithData());
//return 0;
}
sess_client.EndDataAccess();

}while(1);
（2）程序流程图
发送：获得接收端的 IP 地址和端口号 创建 RTP 会话 指定 RTP 数据接收端 设置 RTP 会话 默认参数 发送流媒体数据
接收：获得用户指定的端口号 创建RTP会话 设置接收模式 接受RTP数据 检索RTP数据源 获取RTP数据报 删除RTP数据报

本文来自CSDN博客，转载请标明出处：http://blog.csdn.net/guiterb/archive/2009/10/11/4616123.aspx