• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 // Copyright 2013 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_SOUNDS_AUDIO_STREAM_HANDLER_H_
6 #define MEDIA_AUDIO_SOUNDS_AUDIO_STREAM_HANDLER_H_
7 
8 #include "base/basictypes.h"
9 #include "base/compiler_specific.h"
10 #include "base/strings/string_piece.h"
11 #include "base/threading/non_thread_safe.h"
12 #include "media/audio/audio_io.h"
13 #include "media/audio/audio_parameters.h"
14 #include "media/audio/sounds/wav_audio_handler.h"
15 #include "media/base/media_export.h"
16 
17 namespace media {
18 
19 class AudioManager;
20 
21 // This class sends a sound to the audio manager.
22 class MEDIA_EXPORT AudioStreamHandler : public base::NonThreadSafe {
23  public:
24   class TestObserver {
25    public:
~TestObserver()26     virtual ~TestObserver() {}
27 
28     // Following methods will be called only from the audio thread.
29 
30     // Called when AudioOutputStreamProxy::Start() was successfully called.
31     virtual void OnPlay() = 0;
32 
33     // Called when AudioOutputStreamProxy::Stop() was successfully called.
34     virtual void OnStop(size_t cursor) = 0;
35   };
36 
37   // C-tor for AudioStreamHandler. |wav_data| should be a raw
38   // uncompressed WAVE data which will be sent to the audio manager.
39   explicit AudioStreamHandler(const base::StringPiece& wav_data);
40   virtual ~AudioStreamHandler();
41 
42   // Returns true iff AudioStreamHandler is correctly initialized;
43   bool IsInitialized() const;
44 
45   // Stops any previous playback if it's still not completed and
46   // starts new playback. Volume level will be set according to
47   // current settings and won't be changed during playback. Returns
48   // true iff new playback was successfully started.
49   bool Play();
50 
51   // Stops current playback.
52   void Stop();
53 
wav_audio_handler()54   const WavAudioHandler& wav_audio_handler() const { return wav_audio_; }
55 
56  private:
57   friend class AudioStreamHandlerTest;
58   friend class SoundsManagerTest;
59 
60   class AudioStreamContainer;
61 
62   static void SetObserverForTesting(TestObserver* observer);
63   static void SetAudioSourceForTesting(
64       AudioOutputStream::AudioSourceCallback* source);
65 
66   WavAudioHandler wav_audio_;
67   scoped_ptr<AudioStreamContainer> stream_;
68 
69   bool initialized_;
70 
71   DISALLOW_COPY_AND_ASSIGN(AudioStreamHandler);
72 };
73 
74 }  // namespace media
75 
76 #endif  // MEDIA_AUDIO_SOUNDS_AUDIO_STREAM_HANDLER_H_
77