Audio output debug recording.

media/audio/audio_manager_base.h

 // Copyright (c) 2012 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.
 
 #ifndef MEDIA_AUDIO_AUDIO_MANAGER_BASE_H_
 #define MEDIA_AUDIO_AUDIO_MANAGER_BASE_H_
 
 #include <memory>
 #include <string>
 #include <unordered_set>
 #include <utility>
 
 #include "base/compiler_specific.h"
+#include "base/files/file_path.h"
 #include "base/macros.h"
 #include "base/memory/scoped_vector.h"
 #include "base/observer_list.h"
 #include "base/threading/thread.h"
 #include "build/build_config.h"
 #include "media/audio/audio_device_name.h"
 #include "media/audio/audio_manager.h"
 #include "media/audio/audio_output_dispatcher.h"
 
 #if defined(OS_WIN)
 #include "base/win/scoped_com_initializer.h"
 #endif
 
 namespace media {
 
 class AudioOutputDispatcher;
+class AudioOutputResampler;
 
 // AudioManagerBase provides AudioManager functions common for all platforms.
 class MEDIA_EXPORT AudioManagerBase : public AudioManager {
  public:
   ~AudioManagerBase() override;
 
   // AudioManager:
   base::string16 GetAudioInputDeviceModel() override;
   void ShowAudioInputSettings() override;
 
@@ skipping 20 matching lines @@
 
   AudioParameters GetDefaultOutputStreamParameters() override;
   AudioParameters GetOutputStreamParameters(
       const std::string& device_id) override;
   AudioParameters GetInputStreamParameters(
       const std::string& device_id) override;
   std::string GetAssociatedOutputDeviceID(
       const std::string& input_device_id) override;
   std::unique_ptr<AudioLog> CreateAudioLog(
       AudioLogFactory::AudioComponent component) override;
+  std::unique_ptr<AudioFileWriter> CreateAudioFileWriter(
+      const AudioParameters& params) override;
+  void EnableOutputDebugRecording(
+      const base::FilePath& base_file_name) override;
+  void DisableOutputDebugRecording() override;
 
   void SetMaxStreamCountForTesting(int max_input, int max_output) final;
 
   // AudioManagerBase:
 
   // Called internally by the audio stream when it has been closed.
   virtual void ReleaseOutputStream(AudioOutputStream* stream);
   virtual void ReleaseInputStream(AudioInputStream* stream);
 
   // Creates the output stream for the |AUDIO_PCM_LINEAR| format. The legacy
@@ skipping 24 matching lines @@
   // Get number of input or output streams.
   int input_stream_count() const {
     return static_cast<int>(input_streams_.size());
   }
   int output_stream_count() const { return num_output_streams_; }
 
  protected:
   AudioManagerBase(
       scoped_refptr<base::SingleThreadTaskRunner> task_runner,
       scoped_refptr<base::SingleThreadTaskRunner> worker_task_runner,
-      AudioLogFactory* audio_log_factory);
+      AudioLogFactory* audio_log_factory,
+      CreateAudioFileWriterCallback create_audio_file_writer_callback);
 
   // Releases all the audio output dispatchers.
   // All audio streams should be closed before Shutdown() is called.
   // This must be called in the destructor of every AudioManagerBase
   // implementation.
   void Shutdown();
 
   void SetMaxOutputStreamsAllowed(int max) { max_num_output_streams_ = max; }
 
   // Called by each platform specific AudioManager to notify output state change
@@ skipping 34 matching lines @@
 
   class CompareByParams;
 
   // These functions assign group ids to devices based on their device ids.
   // The default implementation is an attempt to do this based on
   // GetAssociatedOutputDeviceID. Must be called on the audio worker thread
   // (see GetTaskRunner()).
   std::string GetGroupIDOutput(const std::string& output_device_id);
   std::string GetGroupIDInput(const std::string& input_device_id);
 
+  base::FilePath GetDebugRecordingFileNameWithExtension(
+      const base::FilePath& file_name);
+
   // Max number of open output streams, modified by
   // SetMaxOutputStreamsAllowed().
   int max_num_output_streams_;
 
   // Max number of open input streams.
   int max_num_input_streams_;
 
   // Number of currently open output streams.
   int num_output_streams_;
 
   // Track output state change listeners.
   base::ObserverList<AudioDeviceListener> output_listeners_;
 
+  // Contains output resamplers. Used for controlling debug recording.
+  std::unordered_set<AudioOutputResampler*> output_resamplers_;
+
   // Contains currently open input streams.
   std::unordered_set<AudioInputStream*> input_streams_;
 
   // Map of cached AudioOutputDispatcher instances.  Must only be touched
   // from the audio thread (no locking).
   AudioOutputDispatchers output_dispatchers_;
 
   // Proxy for creating AudioLog objects.
   AudioLogFactory* const audio_log_factory_;
 
+  // Callback for creating AudioFileWriter objects.
+  CreateAudioFileWriterCallback create_audio_file_writer_callback_;
+
+  // The base file name for debug recording files. If this is non-empty, debug
+  // recording is enabled, otherwise disabled.
+  base::FilePath debug_recording_base_file_name_;
+
   DISALLOW_COPY_AND_ASSIGN(AudioManagerBase);
 };
 
 }  // namespace media
 
 #endif  // MEDIA_AUDIO_AUDIO_MANAGER_BASE_H_