1 /*
2 * Copyright (C) 2007 The Android Open Source Project
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 //#define LOG_NDEBUG 0
18 #define LOG_TAG "SoundPool"
19
20 #include <inttypes.h>
21
22 #include <utils/Log.h>
23
24 #define USE_SHARED_MEM_BUFFER
25
26 #include <media/AudioTrack.h>
27 #include <media/IMediaHTTPService.h>
28 #include <media/mediaplayer.h>
29 #include <media/stagefright/MediaExtractor.h>
30 #include "SoundPool.h"
31 #include "SoundPoolThread.h"
32 #include <media/AudioPolicyHelper.h>
33 #include <media/NdkMediaCodec.h>
34 #include <media/NdkMediaExtractor.h>
35 #include <media/NdkMediaFormat.h>
36
37 namespace android
38 {
39
40 int kDefaultBufferCount = 4;
41 uint32_t kMaxSampleRate = 48000;
42 uint32_t kDefaultSampleRate = 44100;
43 uint32_t kDefaultFrameCount = 1200;
44 size_t kDefaultHeapSize = 1024 * 1024; // 1MB
45
46
SoundPool(int maxChannels,const audio_attributes_t * pAttributes)47 SoundPool::SoundPool(int maxChannels, const audio_attributes_t* pAttributes)
48 {
49 ALOGV("SoundPool constructor: maxChannels=%d, attr.usage=%d, attr.flags=0x%x, attr.tags=%s",
50 maxChannels, pAttributes->usage, pAttributes->flags, pAttributes->tags);
51
52 // check limits
53 mMaxChannels = maxChannels;
54 if (mMaxChannels < 1) {
55 mMaxChannels = 1;
56 }
57 else if (mMaxChannels > 32) {
58 mMaxChannels = 32;
59 }
60 ALOGW_IF(maxChannels != mMaxChannels, "App requested %d channels", maxChannels);
61
62 mQuit = false;
63 mMuted = false;
64 mDecodeThread = 0;
65 memcpy(&mAttributes, pAttributes, sizeof(audio_attributes_t));
66 mAllocated = 0;
67 mNextSampleID = 0;
68 mNextChannelID = 0;
69
70 mCallback = 0;
71 mUserData = 0;
72
73 mChannelPool = new SoundChannel[mMaxChannels];
74 for (int i = 0; i < mMaxChannels; ++i) {
75 mChannelPool[i].init(this);
76 mChannels.push_back(&mChannelPool[i]);
77 }
78
79 // start decode thread
80 startThreads();
81 }
82
~SoundPool()83 SoundPool::~SoundPool()
84 {
85 ALOGV("SoundPool destructor");
86 mDecodeThread->quit();
87 quit();
88
89 Mutex::Autolock lock(&mLock);
90
91 mChannels.clear();
92 if (mChannelPool)
93 delete [] mChannelPool;
94 // clean up samples
95 ALOGV("clear samples");
96 mSamples.clear();
97
98 if (mDecodeThread)
99 delete mDecodeThread;
100 }
101
addToRestartList(SoundChannel * channel)102 void SoundPool::addToRestartList(SoundChannel* channel)
103 {
104 Mutex::Autolock lock(&mRestartLock);
105 if (!mQuit) {
106 mRestart.push_back(channel);
107 mCondition.signal();
108 }
109 }
110
addToStopList(SoundChannel * channel)111 void SoundPool::addToStopList(SoundChannel* channel)
112 {
113 Mutex::Autolock lock(&mRestartLock);
114 if (!mQuit) {
115 mStop.push_back(channel);
116 mCondition.signal();
117 }
118 }
119
beginThread(void * arg)120 int SoundPool::beginThread(void* arg)
121 {
122 SoundPool* p = (SoundPool*)arg;
123 return p->run();
124 }
125
run()126 int SoundPool::run()
127 {
128 mRestartLock.lock();
129 while (!mQuit) {
130 mCondition.wait(mRestartLock);
131 ALOGV("awake");
132 if (mQuit) break;
133
134 while (!mStop.empty()) {
135 SoundChannel* channel;
136 ALOGV("Getting channel from stop list");
137 List<SoundChannel* >::iterator iter = mStop.begin();
138 channel = *iter;
139 mStop.erase(iter);
140 mRestartLock.unlock();
141 if (channel != 0) {
142 Mutex::Autolock lock(&mLock);
143 channel->stop();
144 }
145 mRestartLock.lock();
146 if (mQuit) break;
147 }
148
149 while (!mRestart.empty()) {
150 SoundChannel* channel;
151 ALOGV("Getting channel from list");
152 List<SoundChannel*>::iterator iter = mRestart.begin();
153 channel = *iter;
154 mRestart.erase(iter);
155 mRestartLock.unlock();
156 if (channel != 0) {
157 Mutex::Autolock lock(&mLock);
158 channel->nextEvent();
159 }
160 mRestartLock.lock();
161 if (mQuit) break;
162 }
163 }
164
165 mStop.clear();
166 mRestart.clear();
167 mCondition.signal();
168 mRestartLock.unlock();
169 ALOGV("goodbye");
170 return 0;
171 }
172
quit()173 void SoundPool::quit()
174 {
175 mRestartLock.lock();
176 mQuit = true;
177 mCondition.signal();
178 mCondition.wait(mRestartLock);
179 ALOGV("return from quit");
180 mRestartLock.unlock();
181 }
182
startThreads()183 bool SoundPool::startThreads()
184 {
185 createThreadEtc(beginThread, this, "SoundPool");
186 if (mDecodeThread == NULL)
187 mDecodeThread = new SoundPoolThread(this);
188 return mDecodeThread != NULL;
189 }
190
findSample(int sampleID)191 sp<Sample> SoundPool::findSample(int sampleID)
192 {
193 Mutex::Autolock lock(&mLock);
194 return findSample_l(sampleID);
195 }
196
findSample_l(int sampleID)197 sp<Sample> SoundPool::findSample_l(int sampleID)
198 {
199 return mSamples.valueFor(sampleID);
200 }
201
findChannel(int channelID)202 SoundChannel* SoundPool::findChannel(int channelID)
203 {
204 for (int i = 0; i < mMaxChannels; ++i) {
205 if (mChannelPool[i].channelID() == channelID) {
206 return &mChannelPool[i];
207 }
208 }
209 return NULL;
210 }
211
findNextChannel(int channelID)212 SoundChannel* SoundPool::findNextChannel(int channelID)
213 {
214 for (int i = 0; i < mMaxChannels; ++i) {
215 if (mChannelPool[i].nextChannelID() == channelID) {
216 return &mChannelPool[i];
217 }
218 }
219 return NULL;
220 }
221
load(int fd,int64_t offset,int64_t length,int priority __unused)222 int SoundPool::load(int fd, int64_t offset, int64_t length, int priority __unused)
223 {
224 ALOGV("load: fd=%d, offset=%" PRId64 ", length=%" PRId64 ", priority=%d",
225 fd, offset, length, priority);
226 int sampleID;
227 {
228 Mutex::Autolock lock(&mLock);
229 sampleID = ++mNextSampleID;
230 sp<Sample> sample = new Sample(sampleID, fd, offset, length);
231 mSamples.add(sampleID, sample);
232 sample->startLoad();
233 }
234 // mDecodeThread->loadSample() must be called outside of mLock.
235 // mDecodeThread->loadSample() may block on mDecodeThread message queue space;
236 // the message queue emptying may block on SoundPool::findSample().
237 //
238 // It theoretically possible that sample loads might decode out-of-order.
239 mDecodeThread->loadSample(sampleID);
240 return sampleID;
241 }
242
unload(int sampleID)243 bool SoundPool::unload(int sampleID)
244 {
245 ALOGV("unload: sampleID=%d", sampleID);
246 Mutex::Autolock lock(&mLock);
247 return mSamples.removeItem(sampleID) >= 0; // removeItem() returns index or BAD_VALUE
248 }
249
play(int sampleID,float leftVolume,float rightVolume,int priority,int loop,float rate)250 int SoundPool::play(int sampleID, float leftVolume, float rightVolume,
251 int priority, int loop, float rate)
252 {
253 ALOGV("play sampleID=%d, leftVolume=%f, rightVolume=%f, priority=%d, loop=%d, rate=%f",
254 sampleID, leftVolume, rightVolume, priority, loop, rate);
255 SoundChannel* channel;
256 int channelID;
257
258 Mutex::Autolock lock(&mLock);
259
260 if (mQuit) {
261 return 0;
262 }
263 // is sample ready?
264 sp<Sample> sample(findSample_l(sampleID));
265 if ((sample == 0) || (sample->state() != Sample::READY)) {
266 ALOGW(" sample %d not READY", sampleID);
267 return 0;
268 }
269
270 dump();
271
272 // allocate a channel
273 channel = allocateChannel_l(priority, sampleID);
274
275 // no channel allocated - return 0
276 if (!channel) {
277 ALOGV("No channel allocated");
278 return 0;
279 }
280
281 channelID = ++mNextChannelID;
282
283 ALOGV("play channel %p state = %d", channel, channel->state());
284 channel->play(sample, channelID, leftVolume, rightVolume, priority, loop, rate);
285 return channelID;
286 }
287
allocateChannel_l(int priority,int sampleID)288 SoundChannel* SoundPool::allocateChannel_l(int priority, int sampleID)
289 {
290 List<SoundChannel*>::iterator iter;
291 SoundChannel* channel = NULL;
292
293 // check if channel for given sampleID still available
294 if (!mChannels.empty()) {
295 for (iter = mChannels.begin(); iter != mChannels.end(); ++iter) {
296 if (sampleID == (*iter)->getPrevSampleID() && (*iter)->state() == SoundChannel::IDLE) {
297 channel = *iter;
298 mChannels.erase(iter);
299 ALOGV("Allocated recycled channel for same sampleID");
300 break;
301 }
302 }
303 }
304
305 // allocate any channel
306 if (!channel && !mChannels.empty()) {
307 iter = mChannels.begin();
308 if (priority >= (*iter)->priority()) {
309 channel = *iter;
310 mChannels.erase(iter);
311 ALOGV("Allocated active channel");
312 }
313 }
314
315 // update priority and put it back in the list
316 if (channel) {
317 channel->setPriority(priority);
318 for (iter = mChannels.begin(); iter != mChannels.end(); ++iter) {
319 if (priority < (*iter)->priority()) {
320 break;
321 }
322 }
323 mChannels.insert(iter, channel);
324 }
325 return channel;
326 }
327
328 // move a channel from its current position to the front of the list
moveToFront_l(SoundChannel * channel)329 void SoundPool::moveToFront_l(SoundChannel* channel)
330 {
331 for (List<SoundChannel*>::iterator iter = mChannels.begin(); iter != mChannels.end(); ++iter) {
332 if (*iter == channel) {
333 mChannels.erase(iter);
334 mChannels.push_front(channel);
335 break;
336 }
337 }
338 }
339
pause(int channelID)340 void SoundPool::pause(int channelID)
341 {
342 ALOGV("pause(%d)", channelID);
343 Mutex::Autolock lock(&mLock);
344 SoundChannel* channel = findChannel(channelID);
345 if (channel) {
346 channel->pause();
347 }
348 }
349
autoPause()350 void SoundPool::autoPause()
351 {
352 ALOGV("autoPause()");
353 Mutex::Autolock lock(&mLock);
354 for (int i = 0; i < mMaxChannels; ++i) {
355 SoundChannel* channel = &mChannelPool[i];
356 channel->autoPause();
357 }
358 }
359
resume(int channelID)360 void SoundPool::resume(int channelID)
361 {
362 ALOGV("resume(%d)", channelID);
363 Mutex::Autolock lock(&mLock);
364 SoundChannel* channel = findChannel(channelID);
365 if (channel) {
366 channel->resume();
367 }
368 }
369
mute(bool muting)370 void SoundPool::mute(bool muting)
371 {
372 ALOGV("mute(%d)", muting);
373 Mutex::Autolock lock(&mLock);
374 mMuted = muting;
375 if (!mChannels.empty()) {
376 for (List<SoundChannel*>::iterator iter = mChannels.begin();
377 iter != mChannels.end(); ++iter) {
378 (*iter)->mute(muting);
379 }
380 }
381 }
382
autoResume()383 void SoundPool::autoResume()
384 {
385 ALOGV("autoResume()");
386 Mutex::Autolock lock(&mLock);
387 for (int i = 0; i < mMaxChannels; ++i) {
388 SoundChannel* channel = &mChannelPool[i];
389 channel->autoResume();
390 }
391 }
392
stop(int channelID)393 void SoundPool::stop(int channelID)
394 {
395 ALOGV("stop(%d)", channelID);
396 Mutex::Autolock lock(&mLock);
397 SoundChannel* channel = findChannel(channelID);
398 if (channel) {
399 channel->stop();
400 } else {
401 channel = findNextChannel(channelID);
402 if (channel)
403 channel->clearNextEvent();
404 }
405 }
406
setVolume(int channelID,float leftVolume,float rightVolume)407 void SoundPool::setVolume(int channelID, float leftVolume, float rightVolume)
408 {
409 Mutex::Autolock lock(&mLock);
410 SoundChannel* channel = findChannel(channelID);
411 if (channel) {
412 channel->setVolume(leftVolume, rightVolume);
413 }
414 }
415
setPriority(int channelID,int priority)416 void SoundPool::setPriority(int channelID, int priority)
417 {
418 ALOGV("setPriority(%d, %d)", channelID, priority);
419 Mutex::Autolock lock(&mLock);
420 SoundChannel* channel = findChannel(channelID);
421 if (channel) {
422 channel->setPriority(priority);
423 }
424 }
425
setLoop(int channelID,int loop)426 void SoundPool::setLoop(int channelID, int loop)
427 {
428 ALOGV("setLoop(%d, %d)", channelID, loop);
429 Mutex::Autolock lock(&mLock);
430 SoundChannel* channel = findChannel(channelID);
431 if (channel) {
432 channel->setLoop(loop);
433 }
434 }
435
setRate(int channelID,float rate)436 void SoundPool::setRate(int channelID, float rate)
437 {
438 ALOGV("setRate(%d, %f)", channelID, rate);
439 Mutex::Autolock lock(&mLock);
440 SoundChannel* channel = findChannel(channelID);
441 if (channel) {
442 channel->setRate(rate);
443 }
444 }
445
446 // call with lock held
done_l(SoundChannel * channel)447 void SoundPool::done_l(SoundChannel* channel)
448 {
449 ALOGV("done_l(%d)", channel->channelID());
450 // if "stolen", play next event
451 if (channel->nextChannelID() != 0) {
452 ALOGV("add to restart list");
453 addToRestartList(channel);
454 }
455
456 // return to idle state
457 else {
458 ALOGV("move to front");
459 moveToFront_l(channel);
460 }
461 }
462
setCallback(SoundPoolCallback * callback,void * user)463 void SoundPool::setCallback(SoundPoolCallback* callback, void* user)
464 {
465 Mutex::Autolock lock(&mCallbackLock);
466 mCallback = callback;
467 mUserData = user;
468 }
469
notify(SoundPoolEvent event)470 void SoundPool::notify(SoundPoolEvent event)
471 {
472 Mutex::Autolock lock(&mCallbackLock);
473 if (mCallback != NULL) {
474 mCallback(event, this, mUserData);
475 }
476 }
477
dump()478 void SoundPool::dump()
479 {
480 for (int i = 0; i < mMaxChannels; ++i) {
481 mChannelPool[i].dump();
482 }
483 }
484
485
Sample(int sampleID,int fd,int64_t offset,int64_t length)486 Sample::Sample(int sampleID, int fd, int64_t offset, int64_t length)
487 {
488 init();
489 mSampleID = sampleID;
490 mFd = dup(fd);
491 mOffset = offset;
492 mLength = length;
493 ALOGV("create sampleID=%d, fd=%d, offset=%" PRId64 " length=%" PRId64,
494 mSampleID, mFd, mLength, mOffset);
495 }
496
init()497 void Sample::init()
498 {
499 mSize = 0;
500 mRefCount = 0;
501 mSampleID = 0;
502 mState = UNLOADED;
503 mFd = -1;
504 mOffset = 0;
505 mLength = 0;
506 }
507
~Sample()508 Sample::~Sample()
509 {
510 ALOGV("Sample::destructor sampleID=%d, fd=%d", mSampleID, mFd);
511 if (mFd > 0) {
512 ALOGV("close(%d)", mFd);
513 ::close(mFd);
514 }
515 }
516
decode(int fd,int64_t offset,int64_t length,uint32_t * rate,int * numChannels,audio_format_t * audioFormat,sp<MemoryHeapBase> heap,size_t * memsize)517 static status_t decode(int fd, int64_t offset, int64_t length,
518 uint32_t *rate, int *numChannels, audio_format_t *audioFormat,
519 sp<MemoryHeapBase> heap, size_t *memsize) {
520
521 ALOGV("fd %d, offset %" PRId64 ", size %" PRId64, fd, offset, length);
522 AMediaExtractor *ex = AMediaExtractor_new();
523 status_t err = AMediaExtractor_setDataSourceFd(ex, fd, offset, length);
524
525 if (err != AMEDIA_OK) {
526 AMediaExtractor_delete(ex);
527 return err;
528 }
529
530 *audioFormat = AUDIO_FORMAT_PCM_16_BIT;
531
532 size_t numTracks = AMediaExtractor_getTrackCount(ex);
533 for (size_t i = 0; i < numTracks; i++) {
534 AMediaFormat *format = AMediaExtractor_getTrackFormat(ex, i);
535 const char *mime;
536 if (!AMediaFormat_getString(format, AMEDIAFORMAT_KEY_MIME, &mime)) {
537 AMediaExtractor_delete(ex);
538 AMediaFormat_delete(format);
539 return UNKNOWN_ERROR;
540 }
541 if (strncmp(mime, "audio/", 6) == 0) {
542
543 AMediaCodec *codec = AMediaCodec_createDecoderByType(mime);
544 if (codec == NULL
545 || AMediaCodec_configure(codec, format,
546 NULL /* window */, NULL /* drm */, 0 /* flags */) != AMEDIA_OK
547 || AMediaCodec_start(codec) != AMEDIA_OK
548 || AMediaExtractor_selectTrack(ex, i) != AMEDIA_OK) {
549 AMediaExtractor_delete(ex);
550 AMediaCodec_delete(codec);
551 AMediaFormat_delete(format);
552 return UNKNOWN_ERROR;
553 }
554
555 bool sawInputEOS = false;
556 bool sawOutputEOS = false;
557 uint8_t* writePos = static_cast<uint8_t*>(heap->getBase());
558 size_t available = heap->getSize();
559 size_t written = 0;
560
561 AMediaFormat_delete(format);
562 format = AMediaCodec_getOutputFormat(codec);
563
564 while (!sawOutputEOS) {
565 if (!sawInputEOS) {
566 ssize_t bufidx = AMediaCodec_dequeueInputBuffer(codec, 5000);
567 ALOGV("input buffer %zd", bufidx);
568 if (bufidx >= 0) {
569 size_t bufsize;
570 uint8_t *buf = AMediaCodec_getInputBuffer(codec, bufidx, &bufsize);
571 if (buf == nullptr) {
572 ALOGE("AMediaCodec_getInputBuffer returned nullptr, short decode");
573 break;
574 }
575 int sampleSize = AMediaExtractor_readSampleData(ex, buf, bufsize);
576 ALOGV("read %d", sampleSize);
577 if (sampleSize < 0) {
578 sampleSize = 0;
579 sawInputEOS = true;
580 ALOGV("EOS");
581 }
582 int64_t presentationTimeUs = AMediaExtractor_getSampleTime(ex);
583
584 media_status_t mstatus = AMediaCodec_queueInputBuffer(codec, bufidx,
585 0 /* offset */, sampleSize, presentationTimeUs,
586 sawInputEOS ? AMEDIACODEC_BUFFER_FLAG_END_OF_STREAM : 0);
587 if (mstatus != AMEDIA_OK) {
588 // AMEDIA_ERROR_UNKNOWN == { -ERANGE -EINVAL -EACCES }
589 ALOGE("AMediaCodec_queueInputBuffer returned status %d, short decode",
590 (int)mstatus);
591 break;
592 }
593 (void)AMediaExtractor_advance(ex);
594 }
595 }
596
597 AMediaCodecBufferInfo info;
598 int status = AMediaCodec_dequeueOutputBuffer(codec, &info, 1);
599 ALOGV("dequeueoutput returned: %d", status);
600 if (status >= 0) {
601 if (info.flags & AMEDIACODEC_BUFFER_FLAG_END_OF_STREAM) {
602 ALOGV("output EOS");
603 sawOutputEOS = true;
604 }
605 ALOGV("got decoded buffer size %d", info.size);
606
607 uint8_t *buf = AMediaCodec_getOutputBuffer(codec, status, NULL /* out_size */);
608 if (buf == nullptr) {
609 ALOGE("AMediaCodec_getOutputBuffer returned nullptr, short decode");
610 break;
611 }
612 size_t dataSize = info.size;
613 if (dataSize > available) {
614 dataSize = available;
615 }
616 memcpy(writePos, buf + info.offset, dataSize);
617 writePos += dataSize;
618 written += dataSize;
619 available -= dataSize;
620 media_status_t mstatus = AMediaCodec_releaseOutputBuffer(
621 codec, status, false /* render */);
622 if (mstatus != AMEDIA_OK) {
623 // AMEDIA_ERROR_UNKNOWN == { -ERANGE -EINVAL -EACCES }
624 ALOGE("AMediaCodec_releaseOutputBuffer returned status %d, short decode",
625 (int)mstatus);
626 break;
627 }
628 if (available == 0) {
629 // there might be more data, but there's no space for it
630 sawOutputEOS = true;
631 }
632 } else if (status == AMEDIACODEC_INFO_OUTPUT_BUFFERS_CHANGED) {
633 ALOGV("output buffers changed");
634 } else if (status == AMEDIACODEC_INFO_OUTPUT_FORMAT_CHANGED) {
635 AMediaFormat_delete(format);
636 format = AMediaCodec_getOutputFormat(codec);
637 ALOGV("format changed to: %s", AMediaFormat_toString(format));
638 } else if (status == AMEDIACODEC_INFO_TRY_AGAIN_LATER) {
639 ALOGV("no output buffer right now");
640 } else if (status <= AMEDIA_ERROR_BASE) {
641 ALOGE("decode error: %d", status);
642 break;
643 } else {
644 ALOGV("unexpected info code: %d", status);
645 }
646 }
647
648 (void)AMediaCodec_stop(codec);
649 (void)AMediaCodec_delete(codec);
650 (void)AMediaExtractor_delete(ex);
651 if (!AMediaFormat_getInt32(format, AMEDIAFORMAT_KEY_SAMPLE_RATE, (int32_t*) rate) ||
652 !AMediaFormat_getInt32(format, AMEDIAFORMAT_KEY_CHANNEL_COUNT, numChannels)) {
653 (void)AMediaFormat_delete(format);
654 return UNKNOWN_ERROR;
655 }
656 (void)AMediaFormat_delete(format);
657 *memsize = written;
658 return OK;
659 }
660 (void)AMediaFormat_delete(format);
661 }
662 (void)AMediaExtractor_delete(ex);
663 return UNKNOWN_ERROR;
664 }
665
doLoad()666 status_t Sample::doLoad()
667 {
668 uint32_t sampleRate;
669 int numChannels;
670 audio_format_t format;
671 status_t status;
672 mHeap = new MemoryHeapBase(kDefaultHeapSize);
673
674 ALOGV("Start decode");
675 status = decode(mFd, mOffset, mLength, &sampleRate, &numChannels, &format,
676 mHeap, &mSize);
677 ALOGV("close(%d)", mFd);
678 ::close(mFd);
679 mFd = -1;
680 if (status != NO_ERROR) {
681 ALOGE("Unable to load sample");
682 goto error;
683 }
684 ALOGV("pointer = %p, size = %zu, sampleRate = %u, numChannels = %d",
685 mHeap->getBase(), mSize, sampleRate, numChannels);
686
687 if (sampleRate > kMaxSampleRate) {
688 ALOGE("Sample rate (%u) out of range", sampleRate);
689 status = BAD_VALUE;
690 goto error;
691 }
692
693 if ((numChannels < 1) || (numChannels > FCC_8)) {
694 ALOGE("Sample channel count (%d) out of range", numChannels);
695 status = BAD_VALUE;
696 goto error;
697 }
698
699 mData = new MemoryBase(mHeap, 0, mSize);
700 mSampleRate = sampleRate;
701 mNumChannels = numChannels;
702 mFormat = format;
703 mState = READY;
704 return NO_ERROR;
705
706 error:
707 mHeap.clear();
708 return status;
709 }
710
711
init(SoundPool * soundPool)712 void SoundChannel::init(SoundPool* soundPool)
713 {
714 mSoundPool = soundPool;
715 mPrevSampleID = -1;
716 }
717
718 // call with sound pool lock held
play(const sp<Sample> & sample,int nextChannelID,float leftVolume,float rightVolume,int priority,int loop,float rate)719 void SoundChannel::play(const sp<Sample>& sample, int nextChannelID, float leftVolume,
720 float rightVolume, int priority, int loop, float rate)
721 {
722 sp<AudioTrack> oldTrack;
723 sp<AudioTrack> newTrack;
724 status_t status = NO_ERROR;
725
726 { // scope for the lock
727 Mutex::Autolock lock(&mLock);
728
729 ALOGV("SoundChannel::play %p: sampleID=%d, channelID=%d, leftVolume=%f, rightVolume=%f,"
730 " priority=%d, loop=%d, rate=%f",
731 this, sample->sampleID(), nextChannelID, leftVolume, rightVolume,
732 priority, loop, rate);
733
734 // if not idle, this voice is being stolen
735 if (mState != IDLE) {
736 ALOGV("channel %d stolen - event queued for channel %d", channelID(), nextChannelID);
737 mNextEvent.set(sample, nextChannelID, leftVolume, rightVolume, priority, loop, rate);
738 stop_l();
739 return;
740 }
741
742 // initialize track
743 size_t afFrameCount;
744 uint32_t afSampleRate;
745 audio_stream_type_t streamType = audio_attributes_to_stream_type(mSoundPool->attributes());
746 if (AudioSystem::getOutputFrameCount(&afFrameCount, streamType) != NO_ERROR) {
747 afFrameCount = kDefaultFrameCount;
748 }
749 if (AudioSystem::getOutputSamplingRate(&afSampleRate, streamType) != NO_ERROR) {
750 afSampleRate = kDefaultSampleRate;
751 }
752 int numChannels = sample->numChannels();
753 uint32_t sampleRate = uint32_t(float(sample->sampleRate()) * rate + 0.5);
754 size_t frameCount = 0;
755
756 if (loop) {
757 const audio_format_t format = sample->format();
758 const size_t frameSize = audio_is_linear_pcm(format)
759 ? numChannels * audio_bytes_per_sample(format) : 1;
760 frameCount = sample->size() / frameSize;
761 }
762
763 #ifndef USE_SHARED_MEM_BUFFER
764 uint32_t totalFrames = (kDefaultBufferCount * afFrameCount * sampleRate) / afSampleRate;
765 // Ensure minimum audio buffer size in case of short looped sample
766 if(frameCount < totalFrames) {
767 frameCount = totalFrames;
768 }
769 #endif
770
771 // check if the existing track has the same sample id.
772 if (mAudioTrack != 0 && mPrevSampleID == sample->sampleID()) {
773 // the sample rate may fail to change if the audio track is a fast track.
774 if (mAudioTrack->setSampleRate(sampleRate) == NO_ERROR) {
775 newTrack = mAudioTrack;
776 ALOGV("reusing track %p for sample %d", mAudioTrack.get(), sample->sampleID());
777 }
778 }
779 if (newTrack == 0) {
780 // mToggle toggles each time a track is started on a given channel.
781 // The toggle is concatenated with the SoundChannel address and passed to AudioTrack
782 // as callback user data. This enables the detection of callbacks received from the old
783 // audio track while the new one is being started and avoids processing them with
784 // wrong audio audio buffer size (mAudioBufferSize)
785 unsigned long toggle = mToggle ^ 1;
786 void *userData = (void *)((unsigned long)this | toggle);
787 audio_channel_mask_t channelMask = audio_channel_out_mask_from_count(numChannels);
788
789 // do not create a new audio track if current track is compatible with sample parameters
790 #ifdef USE_SHARED_MEM_BUFFER
791 newTrack = new AudioTrack(streamType, sampleRate, sample->format(),
792 channelMask, sample->getIMemory(), AUDIO_OUTPUT_FLAG_FAST, callback, userData,
793 0 /*default notification frames*/, AUDIO_SESSION_ALLOCATE,
794 AudioTrack::TRANSFER_DEFAULT,
795 NULL /*offloadInfo*/, -1 /*uid*/, -1 /*pid*/, mSoundPool->attributes());
796 #else
797 uint32_t bufferFrames = (totalFrames + (kDefaultBufferCount - 1)) / kDefaultBufferCount;
798 newTrack = new AudioTrack(streamType, sampleRate, sample->format(),
799 channelMask, frameCount, AUDIO_OUTPUT_FLAG_FAST, callback, userData,
800 bufferFrames, AUDIO_SESSION_ALLOCATE, AudioTrack::TRANSFER_DEFAULT,
801 NULL /*offloadInfo*/, -1 /*uid*/, -1 /*pid*/, mSoundPool->attributes());
802 #endif
803 oldTrack = mAudioTrack;
804 status = newTrack->initCheck();
805 if (status != NO_ERROR) {
806 ALOGE("Error creating AudioTrack");
807 // newTrack goes out of scope, so reference count drops to zero
808 goto exit;
809 }
810 // From now on, AudioTrack callbacks received with previous toggle value will be ignored.
811 mToggle = toggle;
812 mAudioTrack = newTrack;
813 ALOGV("using new track %p for sample %d", newTrack.get(), sample->sampleID());
814 }
815 newTrack->setVolume(leftVolume, rightVolume);
816 newTrack->setLoop(0, frameCount, loop);
817 mPos = 0;
818 mSample = sample;
819 mChannelID = nextChannelID;
820 mPriority = priority;
821 mLoop = loop;
822 mLeftVolume = leftVolume;
823 mRightVolume = rightVolume;
824 mNumChannels = numChannels;
825 mRate = rate;
826 clearNextEvent();
827 mState = PLAYING;
828 mAudioTrack->start();
829 mAudioBufferSize = newTrack->frameCount()*newTrack->frameSize();
830 }
831
832 exit:
833 ALOGV("delete oldTrack %p", oldTrack.get());
834 if (status != NO_ERROR) {
835 mAudioTrack.clear();
836 }
837 }
838
nextEvent()839 void SoundChannel::nextEvent()
840 {
841 sp<Sample> sample;
842 int nextChannelID;
843 float leftVolume;
844 float rightVolume;
845 int priority;
846 int loop;
847 float rate;
848
849 // check for valid event
850 {
851 Mutex::Autolock lock(&mLock);
852 nextChannelID = mNextEvent.channelID();
853 if (nextChannelID == 0) {
854 ALOGV("stolen channel has no event");
855 return;
856 }
857
858 sample = mNextEvent.sample();
859 leftVolume = mNextEvent.leftVolume();
860 rightVolume = mNextEvent.rightVolume();
861 priority = mNextEvent.priority();
862 loop = mNextEvent.loop();
863 rate = mNextEvent.rate();
864 }
865
866 ALOGV("Starting stolen channel %d -> %d", channelID(), nextChannelID);
867 play(sample, nextChannelID, leftVolume, rightVolume, priority, loop, rate);
868 }
869
callback(int event,void * user,void * info)870 void SoundChannel::callback(int event, void* user, void *info)
871 {
872 SoundChannel* channel = static_cast<SoundChannel*>((void *)((unsigned long)user & ~1));
873
874 channel->process(event, info, (unsigned long)user & 1);
875 }
876
process(int event,void * info,unsigned long toggle)877 void SoundChannel::process(int event, void *info, unsigned long toggle)
878 {
879 //ALOGV("process(%d)", mChannelID);
880
881 Mutex::Autolock lock(&mLock);
882
883 AudioTrack::Buffer* b = NULL;
884 if (event == AudioTrack::EVENT_MORE_DATA) {
885 b = static_cast<AudioTrack::Buffer *>(info);
886 }
887
888 if (mToggle != toggle) {
889 ALOGV("process wrong toggle %p channel %d", this, mChannelID);
890 if (b != NULL) {
891 b->size = 0;
892 }
893 return;
894 }
895
896 sp<Sample> sample = mSample;
897
898 // ALOGV("SoundChannel::process event %d", event);
899
900 if (event == AudioTrack::EVENT_MORE_DATA) {
901
902 // check for stop state
903 if (b->size == 0) return;
904
905 if (mState == IDLE) {
906 b->size = 0;
907 return;
908 }
909
910 if (sample != 0) {
911 // fill buffer
912 uint8_t* q = (uint8_t*) b->i8;
913 size_t count = 0;
914
915 if (mPos < (int)sample->size()) {
916 uint8_t* p = sample->data() + mPos;
917 count = sample->size() - mPos;
918 if (count > b->size) {
919 count = b->size;
920 }
921 memcpy(q, p, count);
922 // ALOGV("fill: q=%p, p=%p, mPos=%u, b->size=%u, count=%d", q, p, mPos, b->size,
923 // count);
924 } else if (mPos < mAudioBufferSize) {
925 count = mAudioBufferSize - mPos;
926 if (count > b->size) {
927 count = b->size;
928 }
929 memset(q, 0, count);
930 // ALOGV("fill extra: q=%p, mPos=%u, b->size=%u, count=%d", q, mPos, b->size, count);
931 }
932
933 mPos += count;
934 b->size = count;
935 //ALOGV("buffer=%p, [0]=%d", b->i16, b->i16[0]);
936 }
937 } else if (event == AudioTrack::EVENT_UNDERRUN || event == AudioTrack::EVENT_BUFFER_END) {
938 ALOGV("process %p channel %d event %s",
939 this, mChannelID, (event == AudioTrack::EVENT_UNDERRUN) ? "UNDERRUN" :
940 "BUFFER_END");
941 mSoundPool->addToStopList(this);
942 } else if (event == AudioTrack::EVENT_LOOP_END) {
943 ALOGV("End loop %p channel %d", this, mChannelID);
944 } else if (event == AudioTrack::EVENT_NEW_IAUDIOTRACK) {
945 ALOGV("process %p channel %d NEW_IAUDIOTRACK", this, mChannelID);
946 } else {
947 ALOGW("SoundChannel::process unexpected event %d", event);
948 }
949 }
950
951
952 // call with lock held
doStop_l()953 bool SoundChannel::doStop_l()
954 {
955 if (mState != IDLE) {
956 setVolume_l(0, 0);
957 ALOGV("stop");
958 mAudioTrack->stop();
959 mPrevSampleID = mSample->sampleID();
960 mSample.clear();
961 mState = IDLE;
962 mPriority = IDLE_PRIORITY;
963 return true;
964 }
965 return false;
966 }
967
968 // call with lock held and sound pool lock held
stop_l()969 void SoundChannel::stop_l()
970 {
971 if (doStop_l()) {
972 mSoundPool->done_l(this);
973 }
974 }
975
976 // call with sound pool lock held
stop()977 void SoundChannel::stop()
978 {
979 bool stopped;
980 {
981 Mutex::Autolock lock(&mLock);
982 stopped = doStop_l();
983 }
984
985 if (stopped) {
986 mSoundPool->done_l(this);
987 }
988 }
989
990 //FIXME: Pause is a little broken right now
pause()991 void SoundChannel::pause()
992 {
993 Mutex::Autolock lock(&mLock);
994 if (mState == PLAYING) {
995 ALOGV("pause track");
996 mState = PAUSED;
997 mAudioTrack->pause();
998 }
999 }
1000
autoPause()1001 void SoundChannel::autoPause()
1002 {
1003 Mutex::Autolock lock(&mLock);
1004 if (mState == PLAYING) {
1005 ALOGV("pause track");
1006 mState = PAUSED;
1007 mAutoPaused = true;
1008 mAudioTrack->pause();
1009 }
1010 }
1011
resume()1012 void SoundChannel::resume()
1013 {
1014 Mutex::Autolock lock(&mLock);
1015 if (mState == PAUSED) {
1016 ALOGV("resume track");
1017 mState = PLAYING;
1018 mAutoPaused = false;
1019 mAudioTrack->start();
1020 }
1021 }
1022
autoResume()1023 void SoundChannel::autoResume()
1024 {
1025 Mutex::Autolock lock(&mLock);
1026 if (mAutoPaused && (mState == PAUSED)) {
1027 ALOGV("resume track");
1028 mState = PLAYING;
1029 mAutoPaused = false;
1030 mAudioTrack->start();
1031 }
1032 }
1033
setRate(float rate)1034 void SoundChannel::setRate(float rate)
1035 {
1036 Mutex::Autolock lock(&mLock);
1037 if (mAudioTrack != NULL && mSample != 0) {
1038 uint32_t sampleRate = uint32_t(float(mSample->sampleRate()) * rate + 0.5);
1039 mAudioTrack->setSampleRate(sampleRate);
1040 mRate = rate;
1041 }
1042 }
1043
1044 // call with lock held
setVolume_l(float leftVolume,float rightVolume)1045 void SoundChannel::setVolume_l(float leftVolume, float rightVolume)
1046 {
1047 mLeftVolume = leftVolume;
1048 mRightVolume = rightVolume;
1049 if (mAudioTrack != NULL && !mMuted)
1050 mAudioTrack->setVolume(leftVolume, rightVolume);
1051 }
1052
setVolume(float leftVolume,float rightVolume)1053 void SoundChannel::setVolume(float leftVolume, float rightVolume)
1054 {
1055 Mutex::Autolock lock(&mLock);
1056 setVolume_l(leftVolume, rightVolume);
1057 }
1058
mute(bool muting)1059 void SoundChannel::mute(bool muting)
1060 {
1061 Mutex::Autolock lock(&mLock);
1062 mMuted = muting;
1063 if (mAudioTrack != NULL) {
1064 if (mMuted) {
1065 mAudioTrack->setVolume(0.0f, 0.0f);
1066 } else {
1067 mAudioTrack->setVolume(mLeftVolume, mRightVolume);
1068 }
1069 }
1070 }
1071
setLoop(int loop)1072 void SoundChannel::setLoop(int loop)
1073 {
1074 Mutex::Autolock lock(&mLock);
1075 if (mAudioTrack != NULL && mSample != 0) {
1076 uint32_t loopEnd = mSample->size()/mNumChannels/
1077 ((mSample->format() == AUDIO_FORMAT_PCM_16_BIT) ? sizeof(int16_t) : sizeof(uint8_t));
1078 mAudioTrack->setLoop(0, loopEnd, loop);
1079 mLoop = loop;
1080 }
1081 }
1082
~SoundChannel()1083 SoundChannel::~SoundChannel()
1084 {
1085 ALOGV("SoundChannel destructor %p", this);
1086 {
1087 Mutex::Autolock lock(&mLock);
1088 clearNextEvent();
1089 doStop_l();
1090 }
1091 // do not call AudioTrack destructor with mLock held as it will wait for the AudioTrack
1092 // callback thread to exit which may need to execute process() and acquire the mLock.
1093 mAudioTrack.clear();
1094 }
1095
dump()1096 void SoundChannel::dump()
1097 {
1098 ALOGV("mState = %d mChannelID=%d, mNumChannels=%d, mPos = %d, mPriority=%d, mLoop=%d",
1099 mState, mChannelID, mNumChannels, mPos, mPriority, mLoop);
1100 }
1101
set(const sp<Sample> & sample,int channelID,float leftVolume,float rightVolume,int priority,int loop,float rate)1102 void SoundEvent::set(const sp<Sample>& sample, int channelID, float leftVolume,
1103 float rightVolume, int priority, int loop, float rate)
1104 {
1105 mSample = sample;
1106 mChannelID = channelID;
1107 mLeftVolume = leftVolume;
1108 mRightVolume = rightVolume;
1109 mPriority = priority;
1110 mLoop = loop;
1111 mRate =rate;
1112 }
1113
1114 } // end namespace android
1115