AudioCodingModule: Add methods for injecting external encoder stacks

webrtc/modules/audio_coding/include/audio_coding_module.h

 /*
  *  Copyright (c) 2012 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 189 matching lines @@
   //   -1 if failed to initialize,
   //    0 if succeeded.
   //
   virtual int32_t RegisterSendCodec(const CodecInst& send_codec) = 0;
 
   // Registers |external_speech_encoder| as encoder. The new encoder will
   // replace any previously registered speech encoder (internal or external).
   virtual void RegisterExternalSendCodec(
       AudioEncoder* external_speech_encoder) = 0;
 
+  // Class for doing type erasure on a functor with signature
+  // AudioEncoder*(AudioEncoder*). Any functor with this signature will
+  // implicitly convert to EncoderVisitor.
+  class EncoderVisitor final {
+   public:
+    template <typename F>
+    EncoderVisitor(const F& f) : f_(&f), call_(Call<F>) {}
+    AudioEncoder* operator()(AudioEncoder* enc) const { return call_(f_, enc); }
+
+   private:
+    template <typename F>
+    static AudioEncoder* Call(const void* f, AudioEncoder* enc) {
+      return (*static_cast<const F*>(f))(enc);
+    }
+    const void* const f_;
+    AudioEncoder* (*const call_)(const void* f, AudioEncoder* enc);
+  };
+
+  // |ev| is called exactly once with one argument: the current encoder (or
+  // nullptr if there is no current encoder). For the duration of the call,
+  // |ev| has exclusive access to its argument. |ev|'s return value (which may
+  // be its argument, another AudioEncoder*, or nullptr) is the new current
+  // encoder. The encoder will be used as-is, without applying VAD/DTX or RED
+  // or anything.
+  virtual void VisitEncoder(const EncoderVisitor& ev) = 0;
+
+  // Utility method for simply replacing the existing encoder with a new one.
+  void SetEncoder(AudioEncoder* new_encoder) {
+    VisitEncoder([&](AudioEncoder* old_encoder) { return new_encoder; });
+  }
+
   ///////////////////////////////////////////////////////////////////////////
   // int32_t SendCodec()
   // Get parameters for the codec currently registered as send codec.
   //
   // Return value:
   //   The send codec, or nothing if we don't have one
   //
   virtual rtc::Optional<CodecInst> SendCodec() const = 0;
 
   ///////////////////////////////////////////////////////////////////////////
@@ skipping 245 matching lines @@
   //   -receive_codec      : parameters of the codec to be registered, c.f.
   //                         common_types.h for the definition of
   //                         CodecInst.
   //
   // Return value:
   //   -1 if failed to register the codec
   //    0 if the codec registered successfully.
   //
   virtual int RegisterReceiveCodec(const CodecInst& receive_codec) = 0;
 
+  // Class for doing type erasure on a functor with signature AudioDecoder*().
+  // Any functor with this signature will implicitly convert to DecoderFactory.
+  class DecoderFactory final {
+   public:
+    template <typename F>
+    DecoderFactory(const F& f) : f_(&f), call_(Call<F>) {}
+    AudioDecoder* operator()() const { return call_(f_); }
+
+   private:
+    template <typename F>
+    static AudioDecoder* Call(const void* f) {
+      return (*static_cast<const F*>(f))();
+    }
+    const void* const f_;
+    AudioDecoder* (*const call_)(const void* f);
+  };
+
+  // Register a decoder; call repeatedly to register multiple decoders. |df| is
+  // a decoder factory that returns an iSAC decoder; it will be called once if
+  // the decoder being registered is iSAC.
+  virtual int RegisterReceiveCodec(const CodecInst& receive_codec,
+                                   const DecoderFactory& df) = 0;
+
   // Registers an external decoder. The name is only used to provide information
   // back to the caller about the decoder. Hence, the name is arbitrary, and may
   // be empty.
   virtual int RegisterExternalReceiveCodec(int rtp_payload_type,
                                            AudioDecoder* external_decoder,
                                            int sample_rate_hz,
                                            int num_channels,
                                            const std::string& name) = 0;
 
   ///////////////////////////////////////////////////////////////////////////
@@ skipping 252 matching lines @@
   virtual std::vector<uint16_t> GetNackList(
       int64_t round_trip_time_ms) const = 0;
 
   virtual void GetDecodingCallStatistics(
       AudioDecodingCallStats* call_stats) const = 0;
 };
 
 }  // namespace webrtc
 
 #endif  // WEBRTC_MODULES_AUDIO_CODING_INCLUDE_AUDIO_CODING_MODULE_H_