ortp库使用入门

最新推荐文章于 2024-09-14 07:06:55 发布
最新推荐文章于 2024-09-14 07:06:55 发布
阅读量629 收藏
点赞数
文章标签： session signal buffer user null 语言
我们知道， RTP（Real-timeTransportProtocol）是用于Internet上针对多媒体数据流的一种传输协议，做流媒体传输方面的应用离不开RTP协议的实现及使用，为了更加快速地在项目中应用RTP协议实现流媒体的传输，我们一般会选择使用一些RTP库，例如使用c++语言编写的JRTPLIB库，网上关于RTP协议以及JRTPLIB库的介绍已经很多了，在此我也不再赘述，文本主要介绍实现了RTP协议的另一种开源库——ORTP库，这个库是纯使用c语言编写，由于我们的项目是基于Linux下的c语言编程，故我们选择了ortp作为我们的第三方库，在此我也对该库进行一个简单地介绍，希望对其他ortp的初学者有所帮助。

一、简介

ORTP是一个支持RTP以及RFC3550协议的库，有如下的特性：
（1）使用C语言编写，可以工作于windows, Linux, 以及 Unix平台
（2）实现了RFC3550协议，提供简单易用的API。支持多种配置，RFC3551为默认的配置。
（3）支持单线程下的多个RTP会话，支持自适应抖动处理。
（4）基于GPL版权声明。

ORTP可以在其官方网站上（http://www.linphone.org/index.php/eng/code_review/ortp）下载，下载解压后得到ORTP的源码包和示例程序（tests）。其帮助文档在docs目录下，也可以在http://download.savannah.gnu.org/releases/linphone/ortp/docs/在线查看。


关于ORTP的资料并不多，主要是其源码、帮助文档以及示例程序，关于示例程序说明如下：
rtprecv.c 和rtpsend.c 展示了如何接收和发送单RTP数据流。
mrtprecv.c mrtpsend.c 展示了如何同时接收和发送多个RTP数据流。

二、主要函数介绍

 rtp_session_init

函数原型： void rtp_session_init (RtpSession * session, int mode)
函数功能：执行rtp会话的一些必要的初始化工作
参数含义：
session： rtp会话结构体，含有一些rtp会话的基本信息
mode：    传输模式，有以下几种，决定本会话的一些特性。
RTP_SESSION_RECVONLY：只进行rtp数据的接收
RTP_SESSION_SENDONLY：只进行rtp数据的发送
RTP_SESSION_SENDRECV：可以进行rtp数据的接收和发送
 
执行的操作：
1.       设置rtp包缓冲队列的最大长度
2.       根据传输模式设置标志变量的值
3.       随机产生SSRC和同步源描述信息
4.       传入全局的av_profile，即使用默认的profile配置
5.       初始化rtp包缓冲区队列
6.       发送负载类型默认设置为0（pcmu音频），接收负载类型默认设置为-1（未定义）
7.       将 session的其他成员的值均设置一个默认值。
 
rtp_session_set_scheduling_mode
函数原型： void rtp_session_set_scheduling_mode (RtpSession * session, int yesno)
函数功能： RtpScheduler管理多个session的调度和收发的控制，本函数设置是否使用该session调度管理功能。
参数含义：
session： rtp会话结构体
yesno:   是否使用rtp session的系统调度功能
说明：
如果yesno为1，则表明使用系统的session调度管理功能，意味着可以使用以下功能：
1. 可以使用session_set_select在多个rtp会话之间进行选择，根据时间戳判定某个会话是否到达了收发的时间。
2. 可以使用rtp_session_set_blocking_mode()设置是否使用阻塞模式来进行rtp包的发送和接收。
如果yesno为0，则表明该会话不受系统管理和调度。
关于rtp session的管理和调度，由全局的变量 RtpScheduler *__ortp_scheduler来负责，该变量必须通过 ortp_scheduler_init() 来进行初始化操作。
 
rtp_session_set_blocking_mode
函数原型： void rtp_session_set_blocking_mode (RtpSession * session, int yesno)
函数功能：设置是否使用阻塞模式，
参数含义：
session： rtp会话结构体
yesno:  是否使用阻塞模式
说明：
阻塞模式只有在scheduling mode被开启的情况下才能使用，本函数决定了rtp_session_recv_with_ts() 和 rtp_session_send_with_ts()两个函数的行为，如果启用了阻塞模式，则rtp_session_recv_with_ts()会一直阻塞直到接收RTP包的时间点到达（这个时间点由该函数参数中所定义的时间戳来决定），当接收完RTP数据包后，该函数才会返回。同样，rtp_session_send_with_ts()也会一直阻塞直到需要被发送的RTP包的时间点到达，发送结束后，函数才返回。
 
rtp_session_signal_connect
函数原型： int rtp_session_signal_connect (RtpSession * session, const char *signal,   RtpCallback cb, unsigned long user_data)
函数功能：本函数提供一种方式，用于通知应用程序各种可能发生的RTP事件（信号）。可能通过注册回调函数的形式来实现本功能。
参数含义：
session： rtp会话结构体
signal： 信号的名称
cb：     回调函数
user_data：传递给回调函数的数据
返回值：0表示成功，-EOPNOTSUPP表示信号名称不存在，-1表示回调函数绑定错误
说明：
信号的名称必须是以下字符串中的一种：
"ssrc_changed" : 数据流的同步源标识改变
"payload_type_changed" : 数据流的负载类型改变
"telephone-event_packet" : telephone-event RTP包(RFC2833)被接收
"telephone-event" : telephone event 发生
"network_error" : 网络错误产生，传递给回调函数的是描述错误的字符串（const char *型）或者错误码（int型）
"timestamp_jump" : 接收到的数据包发生了时间戳的跳跃。
要取消事件（信号）的监听，可以使用下面这个函数
int rtp_session_signal_disconnect_by_callback ( RtpSession * session, const char * signal_name, RtpCallback cb )
 
rtp_session_set_local_addr
函数原型： int rtp_session_set_local_addr( RtpSession * session, const char * addr,int port)
函数功能：设置本地rtp数据监听地址
参数含义：
session： rtp会话结构体
addr： 本地IP地址，例如127.0.0.1，如果为NULL，则系统分配0.0.0.0
port：   监听端口，如果设置为-1，则系统为其自动分配端口
返回值： 0表示成功
说明：
如果是 RTP_SESSION_SENDONLY（只发送）型会话，则不需要进行本设置，而必须设置 rtp_session_set_remote_addr() 来设置远程目的地址。
如果采用了系统自动分配监听端口，则可以通过 int rtp_session_get_local_port(const RtpSession *session) 来获取系统分配的监听端口号。
 
rtp_session_set_remote_addr
函数原型： int rtp_session_set_remote_addr (RtpSession * session, const char * addr, int port)
函数功能：设置RTP发送的目的地址
参数含义：
session： rtp会话结构体
addr： 目的IP地址
port：   目的地址的监听端口号
返回值： 0表示成功
 
rtp_session_set_send_payload_type
函数原型： int rtp_session_set_send_payload_type (RtpSession * session, int paytype)
函数功能：设置RTP发送数据的负载类型
参数含义：
session： rtp会话结构体
paytype：负载类型
返回值： 0表示成功，-1表示负载未定义
说明：
负载类型在 payloadtype.h文件中有详细的定义，RTP接收端有着类似的负载类型设置函数， int rtp_session_set_recv_payload_type ( RtpSession * session, int paytype ) ，注意，发送的负载类型必须与接收的负载类型一致才能正常完成收发。
 
rtp_session_send_with_ts
函数原型： int rtp_session_send_with_ts (RtpSession * session, const char * buffer, int len,uint32_t userts)
函数功能：发送RTP数据包
参数含义：
session： rtp会话结构体
buffer： 需要发送的RTP数据的缓冲区
len：    需要发送的RTP数据的长度
userts： 本RTP数据包的时间戳
返回值： 成功发送到网络中的字节数
说明：
发送RTP数据需要自己管理时间戳的递增，每调用一次本函数，请根据实际情况对userts进行递增，具体递增的规则见RTP协议中的说明。
例如：如果发送的是采样率为90000Hz的视频数据包，每秒25帧，则时间戳的增量为：90000/25 = 3600
时间戳的起始值为随机值，建议设置为0 。
 
rtp_session_recv_with_ts
函数原型：int rtp_session_recv_with_ts (RtpSession * session, char * buffer,int len, uint32_t time, int * have_more)
函数功能：接收RTP数据包
参数含义：
session： rtp会话结构体
buffer： 存放接收的RTP数据的缓冲区
len：    期望接收的RTP数据的长度
time：    期望接收的RTP数据的时间戳
have_more：标识接收缓冲区是否还有数据没有传递完。当用户给出的缓冲区不够大时，为了标识缓冲区数据未取完，则have_more指向的数据为1，期望用户以同样的时间戳再次调用本函数；否则为0，标识取完。

rtp_session_destroy
【原型】： void rtp_session_destroy(RtpSession *session)
【功能】：摧毁rtp会话对象，释放资源
【参数】：session已经创建的RTP会话对象
 

三、程序示例

      下面，我简单地通过程序演示了怎么使用ortp进行rtp数据包的发送，接收端的程序待以后有时间再整理出来吧。

       注：示例代码我已经整理出来了，见博文： 《ortp编程示例代码》

 
 
  1. //     
  2. /// COPYRIGHT NOTICE     
  3.  // Copyright (c) 2009, 华中科技大学ticktick Group     
  4. /// All rights reserved.      
  5. ///      
  6. /// @file    ortpSend.c       
  7. /// @brief   ortpSend的测试     
  8. ///     
  9. /// 本文件示例使用ortp库进行rtp数据包的发送    
  10. ///      
  11. /// @version 1.0        
  12. /// @author  tickTick   
  13. /// @date    2010/07/07      
  14. /// @E-mail  lujun.hust@gmail.com     
  15. ///     
  16. /// 修订说明：创建文件    
  17. //      
  18.  
  19. #include <ortp/ortp.h>  
  20. #include <signal.h>  
  21. #include <stdlib.h>  
  22.  
  23. #ifndef _WIN32   
  24. #include <sys/types.h>  
  25. #include <sys/time.h>  
  26. #include <stdio.h>  
  27. #endif  
  28.  
  29. // 时间戳增量
  30. #define TIME_STAMP_INC  160   
  31. #define BYTES_PER_COUNT 65535


 
 
  1. // 时间戳   
  2. uint32_t g_user_ts;  
  3.  
  4. /**  初始化     
  5.  *       
  6.  *   主要用于对ortp以及其它参数进行初始化    
  7.  *   @param:  char * ipStr 目的端IP地址描述串     
  8.  *   @param:  iint port 目的端RTP监听端口     
  9.  *   @return:  RtpSession * 返回指向RtpSession对象的指针,如果为NULL，则初始化失败     
  10.  *   @note:       
  11.  */   
  12. RtpSession * rtpInit(char * ipStr,int port)  
  13. {  
  14.     // Rtp会话对象    
  15.     RtpSession *session;  
  16.     char *ssrc;  
  17.       
  18.     // 时间戳初始化    
  19.     g_user_ts = 0;  
  20.  
  21.     // ortp的一些基本初始化操作   
  22.     ortp_init();  
  23.     ortp_scheduler_init();  
  24.     // 创建新的rtp会话对象  
  25.     session=rtp_session_new(RTP_SESSION_SENDONLY);    
  26.       
  27.     rtp_session_set_scheduling_mode(session,1);  
  28.     rtp_session_set_blocking_mode(session,1);  
  29.     // 设置远程RTP客户端的的IP和监听端口（即本rtp数据包的发送目的地址）   
  30.     rtp_session_set_remote_addr(session,ipStr,port);  
  31.     // 设置负载类型    
  32.     rtp_session_set_payload_type(session,0);  
  33.       
  34.     // 获取同步源标识    
  35.     ssrc=getenv("SSRC");  
  36.     if (ssrc!=NULL)   
  37.     {  
  38.         printf("using SSRC=%i.\n",atoi(ssrc));  
  39.         rtp_session_set_ssrc(session,atoi(ssrc));  
  40.     }  
  41.       
  42.     return session;  
  43.  
  44. }  
  45.  
  46. /**  发送rtp数据包     
  47.  *       
  48.  *   主要用于发送rtp数据包     
  49.  *   @param:  RtpSession *session RTP会话对象的指针     
  50.  *   @param:  const char *buffer 要发送的数据的缓冲区地址      
  51.  *   @param: int len 要发送的数据长度     
  52.  *   @return:  int 实际发送的数据包数目     
  53.  *   @note:     如果要发送的数据包长度大于BYTES_PER_COUNT，本函数内部会进行分包处理     
  54.  */ 
  55. int rtpSend(RtpSession *session,const char *buffer, int len)  
  56. {  
  57.     int curOffset = 0;  
  58.     int sendBytes = 0;  
  59.     int clockslide=500;   
  60.     // 发送包的个数  
  61.     int sendCount = 0;  
  62.  
  63.     ortp_message("send data len %i\n ",len);  
  64.  
  65.     // 是否全部发送完毕    
  66.     while(curOffset < len )  
  67.     {  
  68.         // 如果需要发送的数据长度小于等于阙值，则直接发送  
  69.         if( len <= BYTES_PER_COUNT )  
  70.         {  
  71.             sendBytes = len;  
  72.         }  
  73.         else 
  74.         {  
  75.             // 如果当前偏移 + 阈值 小于等于 总长度，则发送阈值大小的数据  
  76.             if( curOffset + BYTES_PER_COUNT <= len )  
  77.             {  
  78.                 sendBytes = BYTES_PER_COUNT;  
  79.             }  
  80.             // 否则就发送剩余长度的数据  
  81.             else 
  82.             {  
  83.                 sendBytes = len - curOffset;  
  84.             }  
  85.         }  
  86.           
  87.         ortp_message("send data bytes %i\n ",sendBytes);  
  88.           
  89.         rtp_session_send_with_ts(session,(char *)(buffer+curOffset),sendBytes,g_user_ts);  
  90.           
  91.         // 累加  
  92.         sendCount ++;  
  93.         curOffset += sendBytes;                   
  94.         g_user_ts += TIME_STAMP_INC;  
  95.       
  96.         // 发送一定数据包后休眠一会  
  97.         if (sendCount%10==0)   
  98.         {  
  99.             usleep(20000);  
  100.         }     
  101.     }  
  102.     return 0;  
  103. }  
  104.  
  105. /**  结束ortp的发送，释放资源     
  106.  *      
  107.  *   @param:  RtpSession *session RTP会话对象的指针     
  108.  *   @return:  0表示成功     
  109.  *   @note:         
  110.  */ 
  111. int rtpExit(RtpSession *session)  
  112. {  
  113.     g_user_ts = 0;  
  114.       
  115.     rtp_session_destroy(session);  
  116.     ortp_exit();  
  117.     ortp_global_stats_display();  
  118.  
  119.     return 0;  
  120. }  
  121.  
  122. // 主函数，进行测试  
  123. int main()  
  124. {  
  125.     // 待发送的数据缓冲区  
  126.     char * pBuffer = "123445356234134234532523654323413453425236244123425234";  
  127.       
  128.     RtpSession * pRtpSession = NULL;  
  129.     // 向（192.201.0.51，8000）目的地址发送rtp包  
  130.     pRtpSession = rtpInit("192.201.0.51",8000);  
  131.     if(pRtpSession==NULL)  
  132.     {  
  133.         printf("error rtpInit");  
  134.         return 0;  
  135.     }  
  136.       
  137.     // 循环发送  
  138.     while(1)  
  139.     {  
  140.         if( rtpSend(pRtpSession,pBuffer,20) != 0)  
  141.         {  
  142.             printf("error rtpInit");  
  143.             break;  
  144.         }  
  145.         usleep(10000);  
  146.         printf("sleep");  
  147.     }  
  148.       
  149.     // 退出  
  150.     rtpExit(pRtpSession);  
  151.       
  152.     return 0;  
  153. } 

 

本文出自 “对影成三人” 博客，请务必保留此出处http://ticktick.blog.51cto.com/823160/345642


骑墙头等红杏
关注
ortp RTP/RTCP
09-19
ORTP 很详细的RTP/RTCP控制源代码。 适用与linux window android等
ORTP库入门
12-02
ORTP库入门，包括函数介绍，初始化，发送，接收和一个简单的代码例子。
oRTP：开源RTP协议实现库
最新发布
gitblog_00860的博客
09-14 676
oRTP：开源RTP协议实现库 ortp mirror of linphone's git tree 项目地址: https://gitcode.com/gh_mirrors/ort/ortp ...
ortp使用详解 ortp-release.pdf
技术斋
12-22 7473
学习ortp时无意间在网上找到了一篇好的文档，一个叫岳维功的前辈写的，原来是转载在这的，可是内容较多，而且图片这拷贝不下来，所以干脆删了它，本人把它上传在我的csdn资源中，供免费下载，下面是链接： ortp 使用详解.pdf 岳维功 在这里一并提供华中科技大学鲁俊前辈的博客链接，在本人学习ortp期间，曾与这位大哥多次邮件请教，均得到回复，这里表示感谢！这也让我学到了技术共享、资源共享，互助
ORTP使用(一）
人独刀孤
05-27 581
笔者需要开发一款视频传输软件，特把RTP做为音视频传输协议，现将开发过程记录如下。 1、如何使用VLC作为测试软件。 1）编写SDP文件如下，保存为test.sdp m=video 6100 RTP/AVP 96 a=rtpmap:96 H264/90000; a=decode_buf=300; a=framerate:25 m=audio 6104 RTP/AVP 8 a=rtpmap:8 pcma/8000 a=framerate::25 我在这里使用了H264视频编码，25帧/秒， RTP端口
oSIP协议栈(及eXoSIP,Ortp等)使用入门1.docx
03-13
eXoSIP和Ortp是oSIP的扩展或相关组件，eXoSIP可能是一个增强版的oSIP库，而Ortp通常是用于实时传输协议（RTP）的库，与oSIP配合处理语音和视频流。 本文档主要讲解oSIP协议栈及其相关组件在Windows环境下，特别是...
oSIP协议栈(及eXoSIP、Ortp等)使用入门.pdf
11-16
- 创建一个Win32控制台应用程序，使用oSIP的测试源码进行验证，确保库文件已正确链接并能正常运行。 oSIP的语法规范是基于SIP标准的，测试文件通常用于检查oSIP库的解析和消息构造功能。oSIP提供了丰富的API，用于...
oSIP协议栈(及eXoSIP、Ortp等)使用入门 (2).pdf
11-16
配置你的项目以使用oSIP库： 1. 创建一个Win32控制台应用程序项目。 2. 添加oSIP的头文件引用，例如`#include <osip2/osip.h>`。 3. 在项目的链接器设置中，添加osip2.lib和osipparser2.lib作为依赖库。 为了验证...
ortp库以及其相关内容
08-14
注释可以解释每个函数的作用、参数含义、返回值以及可能的错误情况，有助于快速理解和使用ORTP库。此外，了解RTP和RTCP的基本概念以及它们在网络通信中的角色也是必要的，这可以帮助你更好地利用ORTP库来实现高效的...
ortp-0.27.0.tar.gz
04-27
来自官网ortp-0.27.0.tar.gz源码下载,oRTP 是一款开源软件,实现了 RTP 与 RTCP 协议.
ortp-master.zip
07-26
ortp源码包
ORTP
qq_37933895的博客
09-02 2846
1.为什么要使用RTP 一提到流媒体传输、一谈到什么视频监控、视频会议、语音电话（VOIP），都离不开RTP协议的应用，但当大家都根据经验或者别人的应用而选择RTP协议的时候，你可曾想过，为什么我们要使用RTP来进行流媒体的传输呢？为什么我们一定要用RTP？难道TCP、UDP或者其他的网络协议不能达到我们的要求么？ 像TCP这样的可靠传输协议，通过超时和重传机制来保证传输数据流中的每一个bi...
oRTP
yasi_xi的专栏
05-14 796
oRTP库： http://www.linphone.org/technical-corner/ortp/overview 下载和Build： mkdir -p /home/yasi/ortp cd /home/yasi/ortp wget http://download.savannah.gnu.org/releases/linphone/ortp/sources/ortp-0
ortp 编译测试
心中天堂的专栏
10-29 4565
1.获得原码包 我是从csdn获得 ortp-0.20.0.zip 2.编译安装 解压并进入主目录：cd /opt/ortp-0.20.0 执行如下命令： a）./configure b）make c）sudo make  install 装好以后系统环境如下，静态动态库安装到了/usr/local/lib目录下，包括libortp.la、libortp.so libortp.
海思3518E开发笔记3.3——ORTP的使用
路人coder
07-23 715
目录在官方SDK的sampe中添加rtp传输代码环境准备开发板部署并运行实时预览 在官方SDK的sampe中添加rtp传输代码 首先，在/venc/sample_venc.c中添加s32ChnNum = 1;将码流控制为1路 然后修改common/sample_common_venc.c,在第一个函数上添加 #define ORTP_ENABLE 1 #if ORTP_ENABLE #include <ortp/ortp.h> #include <signal.h> #incl
ortp使用详解1
weixin_30456039的博客
10-16 158
一: 关于 oRTP oRTP 是一款开源软件,实现了 RTP 与 RTCP 协议。目前使用 oRTP 库的软件主要是linphone(一款基于IP 进行视频和语音通话的软件)。 oRTP作为 linphone 的 RTP 库,为基于 RTP 协议传输语音和视频数据提供保障。 二: 源代码的构建框架 类似于 mediastream2 中的 filter,在RTP 中也有比较重要的一个结构...
ortp使用详解
热门推荐
潜龙勿用
03-07 1万+
岳维功 一:关于 oRTP oRTP 是一款开源软件,实现了 RTP 与 RTCP 协议。 目前使用 oRTP 库的软件主要是linphone(一款基于IP 进行视频和语音通话的软件)。 oRTP作为 linphone 的 RTP 库,为基于 RTP 协议传输语音和视频数据提供保障。 二:源代码的构建框架 类似于 mediastream2 中的 filter,在RTP 中也有
oRTP深入解析：调度、阻塞模式与数据传输
"oRTP使用详解 - 岳维功" 本文档主要介绍了oRTP库的使用，oRTP是一个开源实现RTP和RTCP协议的库，主要用于支持如linphone这样的IP语音和视频通话软件。oRTP库确保了RTP协议下音视频数据的稳定传输。 一、oRTP基础 ...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值