Index: media/audio/audio_manager.h |
=================================================================== |
--- media/audio/audio_manager.h (revision 57255) |
+++ media/audio/audio_manager.h (working copy) |
@@ -1,101 +0,0 @@ |
-// Copyright (c) 2010 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_H_ |
-#define MEDIA_AUDIO_AUDIO_MANAGER_H_ |
- |
-#include "base/basictypes.h" |
- |
-class AudioInputStream; |
-class AudioOutputStream; |
-class MessageLoop; |
- |
-// Manages all audio resources. In particular it owns the AudioOutputStream |
-// objects. Provides some convenience functions that avoid the need to provide |
-// iterators over the existing streams. |
-class AudioManager { |
- public: |
- enum Format { |
- AUDIO_PCM_LINEAR = 0, // PCM is 'raw' amplitude samples. |
- AUDIO_PCM_LOW_LATENCY, // Linear PCM, low latency requested. |
- AUDIO_MOCK, // Creates a dummy AudioOutputStream object. |
- AUDIO_LAST_FORMAT // Only used for validation of format. |
- }; |
- |
- // Telephone quality sample rate, mostly for speech-only audio. |
- static const uint32 kTelephoneSampleRate = 8000; |
- // CD sampling rate is 44.1 KHz or conveniently 2x2x3x3x5x5x7x7. |
- static const uint32 kAudioCDSampleRate = 44100; |
- // Digital Audio Tape sample rate. |
- static const uint32 kAudioDATSampleRate = 48000; |
- |
- // Returns true if the OS reports existence of audio devices. This does not |
- // guarantee that the existing devices support all formats and sample rates. |
- virtual bool HasAudioOutputDevices() = 0; |
- |
- // Returns true if the OS reports existence of audio recording devices. This |
- // does not guarantee that the existing devices support all formats and |
- // sample rates. |
- virtual bool HasAudioInputDevices() = 0; |
- |
- // Factory for all the supported stream formats. The |channels| can be 1 to 5. |
- // The |sample_rate| is in hertz and can be any value supported by the |
- // platform. For some future formats the |sample_rate| and |bits_per_sample| |
- // can take special values. |
- // Returns NULL if the combination of the parameters is not supported, or if |
- // we have reached some other platform specific limit. |
- // |
- // AUDIO_PCM_LOW_LATENCY can be passed to this method and it has two effects: |
- // 1- Instead of triple buffered the audio will be double buffered. |
- // 2- A low latency driver or alternative audio subsystem will be used when |
- // available. |
- // |
- // Do not free the returned AudioOutputStream. It is owned by AudioManager. |
- virtual AudioOutputStream* MakeAudioOutputStream(Format format, int channels, |
- int sample_rate, |
- char bits_per_sample) = 0; |
- |
- // Factory to create audio recording streams. |
- // |channels| can be 1 or 2. |
- // |sample_rate| is in hertz and can be any value supported by the platform. |
- // |bits_per_sample| can be any value supported by the platform. |
- // |samples_per_packet| is in hertz as well and can be 0 to |sample_rate|, |
- // with 0 suggesting that the implementation use a default value for that |
- // platform. |
- // Returns NULL if the combination of the parameters is not supported, or if |
- // we have reached some other platform specific limit. |
- // |
- // Do not free the returned AudioInputStream. It is owned by AudioManager. |
- // When you are done with it, call |Stop()| and |Close()| to release it. |
- virtual AudioInputStream* MakeAudioInputStream(Format format, int channels, |
- int sample_rate, |
- char bits_per_sample, |
- uint32 samples_per_packet) = 0; |
- |
- // Muting continues playback but effectively the volume is set to zero. |
- // Un-muting returns the volume to the previous level. |
- virtual void MuteAll() = 0; |
- virtual void UnMuteAll() = 0; |
- |
- // Returns message loop used for audio IO. |
- virtual MessageLoop* GetMessageLoop() = 0; |
- |
- // Get AudioManager singleton. |
- // TODO(cpu): Define threading requirements for interacting with AudioManager. |
- static AudioManager* GetAudioManager(); |
- |
- protected: |
- virtual ~AudioManager() {} |
- |
- // Called from GetAudioManager() to initialiaze the instance. |
- virtual void Init() = 0; |
- |
- private: |
- static void Destroy(void*); |
- |
- // Called by GetAudioManager() to create platform-specific audio manager. |
- static AudioManager* CreateAudioManager(); |
-}; |
- |
-#endif // MEDIA_AUDIO_AUDIO_MANAGER_H_ |