ortp库使用入门

原创作品,允许转载,转载时请务必以超链接形式标明文章 原始出处 、作者信息和本声明。否则将追究法律责任。http://ticktick.blog.51cto.com/823160/345642

    我们知道, 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;  

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.mzph.cn/news/253569.shtml

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

可测性设计技术

传统的设计过程和测试过程是分开的&#xff0c;而且测试往往只在设计阶段的后期才被考虑。近年来&#xff0c;测试越来越早地被考虑并出现在设计过程中&#xff0c;被称为“可测性设计”。可测性设计的主要思路就是在设计之初就考虑关于测试方面的设计&#xff0c;并在设计阶段…

优酷电视剧爬虫代码实现一:下载解析视频网站页面(3)补充知识点:htmlcleaner使用案例...

htmlcleaner 下载地址&#xff1a;htmlcleaner2_1.jar 源码下载&#xff1a;htmlcleaner2_1-all.zip 写一个测试用的html文件&#xff1a;html-clean-demo.html <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional" "http://www.w3.org/TR/xhtml1/D…

小程序开发-利用canvas实现保存二维码海报到本机

场景及需求 在小程序开发过程中&#xff0c;经常需要实现保存某个页面为带小程序码的二维码海报图片到本地&#xff0c;然后用于分享或者发朋友圈等操作。 主要技术点及小程序相关api 技术注意事项 小程序的canvas与H5 canvas使用api大部分一致&#xff0c;但由于小程序中没有D…

Docker系统六:Docker网络管理

Docker网络 I. Docer的通信方式 默认情况下&#xff0c;Docker使用网桥&#xff08;brige&#xff09; NAT的通信模型. Docker启动时会自动创建网桥Docker0&#xff0c;并配置ip 172.17.0.1/16 ifconfig docker0 docker0 Link encap:Ethernet HWaddr 02:42:e0:31:ac:10inet …

pthread_cond_wait

1. 首先pthread_cond_wait 的定义是这样的 The pthread_cond_wait() andpthread_cond_timedwait() functions are used to block on a condition variable. They are called withmutex locked by the calling thread or undefined behaviour will result. These functions ato…

HDU 1525 Euclid's Game

题目大意&#xff1a; 题目给出了两个正数a.b 每次操作&#xff0c;大的数减掉小的数的整数倍。一个数变为0 的时候结束。 谁先先把其中一个数减为0的获胜。问谁可以赢。Stan是先手。 题目思路&#xff1a; 无论a,b的值为多少&#xff0c;局面&#xff1a;[a%b&#xff0c;b] 一…

SRAM BIST技术学习

MBIST 方法是目前大容量存储器测试的主流技术&#xff0c;该技术利用芯片内部专门设计的BIST 电路进行自动化测试&#xff0c;能够对嵌入式存储器这种具有复杂电路结构的嵌入式模块进行全面的测试。MBIST 电路将产生测试向量的电路模块以及检测测试结果的比较模块都置于芯片的内…

【Zigbee技术入门教程-02】一图读懂ZStack协议栈的核心思想与工作机理

【Zigbee技术入门教程-02】一图读懂ZStack协议栈的核心思想与工作机理 广东职业技术学院 欧浩源 Z-Stack协议栈是一个基于任务轮询方式的操作系统&#xff0c;其任务调度和资源分配由操作系统抽象层OSAL管理着。 你可以理解为&#xff1a;Z-Stack协议栈 OSAL操作系统 CC25…

CMOS图像传感器——SmartSens

近年来CIS发展成为增量市场,国产CIS厂商也踊跃布局,给业界带来许多惊喜。思特威(上海)电子科技股份有限公司(SmartSens)正是国产CIS中亮眼的一家厂商。数据显示,2020年思特威安防监控市场的CIS芯片出货量为1.46亿颗,继续位居全球出货量TOP1的位置;同年,思特威的新兴领…

Servlet第二篇【Servlet调用图、Servlet细节、ServletConfig、ServletContext】

Servlet的调用图 前面我们已经学过了Servlet的生命周期了&#xff0c;我们根据Servlet的生命周期画出Servlet的调用图加深理解 Servlet的细节 一个已经注册的Servlet可以被多次映射 同一个Servlet可以被映射到多个URL上。 <servlet><servlet-name>Demo1</servle…

vue响应式原理

vue响应式原理 initState new Vue() > _init() > initState: function initState (vm: Component) {vm._watchers []const opts vm.$optionsif (opts.props) initProps(vm, opts.props)if (opts.methods) initMethods(vm, opts.methods)if (opts.data) {initData(vm)} …

Oracle数据库管理与开发pdf

下载地址&#xff1a;网盘下载基本介绍编辑内容简介Oracle是一个适合于大中型企事业的数据库管理系统&#xff0c;在银行、电信、移动通信、航空、保险、金融、气象、铁路、跨国公司和电子商务等诸多领域得到了广泛的应用。据统计&#xff0c;在所有数据库管理系统中&#xff0…

DVS/DVR区别

一、DVS &#xff08;Digital Video Server&#xff09;网络视频服务器的简称。DVS(网络视频服务器)的原理网络视频服务器主要实现模拟视音频信号的IP 化。经数字化的视音频信号MPEG-4 视频压缩算法和G.729/ADPCM 音频压缩算法进行压缩编码&#xff0c;然后通过IP 网将低码率的…

自动对焦方法学习

实现自动对焦的方法有很多种,可以根据不同的工作原理,将自动对焦技术分成不同种类。 按照系统是否自带信号发射系统,可以分为主动式与被动式两种类型。 主动式对焦方法是由成像系统中的发射装置发出信号,然后再由接收装置接收从被摄景物所反射回来的反馈信号并利用通过计算…

微粒化运营:升级内容产业消费体验(附视频版)

那些最受欢迎的内容平台做对了什么&#xff1f; Facebook和Google是全球互联网广告产业中最早开始微粒化运营的代表&#xff0c;Google的互联网精准广告的思路与微粒化运营是完全相同的&#xff0c;这两家公司也因此获得了全球超过20%的互联网广告的收入。 以Facebook为例&…

mycat读写分离

只需要读写分离的功能&#xff0c;分库分表的都不需要。 涉及到的配置文件&#xff1a; 1.conf/server.xml 主要配置的是mycat的用户名和密码&#xff0c;mycat的用户名和密码和mysql的用户名密码是分开的&#xff0c;应用连接mycat就用这个用户名和密码。 <?xml version&q…

chisel快速入门(一)

一、概述 Chisel&#xff08;Constructing Hardware In a Scala Embedded Language&#xff09;是一种嵌入在高级编程语言Scala的硬件构建语言。Chisel实际上只是一些特殊的类定义&#xff0c;预定义对象的集合&#xff0c;使用Scala的用法&#xff0c;所以在写Chisel程序时实际…

DVS/DVR常见的监控名词

英文名词 说明BNC 全称Bayonet Nut Connector&#xff0c;一种用于同轴电缆的连接器DHCP 动态主机配置协议&#xff0c;用于动态地指派配置信息DNS 域名系统&#xff0c;以用户友好的方式将名字转换为…

导出数据生成excel

前台&#xff1a; <asp:Button ID"btnMoney" runat"server" Text"经费使用总结表" CssClass"admin_cx marginleft" Height"25" OnClick"btnMoney_Click" /> 后台&#xff1a; protected void btnMoney_Cli…

U盘基本处理,U盘与移动固态硬盘

一、辨别 USB2.0 和 USB3.0 1、从USB外观上来看&#xff0c;USB2.0通常是白色或黑色&#xff0c;而USB3.0则改观为“高大上”的蓝色接口。 目前&#xff0c;部分笔记本电脑USB接口&#xff0c;已同时提供对USB2.0及USB3.0的支持&#xff0c;我们可以通过接口颜色来区别。 2、从…