Audaspace  1.6.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  bool m_playing = false;
49  pa_usec_t m_time_start = 0;
50  double m_seek_pos = 0.0f;
51 
52  public:
53  PulseAudioSynchronizer(PulseAudioDevice* device);
54 
55  virtual void play();
56  virtual void stop();
57  virtual void seek(std::shared_ptr<IHandle> handle, double time);
58  virtual double getPosition(std::shared_ptr<IHandle> handle);
59  };
60 
62  PulseAudioSynchronizer m_synchronizer;
63 
67  volatile bool m_playback;
68 
69  bool m_corked;
70 
71  pa_threaded_mainloop* m_mainloop;
72  pa_context* m_context;
73  pa_stream* m_stream;
74  pa_context_state_t m_state;
75 
79  RingBuffer m_ring_buffer;
80 
84  bool m_valid;
85 
86  int m_buffersize;
87  uint32_t m_underflows;
88 
92  std::thread m_mixingThread;
93 
97  std::mutex m_mixingLock;
98 
102  std::condition_variable m_mixingCondition;
103 
107  AUD_LOCAL void updateRingBuffer();
108 
114  AUD_LOCAL static void PulseAudio_state_callback(pa_context* context, void* data);
115 
122  AUD_LOCAL static void PulseAudio_request(pa_stream* stream, size_t total_bytes, void* data);
123 
124  // delete copy constructor and operator=
125  PulseAudioDevice(const PulseAudioDevice&) = delete;
126  PulseAudioDevice& operator=(const PulseAudioDevice&) = delete;
127 
128 protected:
129  virtual void playing(bool playing);
130 
131 public:
139  PulseAudioDevice(const std::string &name, DeviceSpecs specs, int buffersize = AUD_DEFAULT_BUFFER_SIZE);
140 
144  virtual ~PulseAudioDevice();
145 
146  virtual ISynchronizer* getSynchronizer();
147 
151  static void registerPlugin();
152 };
153 
#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:128
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.