| /* |
| * Copyright (c) 2014 The WebRTC project authors. All Rights Reserved. |
| * |
| * Use of this source code is governed by a BSD-style license |
| * that can be found in the LICENSE file in the root of the source |
| * tree. An additional intellectual property rights grant can be found |
| * in the file PATENTS. All contributing project authors may |
| * be found in the AUTHORS file in the root of the source tree. |
| * |
| */ |
| |
| #ifndef WEBRTC_MODULES_RTP_RTCP_SOURCE_RTCP_PACKET_H_ |
| #define WEBRTC_MODULES_RTP_RTCP_SOURCE_RTCP_PACKET_H_ |
| |
| #include <map> |
| #include <string> |
| #include <vector> |
| |
| #include "webrtc/base/scoped_ptr.h" |
| #include "webrtc/modules/rtp_rtcp/source/rtcp_packet/report_block.h" |
| #include "webrtc/modules/rtp_rtcp/source/rtcp_packet/rrtr.h" |
| #include "webrtc/modules/rtp_rtcp/source/rtcp_utility.h" |
| #include "webrtc/modules/rtp_rtcp/include/rtp_rtcp_defines.h" |
| #include "webrtc/typedefs.h" |
| |
| namespace webrtc { |
| namespace rtcp { |
| |
| static const int kCommonFbFmtLength = 12; |
| static const int kReportBlockLength = 24; |
| |
| class Dlrr; |
| class RawPacket; |
| class VoipMetric; |
| |
| // Class for building RTCP packets. |
| // |
| // Example: |
| // ReportBlock report_block; |
| // report_block.To(234) |
| // report_block.FractionLost(10); |
| // |
| // ReceiverReport rr; |
| // rr.From(123); |
| // rr.WithReportBlock(&report_block) |
| // |
| // Fir fir; |
| // fir.From(123); |
| // fir.To(234) |
| // fir.WithCommandSeqNum(123); |
| // |
| // size_t length = 0; // Builds an intra frame request |
| // uint8_t packet[kPacketSize]; // with sequence number 123. |
| // fir.Build(packet, &length, kPacketSize); |
| // |
| // RawPacket packet = fir.Build(); // Returns a RawPacket holding |
| // // the built rtcp packet. |
| // |
| // rr.Append(&fir) // Builds a compound RTCP packet with |
| // RawPacket packet = rr.Build(); // a receiver report, report block |
| // // and fir message. |
| |
| class RtcpPacket { |
| public: |
| virtual ~RtcpPacket() {} |
| |
| void Append(RtcpPacket* packet); |
| |
| // Callback used to signal that an RTCP packet is ready. Note that this may |
| // not contain all data in this RtcpPacket; if a packet cannot fit in |
| // max_length bytes, it will be fragmented and multiple calls to this |
| // callback will be made. |
| class PacketReadyCallback { |
| public: |
| PacketReadyCallback() {} |
| virtual ~PacketReadyCallback() {} |
| |
| virtual void OnPacketReady(uint8_t* data, size_t length) = 0; |
| }; |
| |
| // Convenience method mostly used for test. Max length of IP_PACKET_SIZE is |
| // used, will cause assertion error if fragmentation occurs. |
| rtc::scoped_ptr<RawPacket> Build() const; |
| |
| // Returns true if all calls to Create succeeded. A buffer of size |
| // IP_PACKET_SIZE will be allocated and reused between calls to callback. |
| bool Build(PacketReadyCallback* callback) const; |
| |
| // Returns true if all calls to Create succeeded. Provided buffer reference |
| // will be used for all calls to callback. |
| bool BuildExternalBuffer(uint8_t* buffer, |
| size_t max_length, |
| PacketReadyCallback* callback) const; |
| |
| // Size of this packet in bytes (including headers, excluding nested packets). |
| virtual size_t BlockLength() const = 0; |
| |
| protected: |
| RtcpPacket() {} |
| |
| virtual bool Create(uint8_t* packet, |
| size_t* index, |
| size_t max_length, |
| PacketReadyCallback* callback) const = 0; |
| |
| static void CreateHeader(uint8_t count_or_format, |
| uint8_t packet_type, |
| size_t block_length, // Size in 32bit words - 1. |
| uint8_t* buffer, |
| size_t* pos); |
| |
| bool OnBufferFull(uint8_t* packet, |
| size_t* index, |
| RtcpPacket::PacketReadyCallback* callback) const; |
| |
| size_t HeaderLength() const; |
| |
| static const size_t kHeaderLength = 4; |
| std::vector<RtcpPacket*> appended_packets_; |
| |
| private: |
| bool CreateAndAddAppended(uint8_t* packet, |
| size_t* index, |
| size_t max_length, |
| PacketReadyCallback* callback) const; |
| }; |
| |
| // TODO(sprang): Move RtcpPacket subclasses out to separate files. |
| |
| class Empty : public RtcpPacket { |
| public: |
| Empty() : RtcpPacket() {} |
| |
| virtual ~Empty() {} |
| |
| protected: |
| bool Create(uint8_t* packet, |
| size_t* index, |
| size_t max_length, |
| RtcpPacket::PacketReadyCallback* callback) const override; |
| |
| size_t BlockLength() const override; |
| |
| private: |
| RTC_DISALLOW_COPY_AND_ASSIGN(Empty); |
| }; |
| |
| // RTCP sender report (RFC 3550). |
| // |
| // 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 |
| // +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |
| // |V=2|P| RC | PT=SR=200 | length | |
| // +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |
| // | SSRC of sender | |
| // +=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+ |
| // | NTP timestamp, most significant word | |
| // +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |
| // | NTP timestamp, least significant word | |
| // +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |
| // | RTP timestamp | |
| // +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |
| // | sender's packet count | |
| // +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |
| // | sender's octet count | |
| // +=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+ |
| // | report block(s) | |
| // | .... | |
| |
| class SenderReport : public RtcpPacket { |
| public: |
| SenderReport() : RtcpPacket() { |
| memset(&sr_, 0, sizeof(sr_)); |
| } |
| |
| virtual ~SenderReport() {} |
| |
| void From(uint32_t ssrc) { |
| sr_.SenderSSRC = ssrc; |
| } |
| void WithNtpSec(uint32_t sec) { |
| sr_.NTPMostSignificant = sec; |
| } |
| void WithNtpFrac(uint32_t frac) { |
| sr_.NTPLeastSignificant = frac; |
| } |
| void WithRtpTimestamp(uint32_t rtp_timestamp) { |
| sr_.RTPTimestamp = rtp_timestamp; |
| } |
| void WithPacketCount(uint32_t packet_count) { |
| sr_.SenderPacketCount = packet_count; |
| } |
| void WithOctetCount(uint32_t octet_count) { |
| sr_.SenderOctetCount = octet_count; |
| } |
| bool WithReportBlock(const ReportBlock& block); |
| |
| protected: |
| bool Create(uint8_t* packet, |
| size_t* index, |
| size_t max_length, |
| RtcpPacket::PacketReadyCallback* callback) const override; |
| |
| private: |
| static const int kMaxNumberOfReportBlocks = 0x1f; |
| |
| size_t BlockLength() const { |
| const size_t kSrHeaderLength = 8; |
| const size_t kSenderInfoLength = 20; |
| return kSrHeaderLength + kSenderInfoLength + |
| report_blocks_.size() * kReportBlockLength; |
| } |
| |
| RTCPUtility::RTCPPacketSR sr_; |
| std::vector<ReportBlock> report_blocks_; |
| |
| RTC_DISALLOW_COPY_AND_ASSIGN(SenderReport); |
| }; |
| |
| // Source Description (SDES) (RFC 3550). |
| // |
| // 0 1 2 3 |
| // 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 |
| // +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |
| // header |V=2|P| SC | PT=SDES=202 | length | |
| // +=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+ |
| // chunk | SSRC/CSRC_1 | |
| // 1 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |
| // | SDES items | |
| // | ... | |
| // +=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+ |
| // chunk | SSRC/CSRC_2 | |
| // 2 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |
| // | SDES items | |
| // | ... | |
| // +=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+ |
| // |
| // Canonical End-Point Identifier SDES Item (CNAME) |
| // |
| // 0 1 2 3 |
| // 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 |
| // +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |
| // | CNAME=1 | length | user and domain name ... |
| // +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |
| |
| class Sdes : public RtcpPacket { |
| public: |
| Sdes() : RtcpPacket() {} |
| |
| virtual ~Sdes() {} |
| |
| bool WithCName(uint32_t ssrc, const std::string& cname); |
| |
| struct Chunk { |
| uint32_t ssrc; |
| std::string name; |
| int null_octets; |
| }; |
| |
| protected: |
| bool Create(uint8_t* packet, |
| size_t* index, |
| size_t max_length, |
| RtcpPacket::PacketReadyCallback* callback) const override; |
| |
| private: |
| static const int kMaxNumberOfChunks = 0x1f; |
| |
| size_t BlockLength() const; |
| |
| std::vector<Chunk> chunks_; |
| |
| RTC_DISALLOW_COPY_AND_ASSIGN(Sdes); |
| }; |
| |
| // Slice loss indication (SLI) (RFC 4585). |
| // |
| // FCI: |
| // 0 1 2 3 |
| // 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 |
| // +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |
| // | First | Number | PictureID | |
| // +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |
| |
| class Sli : public RtcpPacket { |
| public: |
| Sli() : RtcpPacket() { |
| memset(&sli_, 0, sizeof(sli_)); |
| memset(&sli_item_, 0, sizeof(sli_item_)); |
| } |
| |
| virtual ~Sli() {} |
| |
| void From(uint32_t ssrc) { |
| sli_.SenderSSRC = ssrc; |
| } |
| void To(uint32_t ssrc) { |
| sli_.MediaSSRC = ssrc; |
| } |
| void WithFirstMb(uint16_t first_mb) { |
| assert(first_mb <= 0x1fff); |
| sli_item_.FirstMB = first_mb; |
| } |
| void WithNumberOfMb(uint16_t number_mb) { |
| assert(number_mb <= 0x1fff); |
| sli_item_.NumberOfMB = number_mb; |
| } |
| void WithPictureId(uint8_t picture_id) { |
| assert(picture_id <= 0x3f); |
| sli_item_.PictureId = picture_id; |
| } |
| |
| protected: |
| bool Create(uint8_t* packet, |
| size_t* index, |
| size_t max_length, |
| RtcpPacket::PacketReadyCallback* callback) const override; |
| |
| private: |
| size_t BlockLength() const { |
| const size_t kFciLength = 4; |
| return kCommonFbFmtLength + kFciLength; |
| } |
| |
| RTCPUtility::RTCPPacketPSFBSLI sli_; |
| RTCPUtility::RTCPPacketPSFBSLIItem sli_item_; |
| |
| RTC_DISALLOW_COPY_AND_ASSIGN(Sli); |
| }; |
| |
| // Generic NACK (RFC 4585). |
| // |
| // FCI: |
| // 0 1 2 3 |
| // 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 |
| // +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |
| // | PID | BLP | |
| // +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |
| |
| class Nack : public RtcpPacket { |
| public: |
| Nack() : RtcpPacket() { |
| memset(&nack_, 0, sizeof(nack_)); |
| } |
| |
| virtual ~Nack() {} |
| |
| void From(uint32_t ssrc) { |
| nack_.SenderSSRC = ssrc; |
| } |
| void To(uint32_t ssrc) { |
| nack_.MediaSSRC = ssrc; |
| } |
| void WithList(const uint16_t* nack_list, int length); |
| |
| protected: |
| bool Create(uint8_t* packet, |
| size_t* index, |
| size_t max_length, |
| RtcpPacket::PacketReadyCallback* callback) const override; |
| |
| size_t BlockLength() const override; |
| |
| private: |
| |
| RTCPUtility::RTCPPacketRTPFBNACK nack_; |
| std::vector<RTCPUtility::RTCPPacketRTPFBNACKItem> nack_fields_; |
| |
| RTC_DISALLOW_COPY_AND_ASSIGN(Nack); |
| }; |
| |
| // Reference picture selection indication (RPSI) (RFC 4585). |
| // |
| // FCI: |
| // |
| // 0 1 2 3 |
| // 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 |
| // +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |
| // | PB |0| Payload Type| Native RPSI bit string | |
| // +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |
| // | defined per codec ... | Padding (0) | |
| // +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |
| |
| class Rpsi : public RtcpPacket { |
| public: |
| Rpsi() |
| : RtcpPacket(), |
| padding_bytes_(0) { |
| memset(&rpsi_, 0, sizeof(rpsi_)); |
| } |
| |
| virtual ~Rpsi() {} |
| |
| void From(uint32_t ssrc) { |
| rpsi_.SenderSSRC = ssrc; |
| } |
| void To(uint32_t ssrc) { |
| rpsi_.MediaSSRC = ssrc; |
| } |
| void WithPayloadType(uint8_t payload) { |
| assert(payload <= 0x7f); |
| rpsi_.PayloadType = payload; |
| } |
| void WithPictureId(uint64_t picture_id); |
| |
| protected: |
| bool Create(uint8_t* packet, |
| size_t* index, |
| size_t max_length, |
| RtcpPacket::PacketReadyCallback* callback) const override; |
| |
| private: |
| size_t BlockLength() const { |
| size_t fci_length = 2 + (rpsi_.NumberOfValidBits / 8) + padding_bytes_; |
| return kCommonFbFmtLength + fci_length; |
| } |
| |
| uint8_t padding_bytes_; |
| RTCPUtility::RTCPPacketPSFBRPSI rpsi_; |
| |
| RTC_DISALLOW_COPY_AND_ASSIGN(Rpsi); |
| }; |
| |
| // Full intra request (FIR) (RFC 5104). |
| // |
| // FCI: |
| // |
| // 0 1 2 3 |
| // 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 |
| // +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |
| // | SSRC | |
| // +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |
| // | Seq nr. | Reserved | |
| // +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |
| |
| class Fir : public RtcpPacket { |
| public: |
| Fir() : RtcpPacket() { |
| memset(&fir_, 0, sizeof(fir_)); |
| memset(&fir_item_, 0, sizeof(fir_item_)); |
| } |
| |
| virtual ~Fir() {} |
| |
| void From(uint32_t ssrc) { |
| fir_.SenderSSRC = ssrc; |
| } |
| void To(uint32_t ssrc) { |
| fir_item_.SSRC = ssrc; |
| } |
| void WithCommandSeqNum(uint8_t seq_num) { |
| fir_item_.CommandSequenceNumber = seq_num; |
| } |
| |
| protected: |
| bool Create(uint8_t* packet, |
| size_t* index, |
| size_t max_length, |
| RtcpPacket::PacketReadyCallback* callback) const override; |
| |
| private: |
| size_t BlockLength() const { |
| const size_t kFciLength = 8; |
| return kCommonFbFmtLength + kFciLength; |
| } |
| |
| RTCPUtility::RTCPPacketPSFBFIR fir_; |
| RTCPUtility::RTCPPacketPSFBFIRItem fir_item_; |
| }; |
| |
| // Temporary Maximum Media Stream Bit Rate Request (TMMBR) (RFC 5104). |
| // |
| // FCI: |
| // |
| // 0 1 2 3 |
| // 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 |
| // +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |
| // | SSRC | |
| // +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |
| // | MxTBR Exp | MxTBR Mantissa |Measured Overhead| |
| // +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |
| |
| class Tmmbr : public RtcpPacket { |
| public: |
| Tmmbr() : RtcpPacket() { |
| memset(&tmmbr_, 0, sizeof(tmmbr_)); |
| memset(&tmmbr_item_, 0, sizeof(tmmbr_item_)); |
| } |
| |
| virtual ~Tmmbr() {} |
| |
| void From(uint32_t ssrc) { |
| tmmbr_.SenderSSRC = ssrc; |
| } |
| void To(uint32_t ssrc) { |
| tmmbr_item_.SSRC = ssrc; |
| } |
| void WithBitrateKbps(uint32_t bitrate_kbps) { |
| tmmbr_item_.MaxTotalMediaBitRate = bitrate_kbps; |
| } |
| void WithOverhead(uint16_t overhead) { |
| assert(overhead <= 0x1ff); |
| tmmbr_item_.MeasuredOverhead = overhead; |
| } |
| |
| protected: |
| bool Create(uint8_t* packet, |
| size_t* index, |
| size_t max_length, |
| RtcpPacket::PacketReadyCallback* callback) const override; |
| |
| private: |
| size_t BlockLength() const { |
| const size_t kFciLen = 8; |
| return kCommonFbFmtLength + kFciLen; |
| } |
| |
| RTCPUtility::RTCPPacketRTPFBTMMBR tmmbr_; |
| RTCPUtility::RTCPPacketRTPFBTMMBRItem tmmbr_item_; |
| |
| RTC_DISALLOW_COPY_AND_ASSIGN(Tmmbr); |
| }; |
| |
| // Temporary Maximum Media Stream Bit Rate Notification (TMMBN) (RFC 5104). |
| // |
| // FCI: |
| // |
| // 0 1 2 3 |
| // 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 |
| // +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |
| // | SSRC | |
| // +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |
| // | MxTBR Exp | MxTBR Mantissa |Measured Overhead| |
| // +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |
| |
| class Tmmbn : public RtcpPacket { |
| public: |
| Tmmbn() : RtcpPacket() { |
| memset(&tmmbn_, 0, sizeof(tmmbn_)); |
| } |
| |
| virtual ~Tmmbn() {} |
| |
| void From(uint32_t ssrc) { |
| tmmbn_.SenderSSRC = ssrc; |
| } |
| // Max 50 TMMBR can be added per TMMBN. |
| bool WithTmmbr(uint32_t ssrc, uint32_t bitrate_kbps, uint16_t overhead); |
| |
| protected: |
| bool Create(uint8_t* packet, |
| size_t* index, |
| size_t max_length, |
| RtcpPacket::PacketReadyCallback* callback) const override; |
| |
| private: |
| static const int kMaxNumberOfTmmbrs = 50; |
| |
| size_t BlockLength() const { |
| const size_t kFciLen = 8; |
| return kCommonFbFmtLength + kFciLen * tmmbn_items_.size(); |
| } |
| |
| RTCPUtility::RTCPPacketRTPFBTMMBN tmmbn_; |
| std::vector<RTCPUtility::RTCPPacketRTPFBTMMBRItem> tmmbn_items_; |
| |
| RTC_DISALLOW_COPY_AND_ASSIGN(Tmmbn); |
| }; |
| |
| // Receiver Estimated Max Bitrate (REMB) (draft-alvestrand-rmcat-remb). |
| // |
| // 0 1 2 3 |
| // 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 |
| // +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |
| // |V=2|P| FMT=15 | PT=206 | length | |
| // +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |
| // | SSRC of packet sender | |
| // +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |
| // | SSRC of media source | |
| // +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |
| // | Unique identifier 'R' 'E' 'M' 'B' | |
| // +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |
| // | Num SSRC | BR Exp | BR Mantissa | |
| // +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |
| // | SSRC feedback | |
| // +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |
| // | ... |
| |
| class Remb : public RtcpPacket { |
| public: |
| Remb() : RtcpPacket() { |
| memset(&remb_, 0, sizeof(remb_)); |
| memset(&remb_item_, 0, sizeof(remb_item_)); |
| } |
| |
| virtual ~Remb() {} |
| |
| void From(uint32_t ssrc) { |
| remb_.SenderSSRC = ssrc; |
| } |
| void AppliesTo(uint32_t ssrc); |
| |
| void WithBitrateBps(uint32_t bitrate_bps) { |
| remb_item_.BitRate = bitrate_bps; |
| } |
| |
| protected: |
| bool Create(uint8_t* packet, |
| size_t* index, |
| size_t max_length, |
| RtcpPacket::PacketReadyCallback* callback) const override; |
| |
| private: |
| static const int kMaxNumberOfSsrcs = 0xff; |
| |
| size_t BlockLength() const { |
| return (remb_item_.NumberOfSSRCs + 5) * 4; |
| } |
| |
| RTCPUtility::RTCPPacketPSFBAPP remb_; |
| RTCPUtility::RTCPPacketPSFBREMBItem remb_item_; |
| |
| RTC_DISALLOW_COPY_AND_ASSIGN(Remb); |
| }; |
| |
| // From RFC 3611: RTP Control Protocol Extended Reports (RTCP XR). |
| // |
| // Format for XR packets: |
| // |
| // 0 1 2 3 |
| // 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 |
| // +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |
| // |V=2|P|reserved | PT=XR=207 | length | |
| // +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |
| // | SSRC | |
| // +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |
| // : report blocks : |
| // +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |
| |
| class Xr : public RtcpPacket { |
| public: |
| typedef std::vector<RTCPUtility::RTCPPacketXRDLRRReportBlockItem> DlrrBlock; |
| Xr() : RtcpPacket() { |
| memset(&xr_header_, 0, sizeof(xr_header_)); |
| } |
| |
| virtual ~Xr() {} |
| |
| void From(uint32_t ssrc) { |
| xr_header_.OriginatorSSRC = ssrc; |
| } |
| |
| // Max 50 items of each of {Rrtr, Dlrr, VoipMetric} allowed per Xr. |
| bool WithRrtr(Rrtr* rrtr); |
| bool WithDlrr(Dlrr* dlrr); |
| bool WithVoipMetric(VoipMetric* voip_metric); |
| |
| protected: |
| bool Create(uint8_t* packet, |
| size_t* index, |
| size_t max_length, |
| RtcpPacket::PacketReadyCallback* callback) const override; |
| |
| private: |
| static const int kMaxNumberOfRrtrBlocks = 50; |
| static const int kMaxNumberOfDlrrBlocks = 50; |
| static const int kMaxNumberOfVoipMetricBlocks = 50; |
| |
| size_t BlockLength() const { |
| const size_t kXrHeaderLength = 8; |
| return kXrHeaderLength + RrtrLength() + DlrrLength() + VoipMetricLength(); |
| } |
| |
| size_t RrtrLength() const { return Rrtr::kLength * rrtr_blocks_.size(); } |
| |
| size_t DlrrLength() const; |
| |
| size_t VoipMetricLength() const { |
| const size_t kVoipMetricBlockLength = 36; |
| return kVoipMetricBlockLength * voip_metric_blocks_.size(); |
| } |
| |
| RTCPUtility::RTCPPacketXR xr_header_; |
| std::vector<Rrtr> rrtr_blocks_; |
| std::vector<DlrrBlock> dlrr_blocks_; |
| std::vector<RTCPUtility::RTCPPacketXRVOIPMetricItem> voip_metric_blocks_; |
| |
| RTC_DISALLOW_COPY_AND_ASSIGN(Xr); |
| }; |
| |
| // DLRR Report Block (RFC 3611). |
| // |
| // 0 1 2 3 |
| // 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 |
| // +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |
| // | BT=5 | reserved | block length | |
| // +=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+ |
| // | SSRC_1 (SSRC of first receiver) | sub- |
| // +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ block |
| // | last RR (LRR) | 1 |
| // +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |
| // | delay since last RR (DLRR) | |
| // +=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+ |
| // | SSRC_2 (SSRC of second receiver) | sub- |
| // +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ block |
| // : ... : 2 |
| |
| class Dlrr { |
| public: |
| Dlrr() {} |
| ~Dlrr() {} |
| |
| // Max 100 DLRR Items can be added per DLRR report block. |
| bool WithDlrrItem(uint32_t ssrc, uint32_t last_rr, uint32_t delay_last_rr); |
| |
| private: |
| friend class Xr; |
| static const int kMaxNumberOfDlrrItems = 100; |
| |
| std::vector<RTCPUtility::RTCPPacketXRDLRRReportBlockItem> dlrr_block_; |
| |
| RTC_DISALLOW_COPY_AND_ASSIGN(Dlrr); |
| }; |
| |
| // VoIP Metrics Report Block (RFC 3611). |
| // |
| // 0 1 2 3 |
| // 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 |
| // +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |
| // | BT=7 | reserved | block length = 8 | |
| // +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |
| // | SSRC of source | |
| // +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |
| // | loss rate | discard rate | burst density | gap density | |
| // +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |
| // | burst duration | gap duration | |
| // +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |
| // | round trip delay | end system delay | |
| // +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |
| // | signal level | noise level | RERL | Gmin | |
| // +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |
| // | R factor | ext. R factor | MOS-LQ | MOS-CQ | |
| // +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |
| // | RX config | reserved | JB nominal | |
| // +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |
| // | JB maximum | JB abs max | |
| // +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |
| |
| class VoipMetric { |
| public: |
| VoipMetric() { |
| memset(&metric_, 0, sizeof(metric_)); |
| } |
| ~VoipMetric() {} |
| |
| void To(uint32_t ssrc) { metric_.SSRC = ssrc; } |
| void LossRate(uint8_t loss_rate) { metric_.lossRate = loss_rate; } |
| void DiscardRate(uint8_t discard_rate) { metric_.discardRate = discard_rate; } |
| void BurstDensity(uint8_t burst_density) { |
| metric_.burstDensity = burst_density; |
| } |
| void GapDensity(uint8_t gap_density) { metric_.gapDensity = gap_density; } |
| void BurstDuration(uint16_t burst_duration) { |
| metric_.burstDuration = burst_duration; |
| } |
| void GapDuration(uint16_t gap_duration) { |
| metric_.gapDuration = gap_duration; |
| } |
| void RoundTripDelay(uint16_t round_trip_delay) { |
| metric_.roundTripDelay = round_trip_delay; |
| } |
| void EndSystemDelay(uint16_t end_system_delay) { |
| metric_.endSystemDelay = end_system_delay; |
| } |
| void SignalLevel(uint8_t signal_level) { metric_.signalLevel = signal_level; } |
| void NoiseLevel(uint8_t noise_level) { metric_.noiseLevel = noise_level; } |
| void Rerl(uint8_t rerl) { metric_.RERL = rerl; } |
| void Gmin(uint8_t gmin) { metric_.Gmin = gmin; } |
| void Rfactor(uint8_t rfactor) { metric_.Rfactor = rfactor; } |
| void ExtRfactor(uint8_t extrfactor) { metric_.extRfactor = extrfactor; } |
| void MosLq(uint8_t moslq) { metric_.MOSLQ = moslq; } |
| void MosCq(uint8_t moscq) { metric_.MOSCQ = moscq; } |
| void RxConfig(uint8_t rxconfig) { metric_.RXconfig = rxconfig; } |
| void JbNominal(uint16_t jbnominal) { metric_.JBnominal = jbnominal; } |
| void JbMax(uint16_t jbmax) { metric_.JBmax = jbmax; } |
| void JbAbsMax(uint16_t jbabsmax) { metric_.JBabsMax = jbabsmax; } |
| |
| private: |
| friend class Xr; |
| RTCPUtility::RTCPPacketXRVOIPMetricItem metric_; |
| |
| RTC_DISALLOW_COPY_AND_ASSIGN(VoipMetric); |
| }; |
| |
| // Class holding a RTCP packet. |
| // |
| // Takes a built rtcp packet. |
| // RawPacket raw_packet(buffer, length); |
| // |
| // To access the raw packet: |
| // raw_packet.Buffer(); - pointer to the raw packet |
| // raw_packet.BufferLength(); - the length of the raw packet |
| |
| class RawPacket { |
| public: |
| explicit RawPacket(size_t buffer_length); |
| RawPacket(const uint8_t* packet, size_t packet_length); |
| |
| const uint8_t* Buffer() const; |
| uint8_t* MutableBuffer(); |
| size_t BufferLength() const; |
| size_t Length() const; |
| void SetLength(size_t length); |
| |
| private: |
| const size_t buffer_length_; |
| size_t length_; |
| rtc::scoped_ptr<uint8_t[]> buffer_; |
| }; |
| |
| } // namespace rtcp |
| } // namespace webrtc |
| #endif // WEBRTC_MODULES_RTP_RTCP_SOURCE_RTCP_PACKET_H_ |