当前位置：首页 > backend >正文

JRTPLIB使用实例

backend 2025/7/5 23:16:54

这几天在看关于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的文章，所以贴出的录音和放音代码不多。需要的朋友可以留下邮箱。

查看全文

http://www.xdnf.cn/news/11171.html