ortp库使用入门

我们知道， 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  [email protected]
///
/// 修订说明：创建文件
//////////////////////////////////////////////////////////////////////////

#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;
}