Add PacketRouter::SetMaxDesiredReceiveBitrate for application limited receive bandwidth

webrtc/modules/pacing/packet_router.h

 /*
  *  Copyright (c) 2015 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.
  */
 
@@ skipping 65 matching lines @@
   uint16_t AllocateSequenceNumber() override;
 
   // Called every time there is a new bitrate estimate for a receive channel
   // group. This call will trigger a new RTCP REMB packet if the bitrate
   // estimate has decreased or if no RTCP REMB packet has been sent for
   // a certain time interval.
   // Implements RtpReceiveBitrateUpdate.
   void OnReceiveBitrateChanged(const std::vector<uint32_t>& ssrcs,
                                uint32_t bitrate_bps) override;
 
+  // Ensures remote party notified of the receive bitrate limit no larger than
+  // |bitrate_bps|.
+  void SetMaxDesiredReceiveBitrate(uint32_t bitrate_bps);
+
   // Send REMB feedback.
   virtual bool SendRemb(uint32_t bitrate_bps,
                         const std::vector<uint32_t>& ssrcs);
 
   // Send transport feedback packet to send-side.
   virtual bool SendTransportFeedback(rtcp::TransportFeedback* packet);
 
  private:
   void AddRembModuleCandidate(RtpRtcp* candidate_module, bool sender)
       EXCLUSIVE_LOCKS_REQUIRED(modules_crit_);
   void MaybeRemoveRembModuleCandidate(RtpRtcp* candidate_module, bool sender)
       EXCLUSIVE_LOCKS_REQUIRED(modules_crit_);
   void UnsetActiveRembModule() EXCLUSIVE_LOCKS_REQUIRED(modules_crit_);
   void DetermineActiveRembModule() EXCLUSIVE_LOCKS_REQUIRED(modules_crit_);
 
   rtc::RaceChecker pacer_race_;
   rtc::CriticalSection modules_crit_;
   std::list<RtpRtcp*> rtp_send_modules_ GUARDED_BY(modules_crit_);
   std::vector<RtpRtcp*> rtp_receive_modules_ GUARDED_BY(modules_crit_);
 
   // TODO(eladalon): remb_crit_ only ever held from one function, and it's not
   // clear if that function can actually be called from more than one thread.
   rtc::CriticalSection remb_crit_;
   // The last time a REMB was sent.
   int64_t last_remb_time_ms_ GUARDED_BY(remb_crit_);
   uint32_t last_send_bitrate_bps_ GUARDED_BY(remb_crit_);
   // The last bitrate update.
   uint32_t bitrate_bps_ GUARDED_BY(remb_crit_);
+  uint32_t max_bitrate_bps_ GUARDED_BY(remb_crit_);
 
   // Candidates for the REMB module can be RTP sender/receiver modules, with
   // the sender modules taking precedence.
   std::vector<RtpRtcp*> sender_remb_candidates_ GUARDED_BY(modules_crit_);
   std::vector<RtpRtcp*> receiver_remb_candidates_ GUARDED_BY(modules_crit_);
   RtpRtcp* active_remb_module_ GUARDED_BY(modules_crit_);
 
   volatile int transport_seq_;
 
   RTC_DISALLOW_COPY_AND_ASSIGN(PacketRouter);
 };
 }  // namespace webrtc
 #endif  // WEBRTC_MODULES_PACING_PACKET_ROUTER_H_