JRTP 编程模型

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() 方法来进行设置。