| 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 #include "media/audio/pulse/pulse_output.h" | |
| 6 | |
| 7 #include "base/bind.h" | |
| 8 #include "base/message_loop.h" | |
| 9 #include "media/audio/audio_parameters.h" | |
| 10 #include "media/audio/audio_util.h" | |
| 11 #if defined(OS_LINUX) | |
| 12 #include "media/audio/linux/audio_manager_linux.h" | |
| 13 #elif defined(OS_OPENBSD) | |
| 14 #include "media/audio/openbsd/audio_manager_openbsd.h" | |
| 15 #endif | |
| 16 #include "media/base/data_buffer.h" | |
| 17 #include "media/base/seekable_buffer.h" | |
| 18 | |
| 19 static pa_sample_format_t BitsToPASampleFormat(int bits_per_sample) { | |
| 20 switch (bits_per_sample) { | |
| 21 // Unsupported sample formats shown for reference. I am assuming we want | |
| 22 // signed and little endian because that is what we gave to ALSA. | |
| 23 case 8: | |
| 24 return PA_SAMPLE_U8; | |
| 25 // Also 8-bits: PA_SAMPLE_ALAW and PA_SAMPLE_ULAW | |
| 26 case 16: | |
| 27 return PA_SAMPLE_S16LE; | |
| 28 // Also 16-bits: PA_SAMPLE_S16BE (big endian). | |
| 29 case 24: | |
| 30 return PA_SAMPLE_S24LE; | |
| 31 // Also 24-bits: PA_SAMPLE_S24BE (big endian). | |
| 32 // Other cases: PA_SAMPLE_24_32LE (in LSB of 32-bit field, little endian), | |
| 33 // and PA_SAMPLE_24_32BE (in LSB of 32-bit field, big endian), | |
| 34 case 32: | |
| 35 return PA_SAMPLE_S32LE; | |
| 36 // Also 32-bits: PA_SAMPLE_S32BE (big endian), | |
| 37 // PA_SAMPLE_FLOAT32LE (floating point little endian), | |
| 38 // and PA_SAMPLE_FLOAT32BE (floating point big endian). | |
| 39 default: | |
| 40 return PA_SAMPLE_INVALID; | |
| 41 } | |
| 42 } | |
| 43 | |
| 44 static pa_channel_position ChromiumToPAChannelPosition(Channels channel) { | |
| 45 switch (channel) { | |
| 46 // PulseAudio does not differentiate between left/right and | |
| 47 // stereo-left/stereo-right, both translate to front-left/front-right. | |
| 48 case LEFT: | |
| 49 case STEREO_LEFT: | |
| 50 return PA_CHANNEL_POSITION_FRONT_LEFT; | |
| 51 case RIGHT: | |
| 52 case STEREO_RIGHT: | |
| 53 return PA_CHANNEL_POSITION_FRONT_RIGHT; | |
| 54 case CENTER: | |
| 55 return PA_CHANNEL_POSITION_FRONT_CENTER; | |
| 56 case LFE: | |
| 57 return PA_CHANNEL_POSITION_LFE; | |
| 58 case BACK_LEFT: | |
| 59 return PA_CHANNEL_POSITION_REAR_LEFT; | |
| 60 case BACK_RIGHT: | |
| 61 return PA_CHANNEL_POSITION_REAR_RIGHT; | |
| 62 case LEFT_OF_CENTER: | |
| 63 return PA_CHANNEL_POSITION_FRONT_LEFT_OF_CENTER; | |
| 64 case RIGHT_OF_CENTER: | |
| 65 return PA_CHANNEL_POSITION_FRONT_RIGHT_OF_CENTER; | |
| 66 case BACK_CENTER: | |
| 67 return PA_CHANNEL_POSITION_REAR_CENTER; | |
| 68 case SIDE_LEFT: | |
| 69 return PA_CHANNEL_POSITION_SIDE_LEFT; | |
| 70 case SIDE_RIGHT: | |
| 71 return PA_CHANNEL_POSITION_SIDE_RIGHT; | |
| 72 case CHANNELS_MAX: | |
| 73 return PA_CHANNEL_POSITION_INVALID; | |
| 74 } | |
| 75 NOTREACHED() << "Invalid channel " << channel; | |
| 76 return PA_CHANNEL_POSITION_INVALID; | |
| 77 } | |
| 78 | |
| 79 static pa_channel_map ChannelLayoutToPAChannelMap( | |
| 80 ChannelLayout channel_layout) { | |
| 81 // Initialize channel map. | |
| 82 pa_channel_map channel_map; | |
| 83 pa_channel_map_init(&channel_map); | |
| 84 | |
| 85 channel_map.channels = ChannelLayoutToChannelCount(channel_layout); | |
| 86 | |
| 87 // All channel maps have the same size array of channel positions. | |
| 88 for (unsigned int channel = 0; channel != CHANNELS_MAX; ++channel) { | |
| 89 int channel_position = kChannelOrderings[channel_layout][channel]; | |
| 90 if (channel_position > -1) { | |
| 91 channel_map.map[channel_position] = ChromiumToPAChannelPosition( | |
| 92 static_cast<Channels>(channel)); | |
| 93 } else { | |
| 94 // PulseAudio expects unused channels in channel maps to be filled with | |
| 95 // PA_CHANNEL_POSITION_MONO. | |
| 96 channel_map.map[channel_position] = PA_CHANNEL_POSITION_MONO; | |
| 97 } | |
| 98 } | |
| 99 | |
| 100 // Fill in the rest of the unused channels. | |
| 101 for (unsigned int channel = CHANNELS_MAX; channel != PA_CHANNELS_MAX; | |
| 102 ++channel) { | |
| 103 channel_map.map[channel] = PA_CHANNEL_POSITION_MONO; | |
| 104 } | |
| 105 | |
| 106 return channel_map; | |
| 107 } | |
| 108 | |
| 109 static size_t MicrosecondsToBytes( | |
| 110 uint32 microseconds, uint32 sample_rate, size_t bytes_per_frame) { | |
| 111 return microseconds * sample_rate * bytes_per_frame / | |
| 112 base::Time::kMicrosecondsPerSecond; | |
| 113 } | |
| 114 | |
| 115 void PulseAudioOutputStream::ContextStateCallback(pa_context* context, | |
| 116 void* state_addr) { | |
| 117 pa_context_state_t* state = static_cast<pa_context_state_t*>(state_addr); | |
| 118 *state = pa_context_get_state(context); | |
| 119 } | |
| 120 | |
| 121 void PulseAudioOutputStream::WriteRequestCallback( | |
| 122 pa_stream* playback_handle, size_t length, void* stream_addr) { | |
| 123 PulseAudioOutputStream* stream = | |
| 124 static_cast<PulseAudioOutputStream*>(stream_addr); | |
| 125 | |
| 126 DCHECK_EQ(stream->message_loop_, MessageLoop::current()); | |
| 127 | |
| 128 stream->write_callback_handled_ = true; | |
| 129 | |
| 130 // Fulfill write request. | |
| 131 stream->FulfillWriteRequest(length); | |
| 132 } | |
| 133 | |
| 134 PulseAudioOutputStream::PulseAudioOutputStream(const AudioParameters& params, | |
| 135 AudioManagerPulse* manager, | |
| 136 MessageLoop* message_loop) | |
| 137 : channel_layout_(params.channel_layout), | |
| 138 channel_count_(ChannelLayoutToChannelCount(channel_layout_)), | |
| 139 sample_format_(BitsToPASampleFormat(params.bits_per_sample)), | |
| 140 sample_rate_(params.sample_rate), | |
| 141 bytes_per_frame_(params.channels * params.bits_per_sample / 8), | |
| 142 manager_(manager), | |
| 143 pa_context_(NULL), | |
| 144 pa_mainloop_(NULL), | |
| 145 playback_handle_(NULL), | |
| 146 packet_size_(params.GetPacketSize()), | |
| 147 frames_per_packet_(packet_size_ / bytes_per_frame_), | |
| 148 client_buffer_(NULL), | |
| 149 volume_(1.0f), | |
| 150 stream_stopped_(true), | |
| 151 write_callback_handled_(false), | |
| 152 message_loop_(message_loop), | |
| 153 ALLOW_THIS_IN_INITIALIZER_LIST(weak_factory_(this)), | |
| 154 source_callback_(NULL) { | |
| 155 DCHECK_EQ(message_loop_, MessageLoop::current()); | |
| 156 DCHECK(manager_); | |
| 157 | |
| 158 // TODO(slock): Sanity check input values. | |
| 159 } | |
| 160 | |
| 161 PulseAudioOutputStream::~PulseAudioOutputStream() { | |
| 162 // All internal structures should already have been freed in Close(), | |
| 163 // which calls AudioManagerPulse::Release which deletes this object. | |
| 164 DCHECK(!playback_handle_); | |
| 165 DCHECK(!pa_context_); | |
| 166 DCHECK(!pa_mainloop_); | |
| 167 } | |
| 168 | |
| 169 bool PulseAudioOutputStream::Open() { | |
| 170 DCHECK_EQ(message_loop_, MessageLoop::current()); | |
| 171 | |
| 172 // TODO(slock): Possibly move most of this to an OpenPlaybackDevice function | |
| 173 // in a new class 'pulse_util', like alsa_util. | |
| 174 | |
| 175 // Create a mainloop API and connect to the default server. | |
| 176 pa_mainloop_ = pa_mainloop_new(); | |
| 177 pa_mainloop_api* pa_mainloop_api = pa_mainloop_get_api(pa_mainloop_); | |
| 178 pa_context_ = pa_context_new(pa_mainloop_api, "Chromium"); | |
| 179 pa_context_state_t pa_context_state = PA_CONTEXT_UNCONNECTED; | |
| 180 pa_context_connect(pa_context_, NULL, PA_CONTEXT_NOFLAGS, NULL); | |
| 181 | |
| 182 // Wait until PulseAudio is ready. | |
| 183 pa_context_set_state_callback(pa_context_, &ContextStateCallback, | |
| 184 &pa_context_state); | |
| 185 while (pa_context_state != PA_CONTEXT_READY) { | |
| 186 pa_mainloop_iterate(pa_mainloop_, 1, NULL); | |
| 187 if (pa_context_state == PA_CONTEXT_FAILED || | |
| 188 pa_context_state == PA_CONTEXT_TERMINATED) { | |
| 189 Reset(); | |
| 190 return false; | |
| 191 } | |
| 192 } | |
| 193 | |
| 194 // Set sample specifications. | |
| 195 pa_sample_spec pa_sample_specifications; | |
| 196 pa_sample_specifications.format = sample_format_; | |
| 197 pa_sample_specifications.rate = sample_rate_; | |
| 198 pa_sample_specifications.channels = channel_count_; | |
| 199 | |
| 200 // Get channel mapping and open playback stream. | |
| 201 pa_channel_map* map = NULL; | |
| 202 pa_channel_map source_channel_map = ChannelLayoutToPAChannelMap( | |
| 203 channel_layout_); | |
| 204 if (source_channel_map.channels != 0) { | |
| 205 // The source data uses a supported channel map so we will use it rather | |
| 206 // than the default channel map (NULL). | |
| 207 map = &source_channel_map; | |
| 208 } | |
| 209 playback_handle_ = pa_stream_new(pa_context_, "Playback", | |
| 210 &pa_sample_specifications, map); | |
| 211 | |
| 212 // Initialize client buffer. | |
| 213 uint32 output_packet_size = frames_per_packet_ * bytes_per_frame_; | |
| 214 client_buffer_.reset(new media::SeekableBuffer(0, output_packet_size)); | |
| 215 | |
| 216 // Set write callback. | |
| 217 pa_stream_set_write_callback(playback_handle_, &WriteRequestCallback, this); | |
| 218 | |
| 219 // Set server-side buffer attributes. | |
| 220 // (uint32_t)-1 is the default and recommended value from PulseAudio's | |
| 221 // documentation, found at: | |
| 222 // http://freedesktop.org/software/pulseaudio/doxygen/structpa__buffer__attr.h
tml. | |
| 223 pa_buffer_attr pa_buffer_attributes; | |
| 224 pa_buffer_attributes.maxlength = static_cast<uint32_t>(-1); | |
| 225 pa_buffer_attributes.tlength = output_packet_size; | |
| 226 pa_buffer_attributes.prebuf = static_cast<uint32_t>(-1); | |
| 227 pa_buffer_attributes.minreq = static_cast<uint32_t>(-1); | |
| 228 pa_buffer_attributes.fragsize = static_cast<uint32_t>(-1); | |
| 229 | |
| 230 // Connect playback stream. | |
| 231 pa_stream_connect_playback(playback_handle_, NULL, | |
| 232 &pa_buffer_attributes, | |
| 233 (pa_stream_flags_t) | |
| 234 (PA_STREAM_INTERPOLATE_TIMING | | |
| 235 PA_STREAM_ADJUST_LATENCY | | |
| 236 PA_STREAM_AUTO_TIMING_UPDATE), | |
| 237 NULL, NULL); | |
| 238 | |
| 239 if (!playback_handle_) { | |
| 240 Reset(); | |
| 241 return false; | |
| 242 } | |
| 243 | |
| 244 return true; | |
| 245 } | |
| 246 | |
| 247 void PulseAudioOutputStream::Reset() { | |
| 248 stream_stopped_ = true; | |
| 249 | |
| 250 // Close the stream. | |
| 251 if (playback_handle_) { | |
| 252 pa_stream_flush(playback_handle_, NULL, NULL); | |
| 253 pa_stream_disconnect(playback_handle_); | |
| 254 | |
| 255 // Release PulseAudio structures. | |
| 256 pa_stream_unref(playback_handle_); | |
| 257 playback_handle_ = NULL; | |
| 258 } | |
| 259 if (pa_context_) { | |
| 260 pa_context_unref(pa_context_); | |
| 261 pa_context_ = NULL; | |
| 262 } | |
| 263 if (pa_mainloop_) { | |
| 264 pa_mainloop_free(pa_mainloop_); | |
| 265 pa_mainloop_ = NULL; | |
| 266 } | |
| 267 | |
| 268 // Release internal buffer. | |
| 269 client_buffer_.reset(); | |
| 270 } | |
| 271 | |
| 272 void PulseAudioOutputStream::Close() { | |
| 273 DCHECK_EQ(message_loop_, MessageLoop::current()); | |
| 274 | |
| 275 Reset(); | |
| 276 | |
| 277 // Signal to the manager that we're closed and can be removed. | |
| 278 // This should be the last call in the function as it deletes "this". | |
| 279 manager_->ReleaseOutputStream(this); | |
| 280 } | |
| 281 | |
| 282 void PulseAudioOutputStream::WaitForWriteRequest() { | |
| 283 DCHECK_EQ(message_loop_, MessageLoop::current()); | |
| 284 | |
| 285 if (stream_stopped_) | |
| 286 return; | |
| 287 | |
| 288 // Iterate the PulseAudio mainloop. If PulseAudio doesn't request a write, | |
| 289 // post a task to iterate the mainloop again. | |
| 290 write_callback_handled_ = false; | |
| 291 pa_mainloop_iterate(pa_mainloop_, 1, NULL); | |
| 292 if (!write_callback_handled_) { | |
| 293 message_loop_->PostTask(FROM_HERE, base::Bind( | |
| 294 &PulseAudioOutputStream::WaitForWriteRequest, | |
| 295 weak_factory_.GetWeakPtr())); | |
| 296 } | |
| 297 } | |
| 298 | |
| 299 bool PulseAudioOutputStream::BufferPacketFromSource() { | |
| 300 uint32 buffer_delay = client_buffer_->forward_bytes(); | |
| 301 pa_usec_t pa_latency_micros; | |
| 302 int negative; | |
| 303 pa_stream_get_latency(playback_handle_, &pa_latency_micros, &negative); | |
| 304 uint32 hardware_delay = MicrosecondsToBytes(pa_latency_micros, | |
| 305 sample_rate_, | |
| 306 bytes_per_frame_); | |
| 307 // TODO(slock): Deal with negative latency (negative == 1). This has yet | |
| 308 // to happen in practice though. | |
| 309 scoped_refptr<media::DataBuffer> packet = | |
| 310 new media::DataBuffer(packet_size_); | |
| 311 size_t packet_size = RunDataCallback(packet->GetWritableData(), | |
| 312 packet->GetBufferSize(), | |
| 313 AudioBuffersState(buffer_delay, | |
| 314 hardware_delay)); | |
| 315 | |
| 316 if (packet_size == 0) | |
| 317 return false; | |
| 318 | |
| 319 media::AdjustVolume(packet->GetWritableData(), | |
| 320 packet_size, | |
| 321 channel_count_, | |
| 322 bytes_per_frame_ / channel_count_, | |
| 323 volume_); | |
| 324 packet->SetDataSize(packet_size); | |
| 325 // Add the packet to the buffer. | |
| 326 client_buffer_->Append(packet); | |
| 327 return true; | |
| 328 } | |
| 329 | |
| 330 void PulseAudioOutputStream::FulfillWriteRequest(size_t requested_bytes) { | |
| 331 // If we have enough data to fulfill the request, we can finish the write. | |
| 332 if (stream_stopped_) | |
| 333 return; | |
| 334 | |
| 335 // Request more data from the source until we can fulfill the request or | |
| 336 // fail to receive anymore data. | |
| 337 bool buffering_successful = true; | |
| 338 while (client_buffer_->forward_bytes() < requested_bytes && | |
| 339 buffering_successful) { | |
| 340 buffering_successful = BufferPacketFromSource(); | |
| 341 } | |
| 342 | |
| 343 size_t bytes_written = 0; | |
| 344 if (client_buffer_->forward_bytes() > 0) { | |
| 345 // Try to fulfill the request by writing as many of the requested bytes to | |
| 346 // the stream as we can. | |
| 347 WriteToStream(requested_bytes, &bytes_written); | |
| 348 } | |
| 349 | |
| 350 if (bytes_written < requested_bytes) { | |
| 351 // We weren't able to buffer enough data to fulfill the request. Try to | |
| 352 // fulfill the rest of the request later. | |
| 353 message_loop_->PostTask(FROM_HERE, base::Bind( | |
| 354 &PulseAudioOutputStream::FulfillWriteRequest, | |
| 355 weak_factory_.GetWeakPtr(), | |
| 356 requested_bytes - bytes_written)); | |
| 357 } else { | |
| 358 // Continue playback. | |
| 359 message_loop_->PostTask(FROM_HERE, base::Bind( | |
| 360 &PulseAudioOutputStream::WaitForWriteRequest, | |
| 361 weak_factory_.GetWeakPtr())); | |
| 362 } | |
| 363 } | |
| 364 | |
| 365 void PulseAudioOutputStream::WriteToStream(size_t bytes_to_write, | |
| 366 size_t* bytes_written) { | |
| 367 *bytes_written = 0; | |
| 368 while (*bytes_written < bytes_to_write) { | |
| 369 const uint8* chunk; | |
| 370 size_t chunk_size; | |
| 371 | |
| 372 // Stop writing if there is no more data available. | |
| 373 if (!client_buffer_->GetCurrentChunk(&chunk, &chunk_size)) | |
| 374 break; | |
| 375 | |
| 376 // Write data to stream. | |
| 377 pa_stream_write(playback_handle_, chunk, chunk_size, | |
| 378 NULL, 0LL, PA_SEEK_RELATIVE); | |
| 379 client_buffer_->Seek(chunk_size); | |
| 380 *bytes_written += chunk_size; | |
| 381 } | |
| 382 } | |
| 383 | |
| 384 void PulseAudioOutputStream::Start(AudioSourceCallback* callback) { | |
| 385 DCHECK_EQ(message_loop_, MessageLoop::current()); | |
| 386 | |
| 387 CHECK(callback); | |
| 388 source_callback_ = callback; | |
| 389 | |
| 390 // Clear buffer, it might still have data in it. | |
| 391 client_buffer_->Clear(); | |
| 392 stream_stopped_ = false; | |
| 393 | |
| 394 // Start playback. | |
| 395 message_loop_->PostTask(FROM_HERE, base::Bind( | |
| 396 &PulseAudioOutputStream::WaitForWriteRequest, | |
| 397 weak_factory_.GetWeakPtr())); | |
| 398 } | |
| 399 | |
| 400 void PulseAudioOutputStream::Stop() { | |
| 401 DCHECK_EQ(message_loop_, MessageLoop::current()); | |
| 402 | |
| 403 stream_stopped_ = true; | |
| 404 } | |
| 405 | |
| 406 void PulseAudioOutputStream::SetVolume(double volume) { | |
| 407 DCHECK_EQ(message_loop_, MessageLoop::current()); | |
| 408 | |
| 409 volume_ = static_cast<float>(volume); | |
| 410 } | |
| 411 | |
| 412 void PulseAudioOutputStream::GetVolume(double* volume) { | |
| 413 DCHECK_EQ(message_loop_, MessageLoop::current()); | |
| 414 | |
| 415 *volume = volume_; | |
| 416 } | |
| 417 | |
| 418 uint32 PulseAudioOutputStream::RunDataCallback( | |
| 419 uint8* dest, uint32 max_size, AudioBuffersState buffers_state) { | |
| 420 if (source_callback_) | |
| 421 return source_callback_->OnMoreData(this, dest, max_size, buffers_state); | |
| 422 | |
| 423 return 0; | |
| 424 } | |
| OLD | NEW |