audio_output_resampler.h revision 5d1f7b1de12d16ceb2c938c56701a3e8bfa558f7
1// Copyright (c) 2012 The Chromium Authors. All rights reserved. 2// Use of this source code is governed by a BSD-style license that can be 3// found in the LICENSE file. 4 5#ifndef MEDIA_AUDIO_AUDIO_OUTPUT_RESAMPLER_H_ 6#define MEDIA_AUDIO_AUDIO_OUTPUT_RESAMPLER_H_ 7 8#include <map> 9 10#include "base/basictypes.h" 11#include "base/memory/ref_counted.h" 12#include "base/time/time.h" 13#include "media/audio/audio_io.h" 14#include "media/audio/audio_manager.h" 15#include "media/audio/audio_output_dispatcher.h" 16#include "media/audio/audio_parameters.h" 17 18namespace media { 19 20class OnMoreDataConverter; 21 22// AudioOutputResampler is a browser-side resampling and buffering solution 23// which ensures audio data is always output at given parameters. See the 24// AudioConverter class for details on the conversion process. 25// 26// AOR works by intercepting the AudioSourceCallback provided to StartStream() 27// and redirecting it through an AudioConverter instance. AudioBuffersState is 28// adjusted for buffer delay caused by the conversion process. 29// 30// AOR will automatically fall back from AUDIO_PCM_LOW_LATENCY to 31// AUDIO_PCM_LINEAR if the output device fails to open at the requested output 32// parameters. 33// 34// TODO(dalecurtis): Ideally the low latency path will be as reliable as the 35// high latency path once we have channel mixing and support querying for the 36// hardware's configured bit depth. Monitor the UMA stats for fallback and 37// remove fallback support once it's stable. http://crbug.com/148418 38class MEDIA_EXPORT AudioOutputResampler : public AudioOutputDispatcher { 39 public: 40 AudioOutputResampler(AudioManager* audio_manager, 41 const AudioParameters& input_params, 42 const AudioParameters& output_params, 43 const std::string& output_device_id, 44 const base::TimeDelta& close_delay); 45 46 // AudioOutputDispatcher interface. 47 virtual bool OpenStream() OVERRIDE; 48 virtual bool StartStream(AudioOutputStream::AudioSourceCallback* callback, 49 AudioOutputProxy* stream_proxy) OVERRIDE; 50 virtual void StopStream(AudioOutputProxy* stream_proxy) OVERRIDE; 51 virtual void StreamVolumeSet(AudioOutputProxy* stream_proxy, 52 double volume) OVERRIDE; 53 virtual void CloseStream(AudioOutputProxy* stream_proxy) OVERRIDE; 54 virtual void Shutdown() OVERRIDE; 55 virtual void CloseStreamsForWedgeFix() OVERRIDE; 56 virtual void RestartStreamsForWedgeFix() OVERRIDE; 57 58 private: 59 friend class base::RefCountedThreadSafe<AudioOutputResampler>; 60 virtual ~AudioOutputResampler(); 61 62 // Converts low latency based output parameters into high latency 63 // appropriate output parameters in error situations. 64 void SetupFallbackParams(); 65 66 // Used to initialize and reinitialize |dispatcher_|. 67 void Initialize(); 68 69 // Dispatcher to proxy all AudioOutputDispatcher calls too. 70 scoped_refptr<AudioOutputDispatcher> dispatcher_; 71 72 // Map of outstanding OnMoreDataConverter objects. A new object is created 73 // on every StartStream() call and destroyed on CloseStream(). 74 typedef std::map<AudioOutputProxy*, OnMoreDataConverter*> CallbackMap; 75 CallbackMap callbacks_; 76 77 // Used by AudioOutputDispatcherImpl; kept so we can reinitialize on the fly. 78 base::TimeDelta close_delay_; 79 80 // AudioParameters used to setup the output stream. 81 AudioParameters output_params_; 82 83 // Whether any streams have been opened through |dispatcher_|, if so we can't 84 // fallback on future OpenStream() failures. 85 bool streams_opened_; 86 87 DISALLOW_COPY_AND_ASSIGN(AudioOutputResampler); 88}; 89 90} // namespace media 91 92#endif // MEDIA_AUDIO_AUDIO_OUTPUT_RESAMPLER_H_ 93