jrtplib3.11.1之 源码分析(二)：数据包

RTP 头部

• rtpstructs ： 数据结构体

struct RTPHeader
{
#ifdef RTP_BIG_ENDIAN
    uint8_t version:2;
    uint8_t padding:1;
    uint8_t extension:1;
    uint8_t csrccount:4;
    
    uint8_t marker:1;
    uint8_t payloadtype:7;
#else // little endian
    uint8_t csrccount:4;
    uint8_t extension:1;
    uint8_t padding:1;
    uint8_t version:2;
    
    uint8_t payloadtype:7;
    uint8_t marker:1;
#endif // RTP_BIG_ENDIAN
    
    uint16_t sequencenumber;
    uint32_t timestamp;
    uint32_t ssrc;
};

image.png

image.png

• V - Version. Identifies the RTP version.
  RTP版本号

• P - Padding. When set, the packet contains one or more additional padding octets at the end which are not part of the payload.
  是否填充，如果设置为允许填充的话，在包的末尾填充一个或多个字节，这些填充的字节不是有效负载的一部分。

• X - Extension bit. When set, the fixed header is followed by exactly one header extension, with a defined format.
  扩充位，如果设置为允许的话，固定头结构后面（即包的12个字节后面，有效负载的前面）紧跟着一个扩展头结构，该结构是已定义的一种格式

• CSRC count （CC） -Contains the number of CSRC identifiers that follow the fixed header.
  数据源的个数（即源的个数），如果只有一个源那么此时的值为0。

• M - Marker. The interpretation of the marker is defined by a profile. It is intended to allow significant events such as frame boundaries to be marked in the packet stream.
  标识，在文档中是这样定义的，它有意标识重要的事物比如：在流媒体中标识一帧数据的边界（结束或开始）。

• Payload type - Identifies the format of the RTP payload and determines its interpretation by the application. A profile specifies a default static mapping of payload type codes to payload formats. Additional payload type codes may be defined dynamically through non-RTP means.
  有效负载，RTP数据的有效负载（不包括头12个字节），由具体的应用程序来确定负载的格式和意义。官方文档里有表格说明，该表格显示了格式代码和具体格式的对应关系，附加的格式代码可能不在RTP协议里定义。

• Sequence number - Increments by one for each RTP data packet sent, and may be used by the receiver to detect packet loss and to restore packet sequence.
  数据包序号，发送的RTP数据包序号，接收端可用它来检查丢失的数据包和确定保存数据包次序。

• Timestamp - Reflects the sampling instant of the first octet in the RTP data packet. The sampling instant must be derived from a clock that increments monotonically and linearly in time to allow synchronization and jitter calculations.
  时间戳，纪录了RTP数据包中第一个字节的采样时间，采样时间必须源自一个时间增量且允许同步和计算。

• SSRC - Synchronization source. This identifier is chosen randomly, with the intent that no two synchronization sources within the same RTP session will have the same SSRC identifier.
  同步标识，是一个随机数，在同一个RTP会话中只有一个同步标识。

• CSRC - Contributing source identifiers list. Identifies the contributing sources for the payload contained in this packet.
  数据源标识，保存着数据源的列表，在RTP里的每个包里都包含了对应数据源的ID。

• RTPExtensionHeader X - Extension bit

struct RTPExtensionHeader
{
    uint16_t extid;
    uint16_t length;
};

• RTCPCommonHeader RTCP通用头部

struct RTCPCommonHeader
{
#ifdef RTP_BIG_ENDIAN
    uint8_t version:2;
    uint8_t padding:1;
    uint8_t count:5;
#else // little endian
    uint8_t count:5;
    uint8_t padding:1;
    uint8_t version:2;
#endif // RTP_BIG_ENDIAN

    uint8_t packettype;
    uint16_t length;
};

RTP包

• rtprawpacket ： 用来存储RTP和RTCP数据

  1. 数据指针 packetdata
  2. 数据长度 packetdatalength
  3. 接收时间 receivetime
  4. 网络地址 senderaddress
  5. 是否是rtp数据包 isrtp

• rtppacket ：用于解析RTPRawPacket的实例，可以得到rtp header 信息。该类也可以根据指定的参数来创建一个新的RTP数据包。

• rtppacketbuilder ：这个类可以用来建立RTP包，比RTPPacket类高一级，它会产生一个SSRC标识符，跟踪时间戳和序列号等， 打成一组包。

RTCP 实时传输控制协议类

RTCP 控制协议需要与RTP数据协议一起配合使用，当应用程序启动一个RTP会话时将同时占用两个端口，分别供RTP和RTCP使用。RTP本身并不能为按序传输数据包 提供可靠的保证，也不提供流量控制和拥塞控制，这些都由RTCP来负责完成。通常RTCP会采用与RTP相同的分发机制，向会话中的所有成员周期性地发送控制信息，应用程序通过接收这些数据，从中获取会话参与者的相关资料，以及网络状况、分组丢失概率等反馈信息，从而能够对服务质量进行控制或者对网络状况进行诊断。

RTCP协议的功能是通过不同的RTCP数据报来实现的，主要有如下几种类型：

• SR 发送端报告：所谓发送端是指发出RTP数据报的应用程序或者终端，发送端同时也可以是接收端。
• RR 接收端报告：所谓接收端是指仅接收但不发送RTP数据报的应用程序或者终端。
• SDES 源描述：主要功能是作为会话成员有关标识信息的载体，如用户名、邮件地址、电话号码等，此外还具有向会话成员传达会话控制信息的功能。
• BYE 通知离开：主要功能是指示某一个或者几个源不再有效，即通知会话中的其他成员自己将退出会话。
• APP 由应用程序自己定义：解决了RTCP的扩展性问题，并且为协议的实现者提供了很大的灵活性。

RTCP数据报携带有服务质量监控的必要信息，能够对服务质量进行动态的调整，并能够对网络拥塞进行有效的控制。由于RTCP数据报采用的是多播方式，因此会话中的所有成员都可以通过RTCP数据报返回的控制信息，来了解其他参与者的当前情况。

在一个典型的应用场合下，发送媒体流的应用程序将周期性地产生发送端报告SR，该RTCP数据报含有不同媒体流间的同步信息，以及已经发送的数据报和字节的计数，接收端根据这些信息可以估计出实际的数据传输速率。另一方面，接收端会向所有已知的发送端发送接收端报告RR，该RTCP数据报含有已接收数据报的最大序列号、丢失的数据报数目、延时抖动和时间戳等重要信息，发送端应用根据这些信息可以估计出往返时延，并且可以根据数据报丢失概率和时延抖动情况动态调整发送速率，以改善网络拥塞状况，或者根据网络状况平滑地调整应用程序的服务质量。

• rtcppacket： RTCP包的特定类型的基类。 数据指针 数据长度 数据类型

    enum PacketType  //类型
    { 
            SR,         /* RTCP sender report. */
            RR,         /* RTCP receiver report. */
            SDES,    /* RTCP source description packet. */
            BYE,       /* RTCP bye packet. */
            APP,       /* RTCP packet containing application specific data. */
            Unknown    /*The type of RTCP packet was not recognized. */
    };

• rtcpcompoundpacket ： 表示一个RTCP复合包 是由一系列的 RTCPCommonHeader + rtcp数据包组成 （SR， RR，....）， 解析接收到数据 把rtcp数据包添加到rtcppacklist链表中 可以循环遍历。

• RTCPAPPPacket ： RTCP APP packet

• RTCPBytePacket ： RTCP Byte packet

• RTCPRRPacket： RTCP receiver report packet

• RTCPSRPacket： RTCP sender report packet

• RTCPSDESPacket： RTCP source description packet

• RTCPUnknownpacket：RTCP packet of unknown type

继承RTPSession类，然后可以通过实现OnRTCPCompoundPacket来获取相关的RTCP反馈。

LIBRTP内部使用的结构体

• RTCPSenderReport 结构体

struct RTCPSenderReport
{
    uint32_t ntptime_msw;
    uint32_t ntptime_lsw;
    uint32_t rtptimestamp;
    uint32_t packetcount;
    uint32_t octetcount;
};

• RTCPReceiverReport

struct RTCPReceiverReport
{
    uint32_t ssrc; // Identifies about which SSRC's data this report is...
    uint8_t fractionlost;
    uint8_t packetslost[3];
    uint32_t exthighseqnr;
    uint32_t jitter;
    uint32_t lsr;
    uint32_t dlsr;
};

• RTCPSDESHeader

struct RTCPSDESHeader
{
    uint8_t sdesid;
    uint8_t length;
};