Adding audio network adaptor to AudioEncoderOpus.

webrtc/modules/audio_coding/codecs/audio_encoder.h

 /*
  *  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_AUDIO_CODING_CODECS_AUDIO_ENCODER_H_
 #define WEBRTC_MODULES_AUDIO_CODING_CODECS_AUDIO_ENCODER_H_
 
 #include <algorithm>
 #include <vector>
 
 #include "webrtc/base/array_view.h"
 #include "webrtc/base/buffer.h"
 #include "webrtc/base/deprecation.h"
 #include "webrtc/typedefs.h"
 
 namespace webrtc {
 
+class Clock;
+
 // This is the interface class for encoders in AudioCoding module. Each codec
 // type must have an implementation of this class.
 class AudioEncoder {
  public:
   // Used for UMA logging of codec usage. The same codecs, with the
   // same values, must be listed in
   // src/tools/metrics/histograms/histograms.xml in chromium to log
   // correct values.
   enum class CodecType {
     kOther = 0,  // Codec not specified, and/or not listed in this enum
@@ skipping 121 matching lines @@
 
   // Causes this encoder to let go of any other encoders it contains, and
   // returns a pointer to an array where they are stored (which is required to
   // live as long as this encoder). Unless the returned array is empty, you may
   // not call any methods on this encoder afterwards, except for the
   // destructor. The default implementation just returns an empty array.
   // NOTE: This method is subject to change. Do not call or override it.
   virtual rtc::ArrayView<std::unique_ptr<AudioEncoder>>
   ReclaimContainedEncoders();
 
+  // Enables audio network adaptor. Returns whether enabling is succeeded.

[kwiberg-webrtc, 2016/10/03 12:48:10]

"Returns true if successful."

[minyue-webrtc, 2016/10/03 12:57:14]

will do

+  virtual bool EnableAudioNetworkAdaptor(const std::string& config_string,
+                                         const Clock* clock);
+
+  // Disables audio network adaptor.
+  virtual void DisableAudioNetworkAdaptor();
+
+  // Provides uplink bandwidth to this encoder to allow it to adapt.
+  virtual void OnReceivedUplinkBandwidth(int uplink_bandwidth_bps);
+
+  // Provides uplink packet loss fraction to this encoder to allow it to adapt.
+  virtual void OnReceivedUplinkPacketLossFraction(
+      float uplink_packet_loss_fraction);
+
+  // Provides target audio bitrate to this encoder to allow it to adapt.
+  virtual void OnReceivedTargetAudioBitrate(int target_audio_bitrate_bps);
+
+  // Provides RTT to this encoder to allow it to adapt.
+  virtual void OnReceivedRtt(int rtt_ms);
+
+  // To allow encoder to adapt its frame length, it must be provided the frame
+  // length range that receives can accept.
+  virtual void SetReceiverFrameLengthRange(int min_frame_length_ms,
+                                           int max_frame_length_ms);
+
  protected:
   // Subclasses implement this to perform the actual encoding. Called by
   // Encode().
   virtual EncodedInfo EncodeImpl(uint32_t rtp_timestamp,
                                  rtc::ArrayView<const int16_t> audio,
                                  rtc::Buffer* encoded) = 0;
 };
 }  // namespace webrtc
 #endif  // WEBRTC_MODULES_AUDIO_CODING_CODECS_AUDIO_ENCODER_H_