| OLD | NEW |
| 1 // Copyright (c) 2012 The Chromium Authors. All rights reserved. | 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 | 2 // Use of this source code is governed by a BSD-style license that can be |
| 3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
| 4 // | 4 // |
| 5 // Audio rendering unit utilizing audio output stream provided by browser | 5 // Audio rendering unit utilizing audio output stream provided by browser |
| 6 // process through IPC. | 6 // process through IPC. |
| 7 // | 7 // |
| 8 // Relationship of classes. | 8 // Relationship of classes. |
| 9 // | 9 // |
| 10 // AudioOutputController AudioOutputDevice | 10 // AudioOutputController AudioOutputDevice |
| (...skipping 56 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 67 #include "media/audio/audio_device_thread.h" | 67 #include "media/audio/audio_device_thread.h" |
| 68 #include "media/audio/audio_output_ipc.h" | 68 #include "media/audio/audio_output_ipc.h" |
| 69 #include "media/audio/audio_parameters.h" | 69 #include "media/audio/audio_parameters.h" |
| 70 #include "media/audio/scoped_loop_observer.h" | 70 #include "media/audio/scoped_loop_observer.h" |
| 71 #include "media/base/audio_renderer_sink.h" | 71 #include "media/base/audio_renderer_sink.h" |
| 72 | 72 |
| 73 namespace media { | 73 namespace media { |
| 74 | 74 |
| 75 class MEDIA_EXPORT AudioOutputDevice | 75 class MEDIA_EXPORT AudioOutputDevice |
| 76 : NON_EXPORTED_BASE(public AudioRendererSink), | 76 : NON_EXPORTED_BASE(public AudioRendererSink), |
| 77 public AudioOutputIPCDelegate, | 77 NON_EXPORTED_BASE(public AudioOutputIPCDelegate), |
| 78 NON_EXPORTED_BASE(public ScopedLoopObserver) { | 78 NON_EXPORTED_BASE(public ScopedLoopObserver) { |
| 79 public: | 79 public: |
| 80 // NOTE: Clients must call Initialize() before using. |
| 81 AudioOutputDevice(scoped_ptr<AudioOutputIPC> ipc, |
| 82 const scoped_refptr<base::MessageLoopProxy>& io_loop); |
| 83 |
| 80 // AudioRendererSink implementation. | 84 // AudioRendererSink implementation. |
| 81 virtual void Initialize(const AudioParameters& params, | 85 virtual void Initialize(const AudioParameters& params, |
| 82 RenderCallback* callback) OVERRIDE; | 86 RenderCallback* callback) OVERRIDE; |
| 83 virtual void Start() OVERRIDE; | 87 virtual void Start() OVERRIDE; |
| 84 virtual void Stop() OVERRIDE; | 88 virtual void Stop() OVERRIDE; |
| 85 virtual void Play() OVERRIDE; | 89 virtual void Play() OVERRIDE; |
| 86 virtual void Pause() OVERRIDE; | 90 virtual void Pause() OVERRIDE; |
| 87 virtual bool SetVolume(double volume) OVERRIDE; | 91 virtual bool SetVolume(double volume) OVERRIDE; |
| 88 | 92 |
| 89 // Methods called on IO thread ---------------------------------------------- | 93 // Methods called on IO thread ---------------------------------------------- |
| 90 // AudioOutputIPCDelegate methods. | 94 // AudioOutputIPCDelegate methods. |
| 91 virtual void OnStateChanged(AudioOutputIPCDelegate::State state) OVERRIDE; | 95 virtual void OnStateChanged(AudioOutputIPCDelegate::State state) OVERRIDE; |
| 92 virtual void OnStreamCreated(base::SharedMemoryHandle handle, | 96 virtual void OnStreamCreated(base::SharedMemoryHandle handle, |
| 93 base::SyncSocket::Handle socket_handle, | 97 base::SyncSocket::Handle socket_handle, |
| 94 int length) OVERRIDE; | 98 int length) OVERRIDE; |
| 95 virtual void OnIPCClosed() OVERRIDE; | 99 virtual void OnIPCClosed() OVERRIDE; |
| 96 | 100 |
| 97 // Creates an uninitialized AudioOutputDevice. Clients must call Initialize() | |
| 98 // before using. | |
| 99 AudioOutputDevice(AudioOutputIPC* ipc, | |
| 100 const scoped_refptr<base::MessageLoopProxy>& io_loop); | |
| 101 | |
| 102 protected: | 101 protected: |
| 103 // Magic required by ref_counted.h to avoid any code deleting the object | 102 // Magic required by ref_counted.h to avoid any code deleting the object |
| 104 // accidentally while there are references to it. | 103 // accidentally while there are references to it. |
| 105 friend class base::RefCountedThreadSafe<AudioOutputDevice>; | 104 friend class base::RefCountedThreadSafe<AudioOutputDevice>; |
| 106 virtual ~AudioOutputDevice(); | 105 virtual ~AudioOutputDevice(); |
| 107 | 106 |
| 108 // Accessors for subclasses (via IO thread only). | |
| 109 int stream_id() const { return stream_id_; } | |
| 110 AudioOutputIPC* audio_output_ipc() const { return ipc_; } | |
| 111 | |
| 112 private: | 107 private: |
| 113 // Note: The ordering of members in this enum is critical to correct behavior! | 108 // Note: The ordering of members in this enum is critical to correct behavior! |
| 114 enum State { | 109 enum State { |
| 115 IPC_CLOSED, // No more IPCs can take place. | 110 IPC_CLOSED, // No more IPCs can take place. |
| 116 IDLE, // Not started. | 111 IDLE, // Not started. |
| 117 CREATING_STREAM, // Waiting for OnStreamCreated() to be called back. | 112 CREATING_STREAM, // Waiting for OnStreamCreated() to be called back. |
| 118 PAUSED, // Paused. OnStreamCreated() has been called. Can Play()/Stop(). | 113 PAUSED, // Paused. OnStreamCreated() has been called. Can Play()/Stop(). |
| 119 PLAYING, // Playing back. Can Pause()/Stop(). | 114 PLAYING, // Playing back. Can Pause()/Stop(). |
| 120 }; | 115 }; |
| 121 | 116 |
| 122 // Methods called on IO thread ---------------------------------------------- | 117 // Methods called on IO thread ---------------------------------------------- |
| 123 // The following methods are tasks posted on the IO thread that needs to | 118 // The following methods are tasks posted on the IO thread that need to |
| 124 // be executed on that thread. They interact with AudioMessageFilter and | 119 // be executed on that thread. They use AudioOutputIPC to send IPC messages |
| 125 // sends IPC messages on that thread. | 120 // upon state changes. |
| 126 void CreateStreamOnIOThread(const AudioParameters& params); | 121 void CreateStreamOnIOThread(const AudioParameters& params); |
| 127 void PlayOnIOThread(); | 122 void PlayOnIOThread(); |
| 128 void PauseOnIOThread(); | 123 void PauseOnIOThread(); |
| 129 void ShutDownOnIOThread(); | 124 void ShutDownOnIOThread(); |
| 130 void SetVolumeOnIOThread(double volume); | 125 void SetVolumeOnIOThread(double volume); |
| 131 | 126 |
| 132 // MessageLoop::DestructionObserver implementation for the IO loop. | 127 // MessageLoop::DestructionObserver implementation for the IO loop. |
| 133 // If the IO loop dies before we do, we shut down the audio thread from here. | 128 // If the IO loop dies before we do, we shut down the audio thread from here. |
| 134 virtual void WillDestroyCurrentMessageLoop() OVERRIDE; | 129 virtual void WillDestroyCurrentMessageLoop() OVERRIDE; |
| 135 | 130 |
| 136 AudioParameters audio_parameters_; | 131 AudioParameters audio_parameters_; |
| 137 | 132 |
| 138 RenderCallback* callback_; | 133 RenderCallback* callback_; |
| 139 | 134 |
| 140 // A pointer to the IPC layer that takes care of sending requests over to | 135 // A pointer to the IPC layer that takes care of sending requests over to |
| 141 // the AudioRendererHost. | 136 // the AudioRendererHost. Only valid when state_ != IPC_CLOSED and must only |
| 142 AudioOutputIPC* ipc_; | 137 // be accessed on the IO thread. |
| 143 | 138 scoped_ptr<AudioOutputIPC> ipc_; |
| 144 // Our stream ID on the message filter. Only accessed on the IO thread. | |
| 145 // Must only be modified on the IO thread. | |
| 146 int stream_id_; | |
| 147 | 139 |
| 148 // Current state (must only be accessed from the IO thread). See comments for | 140 // Current state (must only be accessed from the IO thread). See comments for |
| 149 // State enum above. | 141 // State enum above. |
| 150 State state_; | 142 State state_; |
| 151 | 143 |
| 152 // State of Play() / Pause() calls before OnStreamCreated() is called. | 144 // State of Play() / Pause() calls before OnStreamCreated() is called. |
| 153 bool play_on_start_; | 145 bool play_on_start_; |
| 154 | 146 |
| 155 // Our audio thread callback class. See source file for details. | 147 // Our audio thread callback class. See source file for details. |
| 156 class AudioThreadCallback; | 148 class AudioThreadCallback; |
| (...skipping 11 matching lines...) Expand all Loading... |
| 168 // TODO(scherkus): Replace this by changing AudioRendererSink to either accept | 160 // TODO(scherkus): Replace this by changing AudioRendererSink to either accept |
| 169 // the callback via Start(). See http://crbug.com/151051 for details. | 161 // the callback via Start(). See http://crbug.com/151051 for details. |
| 170 bool stopping_hack_; | 162 bool stopping_hack_; |
| 171 | 163 |
| 172 DISALLOW_COPY_AND_ASSIGN(AudioOutputDevice); | 164 DISALLOW_COPY_AND_ASSIGN(AudioOutputDevice); |
| 173 }; | 165 }; |
| 174 | 166 |
| 175 } // namespace media | 167 } // namespace media |
| 176 | 168 |
| 177 #endif // MEDIA_AUDIO_AUDIO_OUTPUT_DEVICE_H_ | 169 #endif // MEDIA_AUDIO_AUDIO_OUTPUT_DEVICE_H_ |
| OLD | NEW |