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