Audaspace  1.4.0
A high level audio library.
PulseAudioDevice.h
Go to the documentation of this file.
1 /*******************************************************************************
2  * Copyright 2009-2016 Jörg Müller
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  * http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  ******************************************************************************/
16 
17 #pragma once
18 
19 #ifdef PULSEAUDIO_PLUGIN
20 #define AUD_BUILD_PLUGIN
21 #endif
22 
29 #include "devices/SoftwareDevice.h"
30 #include "util/RingBuffer.h"
31 
32 #include <condition_variable>
33 #include <thread>
34 
35 #include <pulse/pulseaudio.h>
36 
38 
43 {
44 private:
45  class PulseAudioSynchronizer : public DefaultSynchronizer
46  {
47  PulseAudioDevice* m_device;
48 
49  public:
50  PulseAudioSynchronizer(PulseAudioDevice* device);
51 
52  virtual double getPosition(std::shared_ptr<IHandle> handle);
53  };
54 
56  PulseAudioSynchronizer m_synchronizer;
57 
61  volatile bool m_playback;
62 
63  pa_threaded_mainloop* m_mainloop;
64  pa_context* m_context;
65  pa_stream* m_stream;
66  pa_context_state_t m_state;
67 
71  RingBuffer m_ring_buffer;
72 
76  bool m_valid;
77 
78  int m_buffersize;
79  uint32_t m_underflows;
80 
84  std::thread m_mixingThread;
85 
89  std::mutex m_mixingLock;
90 
94  std::condition_variable m_mixingCondition;
95 
99  AUD_LOCAL void updateRingBuffer();
100 
106  AUD_LOCAL static void PulseAudio_state_callback(pa_context* context, void* data);
107 
114  AUD_LOCAL static void PulseAudio_request(pa_stream* stream, size_t total_bytes, void* data);
115 
116  // delete copy constructor and operator=
117  PulseAudioDevice(const PulseAudioDevice&) = delete;
118  PulseAudioDevice& operator=(const PulseAudioDevice&) = delete;
119 
120 protected:
121  virtual void playing(bool playing);
122 
123 public:
131  PulseAudioDevice(std::string name, DeviceSpecs specs, int buffersize = AUD_DEFAULT_BUFFER_SIZE);
132 
136  virtual ~PulseAudioDevice();
137 
138  virtual ISynchronizer* getSynchronizer();
139 
143  static void registerPlugin();
144 };
145 
#define AUD_NAMESPACE_BEGIN
Opens the audaspace namespace aud.
Definition: Audaspace.h:116
The RingBuffer class.
This class enables global synchronization of several audio applications if supported.
Definition: ISynchronizer.h:38
virtual ISynchronizer * getSynchronizer()
Retrieves the synchronizer for this device, which enables accurate synchronization between audio play...
#define AUD_DEFAULT_BUFFER_SIZE
The default playback buffer size of a device.
Definition: Audaspace.h:103
virtual void playing(bool playing)=0
This function tells the device, to start or pause playback.
Specification of a sound device.
Definition: Specification.h:119
This device plays back through PulseAudio, the simple direct media layer.
Definition: PulseAudioDevice.h:42
#define AUD_NAMESPACE_END
Closes the audaspace namespace aud.
Definition: Audaspace.h:119
#define AUD_PLUGIN_API
Used for exporting symbols in the shared library.
Definition: Audaspace.h:94
The software device is a generic device with software mixing.
Definition: SoftwareDevice.h:51
#define AUD_LOCAL
Used for hiding symbols from export in the shared library.
Definition: Audaspace.h:80
This class is a simple ring buffer in RAM which is 32 Byte aligned and provides functionality for con...
Definition: RingBuffer.h:36
This class is a default ISynchronizer implementation that actually does no synchronization and is int...
Definition: DefaultSynchronizer.h:33
The SoftwareDevice class.