ortp库使用入门

    技术2022-05-13  11

    我们知道, 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://mirror.veriportal.com/savannah/linphone/ortp/docs/在线查看。

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

    二、主要函数介绍

    ortp_init 【原型】:void ortp_init( void) 【功能】:初始化ORTP库,在使用ORTP API前需要首先调用本函数。

    ortp_exit  【原型】:void ortp_exit ( void) 【功能】:结束ORTP的使用。

    rtp_session_new 【原型】:RtpSession* rtp_session_new (int mode) 【功能】:RtpSession为RTP会话的结构体对象,本函数创建一个新的RTP会话对象。 【参数】:mode为RTP_SESSION_SENDONLY(只发送)或者 RTP_SESSION_RECVONLY (只接收)、RTP_SESSION_SENDRECV(既发送也接收)等 【返回值】:指向新创建的RTP会话对象的指针。

    rtp_session_set_remote_addr 【原型】:int rtp_session_set_remote_addr( RtpSession * session,const char *addr,int port) 【功能】:设置远程RTP数据接收端的IP地址 【参数】: session :已经创建的RTP会话对象 addr :   目的地址的IP port :   目的地址的rtp端口号 【返回值】:0表示成功。

    rtp_session_set_local_addr 【原型】:int rtp_session_set_local_addr(RtpSession *session,const char *addr,int port) 【功能】:设置本地监听地址,如果rtp会话设置为只发送模式,则不需要调用本函数。如果是非只发送模式,并且没有调用本函数,则系统模式设置本地IP为0.0.0.0,并且随机分配一个监听端口。 【参数】: session :已经创建的RTP会话对象 addr   : 本地监听的IP port    :本地监听的端口号,如果给-1,则系统随机分配一个端口号

    rtp_session_set_send_payload_type 【原型】:int rtp_session_set_send_payload_type(RtpSession *session,int paytype) 【功能】:设置RTP会话的负载类型。负载类型用来告诉播放器传输的是哪种类型的媒体(例如H.264,MPEG-4等,播放器才知道格式,才会调用适当的编解码器去播放。 【参数】: session :已经创建的RTP会话对象 paytype: 负载类型(整数) 【返回值】:0表示成功,-1表示该负载类型未定义

    rtp_session_get_recv_payload_type 【原型】:int rtp_session_get_recv_payload_type(const RtpSession *session)  【功能】:获取当前的rtp数据流的媒体类型 【返回值】: 媒体类型(整数)

    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  :包含要发送数据的缓冲区 len    : 要发送的数据长度 userts  : 被发送数据的时间戳,具体内容请参考RFC协议 【返回值】: 成功发送的字节数

    rtp_session_recv_with_ts 【原型】:int rtp_session_recv_with_ts(RtpSession *session,uint8_t *buffer,int len,uint32_t ts,int *have_more) 【功能】:接收/读取发送端发来的rtp数据包 【参数】: session :已经创建的RTP会话对象 buffer  : 存放接收的rtp数据包的缓冲区 len    : 接收的数据长度 ts     : 指定的数据包时间戳,在第一次调用本函数时,建议从0开始。 have_more: 当参数中buffer缓冲区大小不足时,此标志置1,来提示调用者再次以同一时间戳获取剩余的数据。

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

    三、程序示例

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

    //    /// COPYRIGHT NOTICE     /// Copyright (c) 2009, 华中科技大学ticktick Group     /// All rights reserved.     ///     /// @file    ortpSend.c      /// @brief   ortpSend的测试    ///     /// 本文件示例使用ortp库进行rtp数据包的发送   ///     /// @version 1.0       /// @author  lujun     /// @date    2010/07/07     /// @E-mail  lujun.hust@gmail.com    ///     /// 修订说明:创建文件     //      #include <ortp/ortp.h>     #include <stdlib.h>     #ifndef _WIN32    #include <sys/types.h>   #include <sys/time.h>   #include <stdio.h>   #endif     // 每次发送的包的大小  160个字节   #define BYTES_PER_COUNT 160     // 时间戳   uint32_t g_user_ts=0;     /**  初始化   *      *   主要用于对ortp以及其它参数进行初始化    *   @param:  char * ipStr 目的端IP地址描述串    *   @param:  iint port 目的端RTP监听端口    *   @return:  RtpSession * 返回指向RtpSession对象的指针,如果为NULL,则初始化失败    *   @note:       */   RtpSession * rtpInit( char  * ipStr, int  port)   {        // Rtp会话对象       RtpSession *session;        char  *ssrc;          // 时间戳初始化       g_user_ts = 0;          // ortp的一些基本初始化操作       ortp_init();       ortp_scheduler_init();        // 创建新的rtp会话对象       session=rtp_session_new(RTP_SESSION_SENDONLY);                rtp_session_set_scheduling_mode(session,1);       rtp_session_set_blocking_mode(session,1);        // 设置远程RTP客户端的的IP和监听端口(即本rtp数据包的发送目的地址)       rtp_session_set_remote_addr(session,ipStr,port);        // 设置负载类型       rtp_session_set_payload_type(session,0);               // 获取同步源标识       ssrc=getenv( "SSRC" );        if  (ssrc!=NULL)        {               printf( "using SSRC=%i./n" ,atoi(ssrc));           rtp_session_set_ssrc(session,atoi(ssrc));       }          // 返回新的rtp会话对象        return  session;     }     /**  发送rtp数据包   *      *   主要用于发送rtp数据包    *   @param:  RtpSession *session RTP会话对象的指针    *   @param:  const char *buffer 要发送的数据的缓冲区地址     *   @param: int len 要发送的数据长度    *   @return:  int 实际发送的数据包数目    *   @note:     如果要发送的数据包长度大于BYTES_PER_COUNT,本函数内部会进行分包处理    */   int  rtpSend(RtpSession *session, const   char  *buffer,  int  len)   {        int  curOffset = 0;        int  sendBytes = 0;               // 是否全部发送完毕        while (curOffset < len )       {            // 如果长度小于一次发送的阈值,则一次性发送            if ( len < BYTES_PER_COUNT )           {               sendBytes = len;           }            // 如果剩余的数据长度大于阈值,则发送阈值长度的数据            else   if ( curOffset + BYTES_PER_COUNT <= len )           {               sendBytes = BYTES_PER_COUNT;           }            // 如果剩余的数据长度小于阈值,则把剩余的数据全部发送出去            else           {               sendBytes = len - (curOffset + BYTES_PER_COUNT);           }                       // 执行发送,获取实际发送的字节数           sendBytes = rtp_session_send_with_ts(session,( char  *)(buffer+curOffset),sendBytes,g_user_ts);              // 发送的偏移和时间戳向后移           curOffset += sendBytes;                            g_user_ts += sendBytes;              // 每发完6个阈值长度的时间,休息一会            if  (curOffset%(BYTES_PER_COUNT*6)==0)            {               usleep(10000);           }                  }          return  curOffset;   }     /**  结束ortp的发送,释放资源   *      *   @param:  RtpSession *session RTP会话对象的指针    *   @return:  0表示成功    *   @note:        */   int  rtpExit(RtpSession *session)   {       g_user_ts = 0;              rtp_session_destroy(session);       ortp_exit();       ortp_global_stats_display();          return  0;   }     // 主函数,进行测试   int  main()   {        // 待发送的数据缓冲区        char  * pBuffer =  "123445356234134234532523654323413453425236244123425234" ;       RtpSession * pRtpSession = NULL;        // 向(192.201.0.51,8000)目的地址发送rtp包       pRtpSession = rtpInit( "192.201.0.51" ,8000);        if (pRtpSession==NULL)       {           printf( "error rtpInit" );            return  0;       }               // 循环发送        while (1)       {            if ( rtpSend(pRtpSession,pBuffer,20) != 0)           {               printf( "error rtpInit" );                break ;           }                     usleep(10000);           printf( "sleep" );       }               // 退出       rtpExit(pRtpSession);               return  0;   }

    最新回复(0)