OLD | NEW |
| (Empty) |
1 // Copyright (c) 2011 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 CONTENT_RENDERER_AUDIO_DEVICE_H_ | |
6 #define CONTENT_RENDERER_AUDIO_DEVICE_H_ | |
7 #pragma once | |
8 | |
9 #include <vector> | |
10 | |
11 #include "base/basictypes.h" | |
12 #include "base/memory/scoped_ptr.h" | |
13 #include "base/shared_memory.h" | |
14 #include "base/threading/simple_thread.h" | |
15 #include "content/renderer/audio_message_filter.h" | |
16 | |
17 struct AudioParameters; | |
18 | |
19 // Each instance of AudioDevice corresponds to one host stream. | |
20 // This class is not thread-safe, so its methods must be called from | |
21 // the same thread. | |
22 class AudioDevice : public AudioMessageFilter::Delegate, | |
23 public base::DelegateSimpleThread::Delegate, | |
24 public base::RefCountedThreadSafe<AudioDevice> { | |
25 public: | |
26 class RenderCallback { | |
27 public: | |
28 virtual void Render(const std::vector<float*>& audio_data, | |
29 size_t number_of_frames, | |
30 size_t audio_delay_milliseconds) = 0; | |
31 protected: | |
32 virtual ~RenderCallback() {} | |
33 }; | |
34 | |
35 // |buffer_size| is the number of sample-frames. | |
36 AudioDevice(size_t buffer_size, | |
37 int channels, | |
38 double sample_rate, | |
39 RenderCallback* callback); | |
40 virtual ~AudioDevice(); | |
41 | |
42 // Starts audio playback. Returns |true| on success. | |
43 bool Start(); | |
44 | |
45 // Stops audio playback. Returns |true| on success. | |
46 bool Stop(); | |
47 | |
48 // Sets the playback volume, with range [0.0, 1.0] inclusive. | |
49 // Returns |true| on success. | |
50 bool SetVolume(double volume); | |
51 | |
52 // Gets the playback volume, with range [0.0, 1.0] inclusive. | |
53 // Returns |true| on success. | |
54 bool GetVolume(double* volume); | |
55 | |
56 double sample_rate() const { return sample_rate_; } | |
57 size_t buffer_size() const { return buffer_size_; } | |
58 | |
59 private: | |
60 // I/O thread backends to above functions. | |
61 void InitializeOnIOThread(const AudioParameters& params); | |
62 void StartOnIOThread(); | |
63 void ShutDownOnIOThread(); | |
64 void SetVolumeOnIOThread(double volume); | |
65 | |
66 // AudioMessageFilter::Delegate implementation. | |
67 virtual void OnRequestPacket(AudioBuffersState buffers_state); | |
68 virtual void OnStateChanged(AudioStreamState state); | |
69 virtual void OnCreated(base::SharedMemoryHandle handle, uint32 length); | |
70 virtual void OnLowLatencyCreated(base::SharedMemoryHandle handle, | |
71 base::SyncSocket::Handle socket_handle, | |
72 uint32 length); | |
73 virtual void OnVolume(double volume); | |
74 | |
75 // DelegateSimpleThread::Delegate implementation. | |
76 virtual void Run(); | |
77 | |
78 // Format | |
79 size_t buffer_size_; // in sample-frames | |
80 int channels_; | |
81 int bits_per_sample_; | |
82 double sample_rate_; | |
83 | |
84 // Calls the client's callback for rendering audio. | |
85 void FireRenderCallback(); | |
86 RenderCallback* callback_; | |
87 | |
88 // The client callback renders audio into here. | |
89 std::vector<float*> audio_data_; | |
90 | |
91 // The client stores the last reported audio delay in this member. | |
92 // The delay shall reflect the amount of audio which still resides in | |
93 // the output buffer, i.e., the expected audio output delay. | |
94 int audio_delay_milliseconds_; | |
95 | |
96 // The current volume scaling [0.0, 1.0] of the audio stream. | |
97 double volume_; | |
98 | |
99 // Callbacks for rendering audio occur on this thread. | |
100 scoped_ptr<base::DelegateSimpleThread> audio_thread_; | |
101 | |
102 // IPC message stuff. | |
103 base::SharedMemory* shared_memory() { return shared_memory_.get(); } | |
104 base::SyncSocket* socket() { return socket_.get(); } | |
105 void* shared_memory_data() { return shared_memory()->memory(); } | |
106 | |
107 // MessageFilter used to send/receive IPC. THIS MUST ONLY BE ACCESSED ON THE | |
108 // I/O thread except to send messages and get the message loop. | |
109 static scoped_refptr<AudioMessageFilter> filter_; | |
110 | |
111 // Our ID on the message filter. THIS MUST ONLY BE ACCESSED ON THE I/O THREAD | |
112 // or else you could race with the initialize function which sets it. | |
113 int32 stream_id_; | |
114 | |
115 scoped_ptr<base::SharedMemory> shared_memory_; | |
116 scoped_ptr<base::SyncSocket> socket_; | |
117 | |
118 DISALLOW_COPY_AND_ASSIGN(AudioDevice); | |
119 }; | |
120 | |
121 #endif // CONTENT_RENDERER_AUDIO_DEVICE_H_ | |
OLD | NEW |