src/media/audio/mac/audio_manager_mac.h

   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_MAC_AUDIO_MANAGER_MAC_H_
   6 #define MEDIA_AUDIO_MAC_AUDIO_MANAGER_MAC_H_
   7
   8 #include <CoreAudio/AudioHardware.h>
   9 #include <list>
  10 #include <string>
  11
  12 #include "base/basictypes.h"
  13 #include "base/compiler_specific.h"
  14 #include "media/audio/audio_manager_base.h"
  15 #include "media/audio/mac/audio_device_listener_mac.h"
  16
  17 namespace media {
  18
  19 // Mac OS X implementation of the AudioManager singleton. This class is internal
  20 // to the audio output and only internal users can call methods not exposed by
  21 // the AudioManager class.
  22 class MEDIA_EXPORT AudioManagerMac : public AudioManagerBase {
  23  public:
  24   AudioManagerMac(AudioLogFactory* audio_log_factory);
  25
  26   // Implementation of AudioManager.
  27   virtual bool HasAudioOutputDevices() OVERRIDE;
  28   virtual bool HasAudioInputDevices() OVERRIDE;
  29   virtual void GetAudioInputDeviceNames(
  30       AudioDeviceNames* device_names) OVERRIDE;
  31   virtual void GetAudioOutputDeviceNames(
  32       AudioDeviceNames* device_names) OVERRIDE;
  33   virtual AudioParameters GetInputStreamParameters(
  34       const std::string& device_id) OVERRIDE;
  35   virtual std::string GetAssociatedOutputDeviceID(
  36       const std::string& input_device_id) OVERRIDE;
  37
  38   // Implementation of AudioManagerBase.
  39   virtual AudioOutputStream* MakeLinearOutputStream(
  40       const AudioParameters& params) OVERRIDE;
  41   virtual AudioOutputStream* MakeLowLatencyOutputStream(
  42       const AudioParameters& params,
  43       const std::string& device_id) OVERRIDE;
  44   virtual AudioInputStream* MakeLinearInputStream(
  45       const AudioParameters& params, const std::string& device_id) OVERRIDE;
  46   virtual AudioInputStream* MakeLowLatencyInputStream(
  47       const AudioParameters& params, const std::string& device_id) OVERRIDE;
  48   virtual std::string GetDefaultOutputDeviceID() OVERRIDE;
  49
  50   // Used to track destruction of input and output streams.
  51   virtual void ReleaseOutputStream(AudioOutputStream* stream) OVERRIDE;
  52   virtual void ReleaseInputStream(AudioInputStream* stream) OVERRIDE;
  53
  54   static bool GetDefaultInputDevice(AudioDeviceID* device);
  55   static bool GetDefaultOutputDevice(AudioDeviceID* device);
  56   static bool GetDefaultDevice(AudioDeviceID* device, bool input);
  57
  58   static bool GetDefaultOutputChannels(int* channels);
  59
  60   static bool GetDeviceChannels(AudioDeviceID device,
  61                                 AudioObjectPropertyScope scope,
  62                                 int* channels);
  63
  64   static int HardwareSampleRateForDevice(AudioDeviceID device_id);
  65   static int HardwareSampleRate();
  66
  67   // OSX has issues with starting streams as the sytem goes into suspend and
  68   // immediately after it wakes up from resume.  See http://crbug.com/160920.
  69   // As a workaround we delay Start() when it occurs after suspend and for a
  70   // small amount of time after resume.
  71   //
  72   // Streams should consult ShouldDeferStreamStart() and if true check the value
  73   // again after |kStartDelayInSecsForPowerEvents| has elapsed. If false, the
  74   // stream may be started immediately.
  75   enum { kStartDelayInSecsForPowerEvents = 1 };
  76   bool ShouldDeferStreamStart();
  77
  78  protected:
  79   virtual ~AudioManagerMac();
  80
  81   virtual AudioParameters GetPreferredOutputStreamParameters(
  82       const std::string& output_device_id,
  83       const AudioParameters& input_params) OVERRIDE;
  84
  85  private:
  86   void InitializeOnAudioThread();
  87   void ShutdownOnAudioThread();
  88
  89   int ChooseBufferSize(int output_sample_rate);
  90
  91   // Notify streams of a device change if the default output device or its
  92   // sample rate has changed, otherwise does nothing.
  93   void HandleDeviceChanges();
  94
  95   scoped_ptr<AudioDeviceListenerMac> output_device_listener_;
  96
  97   // Track the output sample-rate and the default output device
  98   // so we can intelligently handle device notifications only when necessary.
  99   int current_sample_rate_;
 100   AudioDeviceID current_output_device_;
 101
 102   // Helper class which monitors power events to determine if output streams
 103   // should defer Start() calls.  Required to workaround an OSX bug.  See
 104   // http://crbug.com/160920 for more details.
 105   class AudioPowerObserver;
 106   scoped_ptr<AudioPowerObserver> power_observer_;
 107
 108   // Tracks all constructed input and output streams so they can be stopped at
 109   // shutdown.  See ShutdownOnAudioThread() for more details.
 110   std::list<AudioInputStream*> input_streams_;
 111   std::list<AudioOutputStream*> output_streams_;
 112
 113   DISALLOW_COPY_AND_ASSIGN(AudioManagerMac);
 114 };
 115
 116 }  // namespace media
 117
 118 #endif  // MEDIA_AUDIO_MAC_AUDIO_MANAGER_MAC_H_