Removals and renamings in the new audio mixer.

webrtc/modules/audio_mixer/audio_mixer.h

 /*
- *  Copyright (c) 2012 The WebRTC project authors. All Rights Reserved.
+ *  Copyright (c) 2011 The WebRTC project authors. All Rights Reserved.

[ivoc, 2016/08/18 15:47:23]

This looks a bit odd, is the new mixer older than the old mixer? :-)

[aleloi, 2016/08/19 12:06:08]

The old mixer is a different file. I think we had a discussion with tommi@
earlier and the conclusion was to not update headers unless it's a completely
new file.

[ivoc, 2016/08/19 12:37:37]

Acknowledged.

  *
  *  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_MIXER_AUDIO_MIXER_H_
 #define WEBRTC_MODULES_AUDIO_MIXER_AUDIO_MIXER_H_
 
-#include <memory>
-
-#include "webrtc/base/criticalsection.h"
-#include "webrtc/common_audio/resampler/include/push_resampler.h"
-#include "webrtc/common_types.h"
-#include "webrtc/modules/audio_mixer/new_audio_conference_mixer.h"
 #include "webrtc/modules/audio_mixer/audio_mixer_defines.h"
-#include "webrtc/modules/utility/include/file_recorder.h"
-#include "webrtc/voice_engine/level_indicator.h"
-#include "webrtc/voice_engine/voice_engine_defines.h"
+#include "webrtc/modules/include/module.h"
+#include "webrtc/modules/include/module_common_types.h"
 
 namespace webrtc {
+class MixerAudioSource;
 
-class AudioProcessing;
-class FileWrapper;
-class VoEMediaProcess;
+class AudioMixer {
+ public:
+  enum { kMaximumAmountOfMixedAudioSources = 3 };

[ivoc, 2016/08/18 15:47:23]

I think this should be a static const int.

[aleloi, 2016/08/19 12:06:08]

There are apparently some differences between anonymous enum and static const:
http://stackoverflow.com/a/1377865

But I think static const int makes more sense here.

[ivoc, 2016/08/19 12:37:37]

Interesting, but I agree that I prefer static const int, mostly because it looks
less confusing.

+  enum Frequency {
+    kNbInHz = 8000,
+    kWbInHz = 16000,
+    kSwbInHz = 32000,
+    kFbInHz = 48000,
+    kLowestPossible = -1,
+    kDefaultFrequency = kWbInHz
+  };
 
-namespace voe {
-class Statistics;
+  // Factory method. Constructor disabled.
+  static AudioMixer* Create(int id);

[ivoc, 2016/08/18 15:47:23]

You can consider to change this to return a unique_ptr<AudioMixer>.

[aleloi, 2016/08/19 12:06:09]

That makes sense! Done.

+  virtual ~AudioMixer() {}
 
-// Note: this class is in the process of being rewritten and merged
-// with AudioConferenceMixer. Expect inheritance chains to be changed,
-// member functions removed or renamed.
-class AudioMixer : public FileCallback {
- public:
-  static int32_t Create(AudioMixer*& mixer, uint32_t instanceId);  // NOLINT
+  // Add/remove audio sources as candidates for mixing.
+  virtual int32_t SetMixabilityStatus(MixerAudioSource* audio_source,
+                                      bool mixable) = 0;
+  // Returns true if an audio source is a candidate for mixing.
+  virtual bool MixabilityStatus(const MixerAudioSource& audio_source) const = 0;
 
-  static void Destroy(AudioMixer*& mixer);  // NOLINT
+  // Inform the mixer that the audio source should always be mixed and not
+  // count toward the number of mixed audio sources. Note that an audio source
+  // must have been added to the mixer (by calling SetMixabilityStatus())
+  // before this function can be successfully called.
+  virtual int32_t SetAnonymousMixabilityStatus(MixerAudioSource* audio_source,
+                                               bool mixable) = 0;
 
-  int32_t SetEngineInformation(Statistics& engineStatistics);  // NOLINT
+  // Performs mixing by asking registered audio sources for audio. The
+  // mixed result is placed in the provided AudioFrame. Can only be
+  // called from a single thread. The rate and channels arguments
+  // specify the rate and number of channels of the mix result.
+  virtual void Mix(int sample_rate,
+                   size_t number_of_channels,
+                   AudioFrame* audio_frame_for_mixing) = 0;
 
-  int32_t SetAudioProcessingModule(AudioProcessing* audioProcessingModule);
+  // Returns true if the audio source is mixed anonymously.
+  virtual bool AnonymousMixabilityStatus(
+      const MixerAudioSource& audio_source) const = 0;
 
-  // VoEExternalMedia
-  int RegisterExternalMediaProcessing(VoEMediaProcess&  // NOLINT
-                                      proccess_object);
+  // Output level functions for VoEVolumeControl. Return value
+  // between 0 and 9 is returned by voe::AudioLevel.
+  virtual uint32_t GetOutputAudioLevel() = 0;
 
-  int DeRegisterExternalMediaProcessing();
+  // Return value between 0 and 0x7fff is returned by voe::AudioLevel.
+  virtual uint32_t GetOutputAudioLevelFullRange() = 0;
 
-  int32_t DoOperationsOnCombinedSignal(bool feed_data_to_apm);
-
-  int32_t SetMixabilityStatus(MixerAudioSource& audio_source,  // NOLINT
-                              bool mixable);
-
-  int32_t SetAnonymousMixabilityStatus(
-      MixerAudioSource& audio_source,  // NOLINT
-      bool mixable);
-
-  int GetMixedAudio(int sample_rate_hz,
-                    size_t num_channels,
-                    AudioFrame* audioFrame);
-
-  // VoEVolumeControl
-  int GetSpeechOutputLevel(uint32_t& level);  // NOLINT
-
-  int GetSpeechOutputLevelFullRange(uint32_t& level);  // NOLINT
-
-  int SetOutputVolumePan(float left, float right);
-
-  int GetOutputVolumePan(float& left, float& right);  // NOLINT
-
-  // VoEFile
-  int StartRecordingPlayout(const char* fileName, const CodecInst* codecInst);
-
-  int StartRecordingPlayout(OutStream* stream, const CodecInst* codecInst);
-  int StopRecordingPlayout();
-
-  virtual ~AudioMixer();
-
-  // For file recording
-  void PlayNotification(int32_t id, uint32_t durationMs);
-
-  void RecordNotification(int32_t id, uint32_t durationMs);
-
-  void PlayFileEnded(int32_t id);
-  void RecordFileEnded(int32_t id);
-
- private:
-  explicit AudioMixer(uint32_t instanceId);
-
-  // uses
-  Statistics* _engineStatisticsPtr;
-  AudioProcessing* _audioProcessingModulePtr;
-
-  rtc::CriticalSection _callbackCritSect;
-  // protect the _outputFileRecorderPtr and _outputFileRecording
-  rtc::CriticalSection _fileCritSect;
-  NewAudioConferenceMixer& _mixerModule;
-  AudioFrame _audioFrame;
-  // Converts mixed audio to the audio processing rate.
-  PushResampler<int16_t> audioproc_resampler_;
-  AudioLevel _audioLevel;  // measures audio level for the combined signal
-  int _instanceId;
-  VoEMediaProcess* _externalMediaCallbackPtr;
-  bool _externalMedia;
-  float _panLeft;
-  float _panRight;
-  int _mixingFrequencyHz;
-  std::unique_ptr<FileRecorder> _outputFileRecorderPtr;
-  bool _outputFileRecording;
+ protected:
+  AudioMixer() {}
 };
-
-}  // namespace voe
-
 }  // namespace webrtc
 
 #endif  // WEBRTC_MODULES_AUDIO_MIXER_AUDIO_MIXER_H_