Implement adaptive target delay extension

media/cast/sender/frame_sender.h

 // Copyright 2014 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 //
 // This is the base class for an object that send frames to a receiver.
 // TODO(hclam): Refactor such that there is no separate AudioSender vs.
 // VideoSender, and the functionality of both is rolled into this class.
 
 #ifndef MEDIA_CAST_SENDER_FRAME_SENDER_H_
 #define MEDIA_CAST_SENDER_FRAME_SENDER_H_
 
 #include "base/basictypes.h"
 #include "base/memory/ref_counted.h"
 #include "base/memory/weak_ptr.h"
 #include "base/time/time.h"
 #include "media/cast/cast_environment.h"
 #include "media/cast/net/rtcp/rtcp.h"
 #include "media/cast/sender/rtp_timestamp_helper.h"
 
 namespace media {
 namespace cast {
 
 class FrameSender {
  public:
   FrameSender(scoped_refptr<CastEnvironment> cast_environment,
               CastTransportSender* const transport_sender,
               base::TimeDelta rtcp_interval,
               int frequency,
-              uint32 ssrc);
+              uint32 ssrc,
+              double max_frame_rate,
+              base::TimeDelta playout_delay);
   virtual ~FrameSender();
 
+  // Calling this function is only valid if the receiver supports the
+  // "extra_playout_delay", rtp extension.
+  void SetTargetPlayoutDelay(base::TimeDelta new_target_playout_delay);
+
+  base::TimeDelta GetTargetPlayoutDelay() const {
+    return target_playout_delay_;
+  }
+
  protected:
   // Schedule and execute periodic sending of RTCP report.
   void ScheduleNextRtcpReport();
   void SendRtcpReport(bool schedule_future_reports);
 
   void OnReceivedRtt(base::TimeDelta rtt,
                      base::TimeDelta avg_rtt,
                      base::TimeDelta min_rtt,
                      base::TimeDelta max_rtt);
 
@@ skipping 14 matching lines @@
   // extrapolates this mapping to any other point in time.
   RtpTimestampHelper rtp_timestamp_helper_;
 
   // RTT information from RTCP.
   bool rtt_available_;
   base::TimeDelta rtt_;
   base::TimeDelta avg_rtt_;
   base::TimeDelta min_rtt_;
   base::TimeDelta max_rtt_;
 
- private:
+ protected:
   const base::TimeDelta rtcp_interval_;
 
+  // The total amount of time between a frame's capture/recording on the sender
+  // and its playback on the receiver (i.e., shown to a user).  This is fixed as
+  // a value large enough to give the system sufficient time to encode,
+  // transmit/retransmit, receive, decode, and render; given its run-time
+  // environment (sender/receiver hardware performance, network conditions,
+  // etc.).
+  base::TimeDelta target_playout_delay_;
+
+  // If true, we transmit the target playout delay to the receiver.
+  bool send_target_playout_delay_;
+
+  // Max encoded frames generated per second.
+  double max_frame_rate_;
+
+  // Maximum number of outstanding frames before the encoding and sending of
+  // new frames shall halt.
+  int max_unacked_frames_;
+
+ private:
   // NOTE: Weak pointers must be invalidated before all other member variables.
   base::WeakPtrFactory<FrameSender> weak_factory_;
 
   DISALLOW_COPY_AND_ASSIGN(FrameSender);
 };
 
 }  // namespace cast
 }  // namespace media
 
 #endif  // MEDIA_CAST_SENDER_FRAME_SENDER_H_