This changes the following module directories:
* webrtc/modules/audio_conference_mixer/interface
* webrtc/modules/interface
* webrtc/modules/media_file/interface
* webrtc/modules/rtp_rtcp/interface
* webrtc/modules/utility/interface
To avoid breaking downstream, I followed this recipe:
1. Copy the interface dir to a new sibling directory: include
2. Update the header guards in the include directory to match the style guide.
3. Update the header guards in the interface directory to match the ones in include. This is required to avoid getting redefinitions in the not-yet-updated downstream code.
4. Add a pragma warning in the header files in the interface dir. Example:
#pragma message("WARNING: webrtc/modules/interface is DEPRECATED; "
"use webrtc/modules/include")
5. Search for all source references to webrtc/modules/interface and update them to webrtc/modules/include (*.c*,*.h,*.mm,*.S)
6. Update all GYP+GN files. This required manual inspection since many subdirectories of webrtc/modules referenced the interface dir using ../interface etc(*.gyp*,*.gn*)
BUG=5095
TESTED=Passing compile-trybots with --clobber flag:
git cl try --clobber --bot=win_compile_rel --bot=linux_compile_rel --bot=android_compile_rel --bot=mac_compile_rel --bot=ios_rel -m tryserver.webrtc
R=stefan@webrtc.org, tommi@webrtc.org
Review URL: https://codereview.webrtc.org/1417683006 .
Cr-Commit-Position: refs/heads/master@{#10500}
1167 lines
38 KiB
C++
1167 lines
38 KiB
C++
/*
|
|
* 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_RTCP_PACKET_H_
|
|
#define WEBRTC_MODULES_RTP_RTCP_RTCP_PACKET_H_
|
|
|
|
#include <map>
|
|
#include <string>
|
|
#include <vector>
|
|
|
|
#include "webrtc/base/scoped_ptr.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 Rrtr;
|
|
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;
|
|
|
|
private:
|
|
bool CreateAndAddAppended(uint8_t* packet,
|
|
size_t* index,
|
|
size_t max_length,
|
|
PacketReadyCallback* callback) const;
|
|
|
|
std::vector<RtcpPacket*> appended_packets_;
|
|
};
|
|
|
|
// 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);
|
|
};
|
|
|
|
// From RFC 3550, RTP: A Transport Protocol for Real-Time Applications.
|
|
//
|
|
// RTCP report block (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
|
|
// +=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+
|
|
// | SSRC_1 (SSRC of first source) |
|
|
// +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|
|
// | fraction lost | cumulative number of packets lost |
|
|
// +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|
|
// | extended highest sequence number received |
|
|
// +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|
|
// | interarrival jitter |
|
|
// +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|
|
// | last SR (LSR) |
|
|
// +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|
|
// | delay since last SR (DLSR) |
|
|
// +=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+
|
|
|
|
class ReportBlock {
|
|
public:
|
|
ReportBlock() {
|
|
// TODO(asapersson): Consider adding a constructor to struct.
|
|
memset(&report_block_, 0, sizeof(report_block_));
|
|
}
|
|
|
|
~ReportBlock() {}
|
|
|
|
void To(uint32_t ssrc) {
|
|
report_block_.SSRC = ssrc;
|
|
}
|
|
void WithFractionLost(uint8_t fraction_lost) {
|
|
report_block_.FractionLost = fraction_lost;
|
|
}
|
|
void WithCumulativeLost(uint32_t cumulative_lost) {
|
|
report_block_.CumulativeNumOfPacketsLost = cumulative_lost;
|
|
}
|
|
void WithExtHighestSeqNum(uint32_t ext_highest_seq_num) {
|
|
report_block_.ExtendedHighestSequenceNumber = ext_highest_seq_num;
|
|
}
|
|
void WithJitter(uint32_t jitter) {
|
|
report_block_.Jitter = jitter;
|
|
}
|
|
void WithLastSr(uint32_t last_sr) {
|
|
report_block_.LastSR = last_sr;
|
|
}
|
|
void WithDelayLastSr(uint32_t delay_last_sr) {
|
|
report_block_.DelayLastSR = delay_last_sr;
|
|
}
|
|
|
|
private:
|
|
friend class SenderReport;
|
|
friend class ReceiverReport;
|
|
RTCPUtility::RTCPPacketReportBlockItem report_block_;
|
|
};
|
|
|
|
// 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<RTCPUtility::RTCPPacketReportBlockItem> report_blocks_;
|
|
|
|
RTC_DISALLOW_COPY_AND_ASSIGN(SenderReport);
|
|
};
|
|
|
|
//
|
|
// RTCP receiver report (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
|
|
// +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|
|
// |V=2|P| RC | PT=RR=201 | length |
|
|
// +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|
|
// | SSRC of packet sender |
|
|
// +=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+
|
|
// | report block(s) |
|
|
// | .... |
|
|
|
|
class ReceiverReport : public RtcpPacket {
|
|
public:
|
|
ReceiverReport() : RtcpPacket() {
|
|
memset(&rr_, 0, sizeof(rr_));
|
|
}
|
|
|
|
virtual ~ReceiverReport() {}
|
|
|
|
void From(uint32_t ssrc) {
|
|
rr_.SenderSSRC = ssrc;
|
|
}
|
|
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 kRrHeaderLength = 8;
|
|
return kRrHeaderLength + report_blocks_.size() * kReportBlockLength;
|
|
}
|
|
|
|
RTCPUtility::RTCPPacketRR rr_;
|
|
std::vector<RTCPUtility::RTCPPacketReportBlockItem> report_blocks_;
|
|
|
|
RTC_DISALLOW_COPY_AND_ASSIGN(ReceiverReport);
|
|
};
|
|
|
|
// Transmission Time Offsets in RTP Streams (RFC 5450).
|
|
//
|
|
// 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
|
|
// +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|
|
// hdr |V=2|P| RC | PT=IJ=195 | length |
|
|
// +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|
|
// | inter-arrival jitter |
|
|
// +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|
|
// . .
|
|
// . .
|
|
// . .
|
|
// | inter-arrival jitter |
|
|
// +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|
|
//
|
|
// If present, this RTCP packet must be placed after a receiver report
|
|
// (inside a compound RTCP packet), and MUST have the same value for RC
|
|
// (reception report count) as the receiver report.
|
|
|
|
class Ij : public RtcpPacket {
|
|
public:
|
|
Ij() : RtcpPacket() {}
|
|
|
|
virtual ~Ij() {}
|
|
|
|
bool WithJitterItem(uint32_t jitter);
|
|
|
|
protected:
|
|
bool Create(uint8_t* packet,
|
|
size_t* index,
|
|
size_t max_length,
|
|
RtcpPacket::PacketReadyCallback* callback) const override;
|
|
|
|
private:
|
|
static const int kMaxNumberOfIjItems = 0x1f;
|
|
|
|
size_t BlockLength() const {
|
|
return kHeaderLength + 4 * ij_items_.size();
|
|
}
|
|
|
|
std::vector<uint32_t> ij_items_;
|
|
|
|
RTC_DISALLOW_COPY_AND_ASSIGN(Ij);
|
|
};
|
|
|
|
// 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);
|
|
};
|
|
|
|
//
|
|
// Bye packet (BYE) (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| SC | PT=BYE=203 | length |
|
|
// +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|
|
// | SSRC/CSRC |
|
|
// +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|
|
// : ... :
|
|
// +=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+
|
|
// (opt) | length | reason for leaving ...
|
|
// +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|
|
|
|
class Bye : public RtcpPacket {
|
|
public:
|
|
Bye() : RtcpPacket() {
|
|
memset(&bye_, 0, sizeof(bye_));
|
|
}
|
|
|
|
virtual ~Bye() {}
|
|
|
|
void From(uint32_t ssrc) {
|
|
bye_.SenderSSRC = ssrc;
|
|
}
|
|
|
|
bool WithCsrc(uint32_t csrc);
|
|
|
|
// TODO(sprang): Add support for reason field?
|
|
|
|
protected:
|
|
bool Create(uint8_t* packet,
|
|
size_t* index,
|
|
size_t max_length,
|
|
RtcpPacket::PacketReadyCallback* callback) const override;
|
|
|
|
private:
|
|
static const int kMaxNumberOfCsrcs = 0x1f - 1; // First item is sender SSRC.
|
|
|
|
size_t BlockLength() const {
|
|
size_t source_count = 1 + csrcs_.size();
|
|
return kHeaderLength + 4 * source_count;
|
|
}
|
|
|
|
RTCPUtility::RTCPPacketBYE bye_;
|
|
std::vector<uint32_t> csrcs_;
|
|
|
|
RTC_DISALLOW_COPY_AND_ASSIGN(Bye);
|
|
};
|
|
|
|
// Application-Defined packet (APP) (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
|
|
// +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|
|
// |V=2|P| subtype | PT=APP=204 | length |
|
|
// +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|
|
// | SSRC/CSRC |
|
|
// +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|
|
// | name (ASCII) |
|
|
// +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|
|
// | application-dependent data ...
|
|
// +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|
|
|
|
class App : public RtcpPacket {
|
|
public:
|
|
App()
|
|
: RtcpPacket(),
|
|
ssrc_(0) {
|
|
memset(&app_, 0, sizeof(app_));
|
|
}
|
|
|
|
virtual ~App() {}
|
|
|
|
void From(uint32_t ssrc) {
|
|
ssrc_ = ssrc;
|
|
}
|
|
void WithSubType(uint8_t subtype) {
|
|
assert(subtype <= 0x1f);
|
|
app_.SubType = subtype;
|
|
}
|
|
void WithName(uint32_t name) {
|
|
app_.Name = name;
|
|
}
|
|
void WithData(const uint8_t* data, uint16_t data_length) {
|
|
assert(data);
|
|
assert(data_length <= kRtcpAppCode_DATA_SIZE);
|
|
assert(data_length % 4 == 0);
|
|
memcpy(app_.Data, data, data_length);
|
|
app_.Size = data_length;
|
|
}
|
|
|
|
protected:
|
|
bool Create(uint8_t* packet,
|
|
size_t* index,
|
|
size_t max_length,
|
|
RtcpPacket::PacketReadyCallback* callback) const override;
|
|
|
|
private:
|
|
size_t BlockLength() const {
|
|
return 12 + app_.Size;
|
|
}
|
|
|
|
uint32_t ssrc_;
|
|
RTCPUtility::RTCPPacketAPP app_;
|
|
|
|
RTC_DISALLOW_COPY_AND_ASSIGN(App);
|
|
};
|
|
|
|
// RFC 4585: Feedback format.
|
|
//
|
|
// Common packet format:
|
|
//
|
|
// 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 | PT | length |
|
|
// +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|
|
// | SSRC of packet sender |
|
|
// +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|
|
// | SSRC of media source |
|
|
// +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|
|
// : Feedback Control Information (FCI) :
|
|
// :
|
|
|
|
// Picture loss indication (PLI) (RFC 4585).
|
|
//
|
|
// FCI: no feedback control information.
|
|
|
|
class Pli : public RtcpPacket {
|
|
public:
|
|
Pli() : RtcpPacket() {
|
|
memset(&pli_, 0, sizeof(pli_));
|
|
}
|
|
|
|
virtual ~Pli() {}
|
|
|
|
void From(uint32_t ssrc) {
|
|
pli_.SenderSSRC = ssrc;
|
|
}
|
|
void To(uint32_t ssrc) {
|
|
pli_.MediaSSRC = ssrc;
|
|
}
|
|
|
|
protected:
|
|
bool Create(uint8_t* packet,
|
|
size_t* index,
|
|
size_t max_length,
|
|
RtcpPacket::PacketReadyCallback* callback) const override;
|
|
|
|
private:
|
|
size_t BlockLength() const {
|
|
return kCommonFbFmtLength;
|
|
}
|
|
|
|
RTCPUtility::RTCPPacketPSFBPLI pli_;
|
|
|
|
RTC_DISALLOW_COPY_AND_ASSIGN(Pli);
|
|
};
|
|
|
|
// 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 {
|
|
const size_t kRrtrBlockLength = 12;
|
|
return kRrtrBlockLength * 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<RTCPUtility::RTCPPacketXRReceiverReferenceTimeItem> rrtr_blocks_;
|
|
std::vector<DlrrBlock> dlrr_blocks_;
|
|
std::vector<RTCPUtility::RTCPPacketXRVOIPMetricItem> voip_metric_blocks_;
|
|
|
|
RTC_DISALLOW_COPY_AND_ASSIGN(Xr);
|
|
};
|
|
|
|
// Receiver Reference Time 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=4 | reserved | block length = 2 |
|
|
// +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|
|
// | NTP timestamp, most significant word |
|
|
// +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|
|
// | NTP timestamp, least significant word |
|
|
// +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|
|
|
|
class Rrtr {
|
|
public:
|
|
Rrtr() {
|
|
memset(&rrtr_block_, 0, sizeof(rrtr_block_));
|
|
}
|
|
~Rrtr() {}
|
|
|
|
void WithNtpSec(uint32_t sec) {
|
|
rrtr_block_.NTPMostSignificant = sec;
|
|
}
|
|
void WithNtpFrac(uint32_t frac) {
|
|
rrtr_block_.NTPLeastSignificant = frac;
|
|
}
|
|
|
|
private:
|
|
friend class Xr;
|
|
RTCPUtility::RTCPPacketXRReceiverReferenceTimeItem rrtr_block_;
|
|
|
|
RTC_DISALLOW_COPY_AND_ASSIGN(Rrtr);
|
|
};
|
|
|
|
// 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_RTCP_PACKET_H_
|