基于JRTPLIB库的RTP数据传输设计文档(2)

1)        初始化
在使用 JRTPLIB 进行实时流媒体数据传输之前,首先应该生成 RTPSession 类的一个实例来表示此次 RTP 会话,然后调用 Create() 方法来对其进行初始化操作。 RTPSession 类的 Create() 方法只有一个参数,用来指明此次 RTP 会话所采用的端口号。
2)        数据发送
RTP 会话成功建立起来之后,接下来就可以开始进行流媒体数据的实时传输了。首先需要设置好数据发送的目标地址, RTP 协议允许同一会话存在多个目标地址,这可以通过调用 RTPSession 类的 AddDestination() DeleteDestination() ClearDestinations() 方法来完成。目标地址全部指定之后,接着就可以调用 RTPSession 类的 SendPacket() 方法,向所有的目标地址发送流媒体数据。 SendPacket() 最典型的用法是类似于下面的语句,其中第一个参数是要被发送的数据,而第二个参数则指明将要发送数据的长度,再往后依次是RTP 负载类型、标识和时戳增量。
sess.SendPacket(buffer, 5, 0, false, 10);
对于同一个RTP 会话来讲,负载类型、标识和时戳增量通常来讲都是相同的,JRTPLIB 允许将它们设置为会话的默认参数,这是通过调用 RTPSession 类的SetDefaultPayloadType() SetDefaultMark() SetDefaultTimeStampIncrement() 方法来完成的。为RTP 会话设置这些默认参数的好处是可以简化数据的发送,例如,如果为 RTP 会话设置了默认参数:
sess.SetDefaultPayloadType(0);
sess.SetDefaultMark(false);
sess.SetDefaultTimeStampIncrement(10);
之后在进行数据发送时只需指明要发送的数据及其长度就可以了:
sess.SendPacket(buffer, 5);
3)        数据接收
对于流媒体数据的接收端,首先需要调用 PollData() 方法来接收发送过来的 RTP 或者 RTCP 数据报。由于同一个 RTP 会话中允许有多个参与者(源),因此既可以通过调用 GotoFirstSource() GotoNextSource() 方法来遍历所有的源,也可以通过调用 GotoFisstSourceWithDat() GotoNextSourceWithData() 方法来遍历那些携带有数据的源。在从 RTP 会话中检测出有效的数据源之后,接下去就可以调用 RTPSession 类的 GetNextPacket() 方法从中抽取 RTP 数据报,当接收到的 RTP 数据报处理完之后,要及时释放。下面的代码示范了该如何对接收到的 RTP 数据报进行处理:

do{
    sess.BeginDataAccess();
           if (sess.GotoFirstSourceWithData())
           {
                    do
                    {
                             RTPPacket *pack;
                             uint8_t *data;
                             size_t length;
                             if((outfile=open("/mnt/hgfs/download/temp1.YUV",O_WRONLY | O_CREAT | O_APPEND))<0)
                             {
                                       perror("open outfile error");
                                       return -1;
                             }
                             while ((pack = sess.GetNextPacket()) != NULL)
                             {
                                       data=pack->GetPayloadData();
                                       length=pack->GetPayloadLength();
                                       if((write(outfile,data,length))<0)// 将接收到的图片信息写入文中。
                                       {
                                                perror("write outfile error;");
                                                return -1;
                                       }
                                       sess.DeletePacket(pack);
                             }
                    } while (sess.GotoNextSourceWithData());
           }
           sess.EndDataAccess();
           close(outfile);
JRTPLIB RTP 数据报定义了 3 种接收模块,通过调用 RTPSession 类的 SetReceiveMode() 方法可以设置下列这些接收模式:
RECEIVEMODE_ALL :缺省的接收模式,所有到达的 RTP 数据报都将被接受;
RECEIVEMODE_IGNORESOME :除了某些特定的发送者之外,所有到达的 RTP 数据报都将被接受,而被拒绝的发送者列表可以通过调用 AddToIgnoreList() DeleteFromIgnoreList() ClearIgnoreList() 方法来进行设置;
   
  RECEIVEMODE_ACCEPTSOME :除了某些特定的发送者之外,所有到达的 RTP 数据报都将被拒绝,而被接受的发送者列表可以通过调用 AddToAcceptList() DeleteFromAcceptList ClearAcceptList() 方法来进行设置

你可能感兴趣的:(文档,设计,数据传输,休闲,RTP)