[rtp_rtcp] Added structure to use as item in TMMBN/TMMBR

webrtc/modules/rtp_rtcp/source/rtcp_packet/timber.h

+/*
+ *  Copyright (c) 2016 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_TIMBER_H_
+#define WEBRTC_MODULES_RTP_RTCP_SOURCE_RTCP_PACKET_TIMBER_H_
+
+#include "webrtc/base/basictypes.h"
+
+namespace webrtc {
+namespace rtcp {
+// RFC5104, Section 3.5.4
+// Timber is human-friendly name for TMMBR:

[åsapersson, 2016/02/04 13:39:31]

I think i would prefer this to be called TmmbrItem or TmmbrRequest or similar.

[danilchap, 2016/02/04 14:08:37]

It can be used both as request and notification, i.e. both in Tmmbr and Tmmbn
packets. How about TmmbItem?

+// Temporary Maximum Media Stream Bit Rate Request.
+// Used both by TMMBR and TMMBN rtcp packets.
+class Timber {
+ public:
+  static const size_t kLength = 8;
+
+  Timber() : ssrc_(0), bitrate_bps_(0), packet_overhead_(0) {}
+  Timber(uint32_t ssrc, uint32_t bitrate_bps, uint16_t overhead);
+
+  void Parse(const uint8_t* buffer);
+  void Create(uint8_t* buffer) const;
+
+  void set_ssrc(uint32_t ssrc) { ssrc_ = ssrc; }
+  void set_bitrate_bps(uint32_t bitrate_bps) { bitrate_bps_ = bitrate_bps; }
+  void set_packet_overhead(uint16_t overhead);
+
+  uint32_t ssrc() const { return ssrc_; }
+  uint32_t bitrate_bps() const { return bitrate_bps_; }
+  uint16_t packet_overhead() const { return packet_overhead_; }
+
+ private:
+  // Media stream id.
+  uint32_t ssrc_;
+  // Maximum total media bit rate that the media receiver is
+  // currently prepared to accept for this media stream.
+  uint32_t bitrate_bps_;
+  // Per-packet overhead that the media receiver has observed
+  // for this media stream at its chosen reference protocol layer.
+  uint16_t packet_overhead_;
+};
+}  // namespace rtcp
+}  // namespace webrtc
+#endif  // WEBRTC_MODULES_RTP_RTCP_SOURCE_RTCP_PACKET_TIMBER_H_