JRTPLIB使用实例

大家好，又见面了，我是你们的朋友全栈君。

这几天在看关于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 <cstring>
+
 #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 <cstring>
+
 #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数据报

因为是关于JRTPLIB的文章，所以贴出的录音和放音代码不多。需要的朋友可以留下邮箱。