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