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

你可能感兴趣的:(编程)