NuPlayerRenderer.cpp revision 7665f5886093e1aee07a5266b8c384e5d1186f34 
1/*
2 * Copyright (C) 2010 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 "NuPlayerRenderer"
19#include <utils/Log.h>
20
21#include "NuPlayerRenderer.h"
22#include <cutils/properties.h>
23#include <media/stagefright/foundation/ABuffer.h>
24#include <media/stagefright/foundation/ADebug.h>
25#include <media/stagefright/foundation/AMessage.h>
26#include <media/stagefright/foundation/AUtils.h>
27#include <media/stagefright/foundation/AWakeLock.h>
28#include <media/stagefright/MediaClock.h>
29#include <media/stagefright/MediaErrors.h>
30#include <media/stagefright/MetaData.h>
31#include <media/stagefright/Utils.h>
32#include <media/stagefright/VideoFrameScheduler.h>
33
34#include <inttypes.h>
35
36namespace android {
37
38/*
39 * Example of common configuration settings in shell script form
40
41   #Turn offload audio off (use PCM for Play Music) -- AudioPolicyManager
42   adb shell setprop audio.offload.disable 1
43
44   #Allow offload audio with video (requires offloading to be enabled) -- AudioPolicyManager
45   adb shell setprop audio.offload.video 1
46
47   #Use audio callbacks for PCM data
48   adb shell setprop media.stagefright.audio.cbk 1
49
50   #Use deep buffer for PCM data with video (it is generally enabled for audio-only)
51   adb shell setprop media.stagefright.audio.deep 1
52
53   #Set size of buffers for pcm audio sink in msec (example: 1000 msec)
54   adb shell setprop media.stagefright.audio.sink 1000
55
56 * These configurations take effect for the next track played (not the current track).
57 */
58
59static inline bool getUseAudioCallbackSetting() {
60    return property_get_bool("media.stagefright.audio.cbk", false /* default_value */);
61}
62
63static inline int32_t getAudioSinkPcmMsSetting() {
64    return property_get_int32(
65            "media.stagefright.audio.sink", 500 /* default_value */);
66}
67
68// Maximum time in paused state when offloading audio decompression. When elapsed, the AudioSink
69// is closed to allow the audio DSP to power down.
70static const int64_t kOffloadPauseMaxUs = 10000000ll;
71
72// static
73const NuPlayer::Renderer::PcmInfo NuPlayer::Renderer::AUDIO_PCMINFO_INITIALIZER = {
74        AUDIO_CHANNEL_NONE,
75        AUDIO_OUTPUT_FLAG_NONE,
76        AUDIO_FORMAT_INVALID,
77        0, // mNumChannels
78        0 // mSampleRate
79};
80
81// static
82const int64_t NuPlayer::Renderer::kMinPositionUpdateDelayUs = 100000ll;
83
84NuPlayer::Renderer::Renderer(
85        const sp<MediaPlayerBase::AudioSink> &sink,
86        const sp<AMessage> &notify,
87        uint32_t flags)
88    : mAudioSink(sink),
89      mNotify(notify),
90      mFlags(flags),
91      mNumFramesWritten(0),
92      mDrainAudioQueuePending(false),
93      mDrainVideoQueuePending(false),
94      mAudioQueueGeneration(0),
95      mVideoQueueGeneration(0),
96      mAudioDrainGeneration(0),
97      mVideoDrainGeneration(0),
98      mPlaybackSettings(AUDIO_PLAYBACK_RATE_DEFAULT),
99      mAudioFirstAnchorTimeMediaUs(-1),
100      mAnchorTimeMediaUs(-1),
101      mAnchorNumFramesWritten(-1),
102      mVideoLateByUs(0ll),
103      mHasAudio(false),
104      mHasVideo(false),
105      mNotifyCompleteAudio(false),
106      mNotifyCompleteVideo(false),
107      mSyncQueues(false),
108      mPaused(false),
109      mVideoSampleReceived(false),
110      mVideoRenderingStarted(false),
111      mVideoRenderingStartGeneration(0),
112      mAudioRenderingStartGeneration(0),
113      mAudioOffloadPauseTimeoutGeneration(0),
114      mAudioTornDown(false),
115      mCurrentOffloadInfo(AUDIO_INFO_INITIALIZER),
116      mCurrentPcmInfo(AUDIO_PCMINFO_INITIALIZER),
117      mTotalBuffersQueued(0),
118      mLastAudioBufferDrained(0),
119      mUseAudioCallback(false),
120      mWakeLock(new AWakeLock()) {
121    mMediaClock = new MediaClock;
122    mPlaybackRate = mPlaybackSettings.mSpeed;
123    mMediaClock->setPlaybackRate(mPlaybackRate);
124}
125
126NuPlayer::Renderer::~Renderer() {
127    if (offloadingAudio()) {
128        mAudioSink->stop();
129        mAudioSink->flush();
130        mAudioSink->close();
131    }
132}
133
134void NuPlayer::Renderer::queueBuffer(
135        bool audio,
136        const sp<ABuffer> &buffer,
137        const sp<AMessage> &notifyConsumed) {
138    sp<AMessage> msg = new AMessage(kWhatQueueBuffer, this);
139    msg->setInt32("queueGeneration", getQueueGeneration(audio));
140    msg->setInt32("audio", static_cast<int32_t>(audio));
141    msg->setBuffer("buffer", buffer);
142    msg->setMessage("notifyConsumed", notifyConsumed);
143    msg->post();
144}
145
146void NuPlayer::Renderer::queueEOS(bool audio, status_t finalResult) {
147    CHECK_NE(finalResult, (status_t)OK);
148
149    sp<AMessage> msg = new AMessage(kWhatQueueEOS, this);
150    msg->setInt32("queueGeneration", getQueueGeneration(audio));
151    msg->setInt32("audio", static_cast<int32_t>(audio));
152    msg->setInt32("finalResult", finalResult);
153    msg->post();
154}
155
156status_t NuPlayer::Renderer::setPlaybackSettings(const AudioPlaybackRate &rate) {
157    sp<AMessage> msg = new AMessage(kWhatConfigPlayback, this);
158    writeToAMessage(msg, rate);
159    sp<AMessage> response;
160    status_t err = msg->postAndAwaitResponse(&response);
161    if (err == OK && response != NULL) {
162        CHECK(response->findInt32("err", &err));
163    }
164    return err;
165}
166
167status_t NuPlayer::Renderer::onConfigPlayback(const AudioPlaybackRate &rate /* sanitized */) {
168    if (rate.mSpeed == 0.f) {
169        onPause();
170        // don't call audiosink's setPlaybackRate if pausing, as pitch does not
171        // have to correspond to the any non-0 speed (e.g old speed). Keep
172        // settings nonetheless, using the old speed, in case audiosink changes.
173        AudioPlaybackRate newRate = rate;
174        newRate.mSpeed = mPlaybackSettings.mSpeed;
175        mPlaybackSettings = newRate;
176        return OK;
177    }
178
179    if (mAudioSink != NULL && mAudioSink->ready()) {
180        status_t err = mAudioSink->setPlaybackRate(rate);
181        if (err != OK) {
182            return err;
183        }
184    }
185    mPlaybackSettings = rate;
186    mPlaybackRate = rate.mSpeed;
187    mMediaClock->setPlaybackRate(mPlaybackRate);
188    return OK;
189}
190
191status_t NuPlayer::Renderer::getPlaybackSettings(AudioPlaybackRate *rate /* nonnull */) {
192    sp<AMessage> msg = new AMessage(kWhatGetPlaybackSettings, this);
193    sp<AMessage> response;
194    status_t err = msg->postAndAwaitResponse(&response);
195    if (err == OK && response != NULL) {
196        CHECK(response->findInt32("err", &err));
197        if (err == OK) {
198            readFromAMessage(response, rate);
199        }
200    }
201    return err;
202}
203
204status_t NuPlayer::Renderer::onGetPlaybackSettings(AudioPlaybackRate *rate /* nonnull */) {
205    if (mAudioSink != NULL && mAudioSink->ready()) {
206        status_t err = mAudioSink->getPlaybackRate(rate);
207        if (err == OK) {
208            if (!isAudioPlaybackRateEqual(*rate, mPlaybackSettings)) {
209                ALOGW("correcting mismatch in internal/external playback rate");
210            }
211            // get playback settings used by audiosink, as it may be
212            // slightly off due to audiosink not taking small changes.
213            mPlaybackSettings = *rate;
214            if (mPaused) {
215                rate->mSpeed = 0.f;
216            }
217        }
218        return err;
219    }
220    *rate = mPlaybackSettings;
221    return OK;
222}
223
224status_t NuPlayer::Renderer::setSyncSettings(const AVSyncSettings &sync, float videoFpsHint) {
225    sp<AMessage> msg = new AMessage(kWhatConfigSync, this);
226    writeToAMessage(msg, sync, videoFpsHint);
227    sp<AMessage> response;
228    status_t err = msg->postAndAwaitResponse(&response);
229    if (err == OK && response != NULL) {
230        CHECK(response->findInt32("err", &err));
231    }
232    return err;
233}
234
235status_t NuPlayer::Renderer::onConfigSync(const AVSyncSettings &sync, float videoFpsHint __unused) {
236    if (sync.mSource != AVSYNC_SOURCE_DEFAULT) {
237        return BAD_VALUE;
238    }
239    // TODO: support sync sources
240    return INVALID_OPERATION;
241}
242
243status_t NuPlayer::Renderer::getSyncSettings(AVSyncSettings *sync, float *videoFps) {
244    sp<AMessage> msg = new AMessage(kWhatGetSyncSettings, this);
245    sp<AMessage> response;
246    status_t err = msg->postAndAwaitResponse(&response);
247    if (err == OK && response != NULL) {
248        CHECK(response->findInt32("err", &err));
249        if (err == OK) {
250            readFromAMessage(response, sync, videoFps);
251        }
252    }
253    return err;
254}
255
256status_t NuPlayer::Renderer::onGetSyncSettings(
257        AVSyncSettings *sync /* nonnull */, float *videoFps /* nonnull */) {
258    *sync = mSyncSettings;
259    *videoFps = -1.f;
260    return OK;
261}
262
263void NuPlayer::Renderer::flush(bool audio, bool notifyComplete) {
264    {
265        Mutex::Autolock autoLock(mLock);
266        if (audio) {
267            mNotifyCompleteAudio |= notifyComplete;
268            clearAudioFirstAnchorTime_l();
269            ++mAudioQueueGeneration;
270            ++mAudioDrainGeneration;
271        } else {
272            mNotifyCompleteVideo |= notifyComplete;
273            ++mVideoQueueGeneration;
274            ++mVideoDrainGeneration;
275        }
276
277        clearAnchorTime_l();
278        mVideoLateByUs = 0;
279        mSyncQueues = false;
280    }
281
282    sp<AMessage> msg = new AMessage(kWhatFlush, this);
283    msg->setInt32("audio", static_cast<int32_t>(audio));
284    msg->post();
285}
286
287void NuPlayer::Renderer::signalTimeDiscontinuity() {
288}
289
290void NuPlayer::Renderer::signalDisableOffloadAudio() {
291    (new AMessage(kWhatDisableOffloadAudio, this))->post();
292}
293
294void NuPlayer::Renderer::signalEnableOffloadAudio() {
295    (new AMessage(kWhatEnableOffloadAudio, this))->post();
296}
297
298void NuPlayer::Renderer::pause() {
299    (new AMessage(kWhatPause, this))->post();
300}
301
302void NuPlayer::Renderer::resume() {
303    (new AMessage(kWhatResume, this))->post();
304}
305
306void NuPlayer::Renderer::setVideoFrameRate(float fps) {
307    sp<AMessage> msg = new AMessage(kWhatSetVideoFrameRate, this);
308    msg->setFloat("frame-rate", fps);
309    msg->post();
310}
311
312// Called on any threads.
313status_t NuPlayer::Renderer::getCurrentPosition(int64_t *mediaUs) {
314    return mMediaClock->getMediaTime(ALooper::GetNowUs(), mediaUs);
315}
316
317void NuPlayer::Renderer::clearAudioFirstAnchorTime_l() {
318    mAudioFirstAnchorTimeMediaUs = -1;
319    mMediaClock->setStartingTimeMedia(-1);
320}
321
322void NuPlayer::Renderer::setAudioFirstAnchorTimeIfNeeded_l(int64_t mediaUs) {
323    if (mAudioFirstAnchorTimeMediaUs == -1) {
324        mAudioFirstAnchorTimeMediaUs = mediaUs;
325        mMediaClock->setStartingTimeMedia(mediaUs);
326    }
327}
328
329void NuPlayer::Renderer::clearAnchorTime_l() {
330    mMediaClock->clearAnchor();
331    mAnchorTimeMediaUs = -1;
332    mAnchorNumFramesWritten = -1;
333}
334
335void NuPlayer::Renderer::setVideoLateByUs(int64_t lateUs) {
336    Mutex::Autolock autoLock(mLock);
337    mVideoLateByUs = lateUs;
338}
339
340int64_t NuPlayer::Renderer::getVideoLateByUs() {
341    Mutex::Autolock autoLock(mLock);
342    return mVideoLateByUs;
343}
344
345status_t NuPlayer::Renderer::openAudioSink(
346        const sp<AMessage> &format,
347        bool offloadOnly,
348        bool hasVideo,
349        uint32_t flags,
350        bool *isOffloaded) {
351    sp<AMessage> msg = new AMessage(kWhatOpenAudioSink, this);
352    msg->setMessage("format", format);
353    msg->setInt32("offload-only", offloadOnly);
354    msg->setInt32("has-video", hasVideo);
355    msg->setInt32("flags", flags);
356
357    sp<AMessage> response;
358    msg->postAndAwaitResponse(&response);
359
360    int32_t err;
361    if (!response->findInt32("err", &err)) {
362        err = INVALID_OPERATION;
363    } else if (err == OK && isOffloaded != NULL) {
364        int32_t offload;
365        CHECK(response->findInt32("offload", &offload));
366        *isOffloaded = (offload != 0);
367    }
368    return err;
369}
370
371void NuPlayer::Renderer::closeAudioSink() {
372    sp<AMessage> msg = new AMessage(kWhatCloseAudioSink, this);
373
374    sp<AMessage> response;
375    msg->postAndAwaitResponse(&response);
376}
377
378void NuPlayer::Renderer::onMessageReceived(const sp<AMessage> &msg) {
379    switch (msg->what()) {
380        case kWhatOpenAudioSink:
381        {
382            sp<AMessage> format;
383            CHECK(msg->findMessage("format", &format));
384
385            int32_t offloadOnly;
386            CHECK(msg->findInt32("offload-only", &offloadOnly));
387
388            int32_t hasVideo;
389            CHECK(msg->findInt32("has-video", &hasVideo));
390
391            uint32_t flags;
392            CHECK(msg->findInt32("flags", (int32_t *)&flags));
393
394            status_t err = onOpenAudioSink(format, offloadOnly, hasVideo, flags);
395
396            sp<AMessage> response = new AMessage;
397            response->setInt32("err", err);
398            response->setInt32("offload", offloadingAudio());
399
400            sp<AReplyToken> replyID;
401            CHECK(msg->senderAwaitsResponse(&replyID));
402            response->postReply(replyID);
403
404            break;
405        }
406
407        case kWhatCloseAudioSink:
408        {
409            sp<AReplyToken> replyID;
410            CHECK(msg->senderAwaitsResponse(&replyID));
411
412            onCloseAudioSink();
413
414            sp<AMessage> response = new AMessage;
415            response->postReply(replyID);
416            break;
417        }
418
419        case kWhatStopAudioSink:
420        {
421            mAudioSink->stop();
422            break;
423        }
424
425        case kWhatDrainAudioQueue:
426        {
427            mDrainAudioQueuePending = false;
428
429            int32_t generation;
430            CHECK(msg->findInt32("drainGeneration", &generation));
431            if (generation != getDrainGeneration(true /* audio */)) {
432                break;
433            }
434
435            if (onDrainAudioQueue()) {
436                uint32_t numFramesPlayed;
437                CHECK_EQ(mAudioSink->getPosition(&numFramesPlayed),
438                         (status_t)OK);
439
440                uint32_t numFramesPendingPlayout =
441                    mNumFramesWritten - numFramesPlayed;
442
443                // This is how long the audio sink will have data to
444                // play back.
445                int64_t delayUs =
446                    mAudioSink->msecsPerFrame()
447                        * numFramesPendingPlayout * 1000ll;
448                if (mPlaybackRate > 1.0f) {
449                    delayUs /= mPlaybackRate;
450                }
451
452                // Let's give it more data after about half that time
453                // has elapsed.
454                Mutex::Autolock autoLock(mLock);
455                postDrainAudioQueue_l(delayUs / 2);
456            }
457            break;
458        }
459
460        case kWhatDrainVideoQueue:
461        {
462            int32_t generation;
463            CHECK(msg->findInt32("drainGeneration", &generation));
464            if (generation != getDrainGeneration(false /* audio */)) {
465                break;
466            }
467
468            mDrainVideoQueuePending = false;
469
470            onDrainVideoQueue();
471
472            postDrainVideoQueue();
473            break;
474        }
475
476        case kWhatPostDrainVideoQueue:
477        {
478            int32_t generation;
479            CHECK(msg->findInt32("drainGeneration", &generation));
480            if (generation != getDrainGeneration(false /* audio */)) {
481                break;
482            }
483
484            mDrainVideoQueuePending = false;
485            postDrainVideoQueue();
486            break;
487        }
488
489        case kWhatQueueBuffer:
490        {
491            onQueueBuffer(msg);
492            break;
493        }
494
495        case kWhatQueueEOS:
496        {
497            onQueueEOS(msg);
498            break;
499        }
500
501        case kWhatConfigPlayback:
502        {
503            sp<AReplyToken> replyID;
504            CHECK(msg->senderAwaitsResponse(&replyID));
505            AudioPlaybackRate rate;
506            readFromAMessage(msg, &rate);
507            status_t err = onConfigPlayback(rate);
508            sp<AMessage> response = new AMessage;
509            response->setInt32("err", err);
510            response->postReply(replyID);
511            break;
512        }
513
514        case kWhatGetPlaybackSettings:
515        {
516            sp<AReplyToken> replyID;
517            CHECK(msg->senderAwaitsResponse(&replyID));
518            AudioPlaybackRate rate = AUDIO_PLAYBACK_RATE_DEFAULT;
519            status_t err = onGetPlaybackSettings(&rate);
520            sp<AMessage> response = new AMessage;
521            if (err == OK) {
522                writeToAMessage(response, rate);
523            }
524            response->setInt32("err", err);
525            response->postReply(replyID);
526            break;
527        }
528
529        case kWhatConfigSync:
530        {
531            sp<AReplyToken> replyID;
532            CHECK(msg->senderAwaitsResponse(&replyID));
533            AVSyncSettings sync;
534            float videoFpsHint;
535            readFromAMessage(msg, &sync, &videoFpsHint);
536            status_t err = onConfigSync(sync, videoFpsHint);
537            sp<AMessage> response = new AMessage;
538            response->setInt32("err", err);
539            response->postReply(replyID);
540            break;
541        }
542
543        case kWhatGetSyncSettings:
544        {
545            sp<AReplyToken> replyID;
546            CHECK(msg->senderAwaitsResponse(&replyID));
547
548            ALOGV("kWhatGetSyncSettings");
549            AVSyncSettings sync;
550            float videoFps = -1.f;
551            status_t err = onGetSyncSettings(&sync, &videoFps);
552            sp<AMessage> response = new AMessage;
553            if (err == OK) {
554                writeToAMessage(response, sync, videoFps);
555            }
556            response->setInt32("err", err);
557            response->postReply(replyID);
558            break;
559        }
560
561        case kWhatFlush:
562        {
563            onFlush(msg);
564            break;
565        }
566
567        case kWhatDisableOffloadAudio:
568        {
569            onDisableOffloadAudio();
570            break;
571        }
572
573        case kWhatEnableOffloadAudio:
574        {
575            onEnableOffloadAudio();
576            break;
577        }
578
579        case kWhatPause:
580        {
581            onPause();
582            break;
583        }
584
585        case kWhatResume:
586        {
587            onResume();
588            break;
589        }
590
591        case kWhatSetVideoFrameRate:
592        {
593            float fps;
594            CHECK(msg->findFloat("frame-rate", &fps));
595            onSetVideoFrameRate(fps);
596            break;
597        }
598
599        case kWhatAudioTearDown:
600        {
601            onAudioTearDown(kDueToError);
602            break;
603        }
604
605        case kWhatAudioOffloadPauseTimeout:
606        {
607            int32_t generation;
608            CHECK(msg->findInt32("drainGeneration", &generation));
609            if (generation != mAudioOffloadPauseTimeoutGeneration) {
610                break;
611            }
612            ALOGV("Audio Offload tear down due to pause timeout.");
613            onAudioTearDown(kDueToTimeout);
614            mWakeLock->release();
615            break;
616        }
617
618        default:
619            TRESPASS();
620            break;
621    }
622}
623
624void NuPlayer::Renderer::postDrainAudioQueue_l(int64_t delayUs) {
625    if (mDrainAudioQueuePending || mSyncQueues || mUseAudioCallback) {
626        return;
627    }
628
629    if (mAudioQueue.empty()) {
630        return;
631    }
632
633    mDrainAudioQueuePending = true;
634    sp<AMessage> msg = new AMessage(kWhatDrainAudioQueue, this);
635    msg->setInt32("drainGeneration", mAudioDrainGeneration);
636    msg->post(delayUs);
637}
638
639void NuPlayer::Renderer::prepareForMediaRenderingStart_l() {
640    mAudioRenderingStartGeneration = mAudioDrainGeneration;
641    mVideoRenderingStartGeneration = mVideoDrainGeneration;
642}
643
644void NuPlayer::Renderer::notifyIfMediaRenderingStarted_l() {
645    if (mVideoRenderingStartGeneration == mVideoDrainGeneration &&
646        mAudioRenderingStartGeneration == mAudioDrainGeneration) {
647        mVideoRenderingStartGeneration = -1;
648        mAudioRenderingStartGeneration = -1;
649
650        sp<AMessage> notify = mNotify->dup();
651        notify->setInt32("what", kWhatMediaRenderingStart);
652        notify->post();
653    }
654}
655
656// static
657size_t NuPlayer::Renderer::AudioSinkCallback(
658        MediaPlayerBase::AudioSink * /* audioSink */,
659        void *buffer,
660        size_t size,
661        void *cookie,
662        MediaPlayerBase::AudioSink::cb_event_t event) {
663    NuPlayer::Renderer *me = (NuPlayer::Renderer *)cookie;
664
665    switch (event) {
666        case MediaPlayerBase::AudioSink::CB_EVENT_FILL_BUFFER:
667        {
668            return me->fillAudioBuffer(buffer, size);
669            break;
670        }
671
672        case MediaPlayerBase::AudioSink::CB_EVENT_STREAM_END:
673        {
674            ALOGV("AudioSink::CB_EVENT_STREAM_END");
675            me->notifyEOS(true /* audio */, ERROR_END_OF_STREAM);
676            break;
677        }
678
679        case MediaPlayerBase::AudioSink::CB_EVENT_TEAR_DOWN:
680        {
681            ALOGV("AudioSink::CB_EVENT_TEAR_DOWN");
682            me->notifyAudioTearDown();
683            break;
684        }
685    }
686
687    return 0;
688}
689
690size_t NuPlayer::Renderer::fillAudioBuffer(void *buffer, size_t size) {
691    Mutex::Autolock autoLock(mLock);
692
693    if (!mUseAudioCallback) {
694        return 0;
695    }
696
697    bool hasEOS = false;
698
699    size_t sizeCopied = 0;
700    bool firstEntry = true;
701    QueueEntry *entry;  // will be valid after while loop if hasEOS is set.
702    while (sizeCopied < size && !mAudioQueue.empty()) {
703        entry = &*mAudioQueue.begin();
704
705        if (entry->mBuffer == NULL) { // EOS
706            hasEOS = true;
707            mAudioQueue.erase(mAudioQueue.begin());
708            break;
709        }
710
711        if (firstEntry && entry->mOffset == 0) {
712            firstEntry = false;
713            int64_t mediaTimeUs;
714            CHECK(entry->mBuffer->meta()->findInt64("timeUs", &mediaTimeUs));
715            ALOGV("fillAudioBuffer: rendering audio at media time %.2f secs", mediaTimeUs / 1E6);
716            setAudioFirstAnchorTimeIfNeeded_l(mediaTimeUs);
717        }
718
719        size_t copy = entry->mBuffer->size() - entry->mOffset;
720        size_t sizeRemaining = size - sizeCopied;
721        if (copy > sizeRemaining) {
722            copy = sizeRemaining;
723        }
724
725        memcpy((char *)buffer + sizeCopied,
726               entry->mBuffer->data() + entry->mOffset,
727               copy);
728
729        entry->mOffset += copy;
730        if (entry->mOffset == entry->mBuffer->size()) {
731            entry->mNotifyConsumed->post();
732            mAudioQueue.erase(mAudioQueue.begin());
733            entry = NULL;
734        }
735        sizeCopied += copy;
736
737        notifyIfMediaRenderingStarted_l();
738    }
739
740    if (mAudioFirstAnchorTimeMediaUs >= 0) {
741        int64_t nowUs = ALooper::GetNowUs();
742        int64_t nowMediaUs =
743            mAudioFirstAnchorTimeMediaUs + getPlayedOutAudioDurationUs(nowUs);
744        // we don't know how much data we are queueing for offloaded tracks.
745        mMediaClock->updateAnchor(nowMediaUs, nowUs, INT64_MAX);
746    }
747
748    // for non-offloaded audio, we need to compute the frames written because
749    // there is no EVENT_STREAM_END notification. The frames written gives
750    // an estimate on the pending played out duration.
751    if (!offloadingAudio()) {
752        mNumFramesWritten += sizeCopied / mAudioSink->frameSize();
753    }
754
755    if (hasEOS) {
756        (new AMessage(kWhatStopAudioSink, this))->post();
757        // As there is currently no EVENT_STREAM_END callback notification for
758        // non-offloaded audio tracks, we need to post the EOS ourselves.
759        if (!offloadingAudio()) {
760            int64_t postEOSDelayUs = 0;
761            if (mAudioSink->needsTrailingPadding()) {
762                postEOSDelayUs = getPendingAudioPlayoutDurationUs(ALooper::GetNowUs());
763            }
764            ALOGV("fillAudioBuffer: notifyEOS "
765                    "mNumFramesWritten:%u  finalResult:%d  postEOSDelay:%lld",
766                    mNumFramesWritten, entry->mFinalResult, (long long)postEOSDelayUs);
767            notifyEOS(true /* audio */, entry->mFinalResult, postEOSDelayUs);
768        }
769    }
770    return sizeCopied;
771}
772
773void NuPlayer::Renderer::drainAudioQueueUntilLastEOS() {
774    List<QueueEntry>::iterator it = mAudioQueue.begin(), itEOS = it;
775    bool foundEOS = false;
776    while (it != mAudioQueue.end()) {
777        int32_t eos;
778        QueueEntry *entry = &*it++;
779        if (entry->mBuffer == NULL
780                || (entry->mNotifyConsumed->findInt32("eos", &eos) && eos != 0)) {
781            itEOS = it;
782            foundEOS = true;
783        }
784    }
785
786    if (foundEOS) {
787        // post all replies before EOS and drop the samples
788        for (it = mAudioQueue.begin(); it != itEOS; it++) {
789            if (it->mBuffer == NULL) {
790                // delay doesn't matter as we don't even have an AudioTrack
791                notifyEOS(true /* audio */, it->mFinalResult);
792            } else {
793                it->mNotifyConsumed->post();
794            }
795        }
796        mAudioQueue.erase(mAudioQueue.begin(), itEOS);
797    }
798}
799
800bool NuPlayer::Renderer::onDrainAudioQueue() {
801    // TODO: This call to getPosition checks if AudioTrack has been created
802    // in AudioSink before draining audio. If AudioTrack doesn't exist, then
803    // CHECKs on getPosition will fail.
804    // We still need to figure out why AudioTrack is not created when
805    // this function is called. One possible reason could be leftover
806    // audio. Another possible place is to check whether decoder
807    // has received INFO_FORMAT_CHANGED as the first buffer since
808    // AudioSink is opened there, and possible interactions with flush
809    // immediately after start. Investigate error message
810    // "vorbis_dsp_synthesis returned -135", along with RTSP.
811    uint32_t numFramesPlayed;
812    if (mAudioSink->getPosition(&numFramesPlayed) != OK) {
813        // When getPosition fails, renderer will not reschedule the draining
814        // unless new samples are queued.
815        // If we have pending EOS (or "eos" marker for discontinuities), we need
816        // to post these now as NuPlayerDecoder might be waiting for it.
817        drainAudioQueueUntilLastEOS();
818
819        ALOGW("onDrainAudioQueue(): audio sink is not ready");
820        return false;
821    }
822
823#if 0
824    ssize_t numFramesAvailableToWrite =
825        mAudioSink->frameCount() - (mNumFramesWritten - numFramesPlayed);
826
827    if (numFramesAvailableToWrite == mAudioSink->frameCount()) {
828        ALOGI("audio sink underrun");
829    } else {
830        ALOGV("audio queue has %d frames left to play",
831             mAudioSink->frameCount() - numFramesAvailableToWrite);
832    }
833#endif
834
835    uint32_t prevFramesWritten = mNumFramesWritten;
836    while (!mAudioQueue.empty()) {
837        QueueEntry *entry = &*mAudioQueue.begin();
838
839        mLastAudioBufferDrained = entry->mBufferOrdinal;
840
841        if (entry->mBuffer == NULL) {
842            // EOS
843            int64_t postEOSDelayUs = 0;
844            if (mAudioSink->needsTrailingPadding()) {
845                postEOSDelayUs = getPendingAudioPlayoutDurationUs(ALooper::GetNowUs());
846            }
847            notifyEOS(true /* audio */, entry->mFinalResult, postEOSDelayUs);
848
849            mAudioQueue.erase(mAudioQueue.begin());
850            entry = NULL;
851            if (mAudioSink->needsTrailingPadding()) {
852                // If we're not in gapless playback (i.e. through setNextPlayer), we
853                // need to stop the track here, because that will play out the last
854                // little bit at the end of the file. Otherwise short files won't play.
855                mAudioSink->stop();
856                mNumFramesWritten = 0;
857            }
858            return false;
859        }
860
861        // ignore 0-sized buffer which could be EOS marker with no data
862        if (entry->mOffset == 0 && entry->mBuffer->size() > 0) {
863            int64_t mediaTimeUs;
864            CHECK(entry->mBuffer->meta()->findInt64("timeUs", &mediaTimeUs));
865            ALOGV("onDrainAudioQueue: rendering audio at media time %.2f secs",
866                    mediaTimeUs / 1E6);
867            onNewAudioMediaTime(mediaTimeUs);
868        }
869
870        size_t copy = entry->mBuffer->size() - entry->mOffset;
871
872        ssize_t written = mAudioSink->write(entry->mBuffer->data() + entry->mOffset,
873                                            copy, false /* blocking */);
874        if (written < 0) {
875            // An error in AudioSink write. Perhaps the AudioSink was not properly opened.
876            if (written == WOULD_BLOCK) {
877                ALOGV("AudioSink write would block when writing %zu bytes", copy);
878            } else {
879                ALOGE("AudioSink write error(%zd) when writing %zu bytes", written, copy);
880                // This can only happen when AudioSink was opened with doNotReconnect flag set to
881                // true, in which case the NuPlayer will handle the reconnect.
882                notifyAudioTearDown();
883            }
884            break;
885        }
886
887        entry->mOffset += written;
888        if (entry->mOffset == entry->mBuffer->size()) {
889            entry->mNotifyConsumed->post();
890            mAudioQueue.erase(mAudioQueue.begin());
891
892            entry = NULL;
893        }
894
895        size_t copiedFrames = written / mAudioSink->frameSize();
896        mNumFramesWritten += copiedFrames;
897
898        {
899            Mutex::Autolock autoLock(mLock);
900            notifyIfMediaRenderingStarted_l();
901        }
902
903        if (written != (ssize_t)copy) {
904            // A short count was received from AudioSink::write()
905            //
906            // AudioSink write is called in non-blocking mode.
907            // It may return with a short count when:
908            //
909            // 1) Size to be copied is not a multiple of the frame size. We consider this fatal.
910            // 2) The data to be copied exceeds the available buffer in AudioSink.
911            // 3) An error occurs and data has been partially copied to the buffer in AudioSink.
912            // 4) AudioSink is an AudioCache for data retrieval, and the AudioCache is exceeded.
913
914            // (Case 1)
915            // Must be a multiple of the frame size.  If it is not a multiple of a frame size, it
916            // needs to fail, as we should not carry over fractional frames between calls.
917            CHECK_EQ(copy % mAudioSink->frameSize(), 0);
918
919            // (Case 2, 3, 4)
920            // Return early to the caller.
921            // Beware of calling immediately again as this may busy-loop if you are not careful.
922            ALOGV("AudioSink write short frame count %zd < %zu", written, copy);
923            break;
924        }
925    }
926    int64_t maxTimeMedia;
927    {
928        Mutex::Autolock autoLock(mLock);
929        maxTimeMedia =
930            mAnchorTimeMediaUs +
931                    (int64_t)(max((long long)mNumFramesWritten - mAnchorNumFramesWritten, 0LL)
932                            * 1000LL * mAudioSink->msecsPerFrame());
933    }
934    mMediaClock->updateMaxTimeMedia(maxTimeMedia);
935
936    // calculate whether we need to reschedule another write.
937    bool reschedule = !mAudioQueue.empty()
938            && (!mPaused
939                || prevFramesWritten != mNumFramesWritten); // permit pause to fill buffers
940    //ALOGD("reschedule:%d  empty:%d  mPaused:%d  prevFramesWritten:%u  mNumFramesWritten:%u",
941    //        reschedule, mAudioQueue.empty(), mPaused, prevFramesWritten, mNumFramesWritten);
942    return reschedule;
943}
944
945int64_t NuPlayer::Renderer::getDurationUsIfPlayedAtSampleRate(uint32_t numFrames) {
946    int32_t sampleRate = offloadingAudio() ?
947            mCurrentOffloadInfo.sample_rate : mCurrentPcmInfo.mSampleRate;
948    // TODO: remove the (int32_t) casting below as it may overflow at 12.4 hours.
949    return (int64_t)((int32_t)numFrames * 1000000LL / sampleRate);
950}
951
952// Calculate duration of pending samples if played at normal rate (i.e., 1.0).
953int64_t NuPlayer::Renderer::getPendingAudioPlayoutDurationUs(int64_t nowUs) {
954    int64_t writtenAudioDurationUs = getDurationUsIfPlayedAtSampleRate(mNumFramesWritten);
955    return writtenAudioDurationUs - getPlayedOutAudioDurationUs(nowUs);
956}
957
958int64_t NuPlayer::Renderer::getRealTimeUs(int64_t mediaTimeUs, int64_t nowUs) {
959    int64_t realUs;
960    if (mMediaClock->getRealTimeFor(mediaTimeUs, &realUs) != OK) {
961        // If failed to get current position, e.g. due to audio clock is
962        // not ready, then just play out video immediately without delay.
963        return nowUs;
964    }
965    return realUs;
966}
967
968void NuPlayer::Renderer::onNewAudioMediaTime(int64_t mediaTimeUs) {
969    Mutex::Autolock autoLock(mLock);
970    // TRICKY: vorbis decoder generates multiple frames with the same
971    // timestamp, so only update on the first frame with a given timestamp
972    if (mediaTimeUs == mAnchorTimeMediaUs) {
973        return;
974    }
975    setAudioFirstAnchorTimeIfNeeded_l(mediaTimeUs);
976    int64_t nowUs = ALooper::GetNowUs();
977    int64_t nowMediaUs = mediaTimeUs - getPendingAudioPlayoutDurationUs(nowUs);
978    mMediaClock->updateAnchor(nowMediaUs, nowUs, mediaTimeUs);
979    mAnchorNumFramesWritten = mNumFramesWritten;
980    mAnchorTimeMediaUs = mediaTimeUs;
981}
982
983// Called without mLock acquired.
984void NuPlayer::Renderer::postDrainVideoQueue() {
985    if (mDrainVideoQueuePending
986            || getSyncQueues()
987            || (mPaused && mVideoSampleReceived)) {
988        return;
989    }
990
991    if (mVideoQueue.empty()) {
992        return;
993    }
994
995    QueueEntry &entry = *mVideoQueue.begin();
996
997    sp<AMessage> msg = new AMessage(kWhatDrainVideoQueue, this);
998    msg->setInt32("drainGeneration", getDrainGeneration(false /* audio */));
999
1000    if (entry.mBuffer == NULL) {
1001        // EOS doesn't carry a timestamp.
1002        msg->post();
1003        mDrainVideoQueuePending = true;
1004        return;
1005    }
1006
1007    int64_t delayUs;
1008    int64_t nowUs = ALooper::GetNowUs();
1009    int64_t realTimeUs;
1010    if (mFlags & FLAG_REAL_TIME) {
1011        int64_t mediaTimeUs;
1012        CHECK(entry.mBuffer->meta()->findInt64("timeUs", &mediaTimeUs));
1013        realTimeUs = mediaTimeUs;
1014    } else {
1015        int64_t mediaTimeUs;
1016        CHECK(entry.mBuffer->meta()->findInt64("timeUs", &mediaTimeUs));
1017
1018        {
1019            Mutex::Autolock autoLock(mLock);
1020            if (mAnchorTimeMediaUs < 0) {
1021                mMediaClock->updateAnchor(mediaTimeUs, nowUs, mediaTimeUs);
1022                mAnchorTimeMediaUs = mediaTimeUs;
1023                realTimeUs = nowUs;
1024            } else {
1025                realTimeUs = getRealTimeUs(mediaTimeUs, nowUs);
1026            }
1027        }
1028        if (!mHasAudio) {
1029            // smooth out videos >= 10fps
1030            mMediaClock->updateMaxTimeMedia(mediaTimeUs + 100000);
1031        }
1032
1033        // Heuristics to handle situation when media time changed without a
1034        // discontinuity. If we have not drained an audio buffer that was
1035        // received after this buffer, repost in 10 msec. Otherwise repost
1036        // in 500 msec.
1037        delayUs = realTimeUs - nowUs;
1038        if (delayUs > 500000) {
1039            int64_t postDelayUs = 500000;
1040            if (mHasAudio && (mLastAudioBufferDrained - entry.mBufferOrdinal) <= 0) {
1041                postDelayUs = 10000;
1042            }
1043            msg->setWhat(kWhatPostDrainVideoQueue);
1044            msg->post(postDelayUs);
1045            mVideoScheduler->restart();
1046            ALOGI("possible video time jump of %dms, retrying in %dms",
1047                    (int)(delayUs / 1000), (int)(postDelayUs / 1000));
1048            mDrainVideoQueuePending = true;
1049            return;
1050        }
1051    }
1052
1053    realTimeUs = mVideoScheduler->schedule(realTimeUs * 1000) / 1000;
1054    int64_t twoVsyncsUs = 2 * (mVideoScheduler->getVsyncPeriod() / 1000);
1055
1056    delayUs = realTimeUs - nowUs;
1057
1058    ALOGW_IF(delayUs > 500000, "unusually high delayUs: %" PRId64, delayUs);
1059    // post 2 display refreshes before rendering is due
1060    msg->post(delayUs > twoVsyncsUs ? delayUs - twoVsyncsUs : 0);
1061
1062    mDrainVideoQueuePending = true;
1063}
1064
1065void NuPlayer::Renderer::onDrainVideoQueue() {
1066    if (mVideoQueue.empty()) {
1067        return;
1068    }
1069
1070    QueueEntry *entry = &*mVideoQueue.begin();
1071
1072    if (entry->mBuffer == NULL) {
1073        // EOS
1074
1075        notifyEOS(false /* audio */, entry->mFinalResult);
1076
1077        mVideoQueue.erase(mVideoQueue.begin());
1078        entry = NULL;
1079
1080        setVideoLateByUs(0);
1081        return;
1082    }
1083
1084    int64_t nowUs = -1;
1085    int64_t realTimeUs;
1086    if (mFlags & FLAG_REAL_TIME) {
1087        CHECK(entry->mBuffer->meta()->findInt64("timeUs", &realTimeUs));
1088    } else {
1089        int64_t mediaTimeUs;
1090        CHECK(entry->mBuffer->meta()->findInt64("timeUs", &mediaTimeUs));
1091
1092        nowUs = ALooper::GetNowUs();
1093        realTimeUs = getRealTimeUs(mediaTimeUs, nowUs);
1094    }
1095
1096    bool tooLate = false;
1097
1098    if (!mPaused) {
1099        if (nowUs == -1) {
1100            nowUs = ALooper::GetNowUs();
1101        }
1102        setVideoLateByUs(nowUs - realTimeUs);
1103        tooLate = (mVideoLateByUs > 40000);
1104
1105        if (tooLate) {
1106            ALOGV("video late by %lld us (%.2f secs)",
1107                 (long long)mVideoLateByUs, mVideoLateByUs / 1E6);
1108        } else {
1109            int64_t mediaUs = 0;
1110            mMediaClock->getMediaTime(realTimeUs, &mediaUs);
1111            ALOGV("rendering video at media time %.2f secs",
1112                    (mFlags & FLAG_REAL_TIME ? realTimeUs :
1113                    mediaUs) / 1E6);
1114        }
1115    } else {
1116        setVideoLateByUs(0);
1117        if (!mVideoSampleReceived && !mHasAudio) {
1118            // This will ensure that the first frame after a flush won't be used as anchor
1119            // when renderer is in paused state, because resume can happen any time after seek.
1120            Mutex::Autolock autoLock(mLock);
1121            clearAnchorTime_l();
1122        }
1123    }
1124
1125    entry->mNotifyConsumed->setInt64("timestampNs", realTimeUs * 1000ll);
1126    entry->mNotifyConsumed->setInt32("render", !tooLate);
1127    entry->mNotifyConsumed->post();
1128    mVideoQueue.erase(mVideoQueue.begin());
1129    entry = NULL;
1130
1131    mVideoSampleReceived = true;
1132
1133    if (!mPaused) {
1134        if (!mVideoRenderingStarted) {
1135            mVideoRenderingStarted = true;
1136            notifyVideoRenderingStart();
1137        }
1138        Mutex::Autolock autoLock(mLock);
1139        notifyIfMediaRenderingStarted_l();
1140    }
1141}
1142
1143void NuPlayer::Renderer::notifyVideoRenderingStart() {
1144    sp<AMessage> notify = mNotify->dup();
1145    notify->setInt32("what", kWhatVideoRenderingStart);
1146    notify->post();
1147}
1148
1149void NuPlayer::Renderer::notifyEOS(bool audio, status_t finalResult, int64_t delayUs) {
1150    sp<AMessage> notify = mNotify->dup();
1151    notify->setInt32("what", kWhatEOS);
1152    notify->setInt32("audio", static_cast<int32_t>(audio));
1153    notify->setInt32("finalResult", finalResult);
1154    notify->post(delayUs);
1155}
1156
1157void NuPlayer::Renderer::notifyAudioTearDown() {
1158    (new AMessage(kWhatAudioTearDown, this))->post();
1159}
1160
1161void NuPlayer::Renderer::onQueueBuffer(const sp<AMessage> &msg) {
1162    int32_t audio;
1163    CHECK(msg->findInt32("audio", &audio));
1164
1165    if (dropBufferIfStale(audio, msg)) {
1166        return;
1167    }
1168
1169    if (audio) {
1170        mHasAudio = true;
1171    } else {
1172        mHasVideo = true;
1173    }
1174
1175    if (mHasVideo) {
1176        if (mVideoScheduler == NULL) {
1177            mVideoScheduler = new VideoFrameScheduler();
1178            mVideoScheduler->init();
1179        }
1180    }
1181
1182    sp<ABuffer> buffer;
1183    CHECK(msg->findBuffer("buffer", &buffer));
1184
1185    sp<AMessage> notifyConsumed;
1186    CHECK(msg->findMessage("notifyConsumed", &notifyConsumed));
1187
1188    QueueEntry entry;
1189    entry.mBuffer = buffer;
1190    entry.mNotifyConsumed = notifyConsumed;
1191    entry.mOffset = 0;
1192    entry.mFinalResult = OK;
1193    entry.mBufferOrdinal = ++mTotalBuffersQueued;
1194
1195    if (audio) {
1196        Mutex::Autolock autoLock(mLock);
1197        mAudioQueue.push_back(entry);
1198        postDrainAudioQueue_l();
1199    } else {
1200        mVideoQueue.push_back(entry);
1201        postDrainVideoQueue();
1202    }
1203
1204    Mutex::Autolock autoLock(mLock);
1205    if (!mSyncQueues || mAudioQueue.empty() || mVideoQueue.empty()) {
1206        return;
1207    }
1208
1209    sp<ABuffer> firstAudioBuffer = (*mAudioQueue.begin()).mBuffer;
1210    sp<ABuffer> firstVideoBuffer = (*mVideoQueue.begin()).mBuffer;
1211
1212    if (firstAudioBuffer == NULL || firstVideoBuffer == NULL) {
1213        // EOS signalled on either queue.
1214        syncQueuesDone_l();
1215        return;
1216    }
1217
1218    int64_t firstAudioTimeUs;
1219    int64_t firstVideoTimeUs;
1220    CHECK(firstAudioBuffer->meta()
1221            ->findInt64("timeUs", &firstAudioTimeUs));
1222    CHECK(firstVideoBuffer->meta()
1223            ->findInt64("timeUs", &firstVideoTimeUs));
1224
1225    int64_t diff = firstVideoTimeUs - firstAudioTimeUs;
1226
1227    ALOGV("queueDiff = %.2f secs", diff / 1E6);
1228
1229    if (diff > 100000ll) {
1230        // Audio data starts More than 0.1 secs before video.
1231        // Drop some audio.
1232
1233        (*mAudioQueue.begin()).mNotifyConsumed->post();
1234        mAudioQueue.erase(mAudioQueue.begin());
1235        return;
1236    }
1237
1238    syncQueuesDone_l();
1239}
1240
1241void NuPlayer::Renderer::syncQueuesDone_l() {
1242    if (!mSyncQueues) {
1243        return;
1244    }
1245
1246    mSyncQueues = false;
1247
1248    if (!mAudioQueue.empty()) {
1249        postDrainAudioQueue_l();
1250    }
1251
1252    if (!mVideoQueue.empty()) {
1253        mLock.unlock();
1254        postDrainVideoQueue();
1255        mLock.lock();
1256    }
1257}
1258
1259void NuPlayer::Renderer::onQueueEOS(const sp<AMessage> &msg) {
1260    int32_t audio;
1261    CHECK(msg->findInt32("audio", &audio));
1262
1263    if (dropBufferIfStale(audio, msg)) {
1264        return;
1265    }
1266
1267    int32_t finalResult;
1268    CHECK(msg->findInt32("finalResult", &finalResult));
1269
1270    QueueEntry entry;
1271    entry.mOffset = 0;
1272    entry.mFinalResult = finalResult;
1273
1274    if (audio) {
1275        Mutex::Autolock autoLock(mLock);
1276        if (mAudioQueue.empty() && mSyncQueues) {
1277            syncQueuesDone_l();
1278        }
1279        mAudioQueue.push_back(entry);
1280        postDrainAudioQueue_l();
1281    } else {
1282        if (mVideoQueue.empty() && getSyncQueues()) {
1283            Mutex::Autolock autoLock(mLock);
1284            syncQueuesDone_l();
1285        }
1286        mVideoQueue.push_back(entry);
1287        postDrainVideoQueue();
1288    }
1289}
1290
1291void NuPlayer::Renderer::onFlush(const sp<AMessage> &msg) {
1292    int32_t audio, notifyComplete;
1293    CHECK(msg->findInt32("audio", &audio));
1294
1295    {
1296        Mutex::Autolock autoLock(mLock);
1297        if (audio) {
1298            notifyComplete = mNotifyCompleteAudio;
1299            mNotifyCompleteAudio = false;
1300        } else {
1301            notifyComplete = mNotifyCompleteVideo;
1302            mNotifyCompleteVideo = false;
1303        }
1304
1305        // If we're currently syncing the queues, i.e. dropping audio while
1306        // aligning the first audio/video buffer times and only one of the
1307        // two queues has data, we may starve that queue by not requesting
1308        // more buffers from the decoder. If the other source then encounters
1309        // a discontinuity that leads to flushing, we'll never find the
1310        // corresponding discontinuity on the other queue.
1311        // Therefore we'll stop syncing the queues if at least one of them
1312        // is flushed.
1313        syncQueuesDone_l();
1314        clearAnchorTime_l();
1315    }
1316
1317    ALOGV("flushing %s", audio ? "audio" : "video");
1318    if (audio) {
1319        {
1320            Mutex::Autolock autoLock(mLock);
1321            flushQueue(&mAudioQueue);
1322
1323            ++mAudioDrainGeneration;
1324            prepareForMediaRenderingStart_l();
1325
1326            // the frame count will be reset after flush.
1327            clearAudioFirstAnchorTime_l();
1328        }
1329
1330        mDrainAudioQueuePending = false;
1331
1332        if (offloadingAudio()) {
1333            mAudioSink->pause();
1334            mAudioSink->flush();
1335            if (!mPaused) {
1336                mAudioSink->start();
1337            }
1338        } else {
1339            mAudioSink->pause();
1340            mAudioSink->flush();
1341            // Call stop() to signal to the AudioSink to completely fill the
1342            // internal buffer before resuming playback.
1343            mAudioSink->stop();
1344            if (!mPaused) {
1345                mAudioSink->start();
1346            }
1347            mNumFramesWritten = 0;
1348        }
1349    } else {
1350        flushQueue(&mVideoQueue);
1351
1352        mDrainVideoQueuePending = false;
1353
1354        if (mVideoScheduler != NULL) {
1355            mVideoScheduler->restart();
1356        }
1357
1358        Mutex::Autolock autoLock(mLock);
1359        ++mVideoDrainGeneration;
1360        prepareForMediaRenderingStart_l();
1361    }
1362
1363    mVideoSampleReceived = false;
1364
1365    if (notifyComplete) {
1366        notifyFlushComplete(audio);
1367    }
1368}
1369
1370void NuPlayer::Renderer::flushQueue(List<QueueEntry> *queue) {
1371    while (!queue->empty()) {
1372        QueueEntry *entry = &*queue->begin();
1373
1374        if (entry->mBuffer != NULL) {
1375            entry->mNotifyConsumed->post();
1376        }
1377
1378        queue->erase(queue->begin());
1379        entry = NULL;
1380    }
1381}
1382
1383void NuPlayer::Renderer::notifyFlushComplete(bool audio) {
1384    sp<AMessage> notify = mNotify->dup();
1385    notify->setInt32("what", kWhatFlushComplete);
1386    notify->setInt32("audio", static_cast<int32_t>(audio));
1387    notify->post();
1388}
1389
1390bool NuPlayer::Renderer::dropBufferIfStale(
1391        bool audio, const sp<AMessage> &msg) {
1392    int32_t queueGeneration;
1393    CHECK(msg->findInt32("queueGeneration", &queueGeneration));
1394
1395    if (queueGeneration == getQueueGeneration(audio)) {
1396        return false;
1397    }
1398
1399    sp<AMessage> notifyConsumed;
1400    if (msg->findMessage("notifyConsumed", &notifyConsumed)) {
1401        notifyConsumed->post();
1402    }
1403
1404    return true;
1405}
1406
1407void NuPlayer::Renderer::onAudioSinkChanged() {
1408    if (offloadingAudio()) {
1409        return;
1410    }
1411    CHECK(!mDrainAudioQueuePending);
1412    mNumFramesWritten = 0;
1413    {
1414        Mutex::Autolock autoLock(mLock);
1415        mAnchorNumFramesWritten = -1;
1416    }
1417    uint32_t written;
1418    if (mAudioSink->getFramesWritten(&written) == OK) {
1419        mNumFramesWritten = written;
1420    }
1421}
1422
1423void NuPlayer::Renderer::onDisableOffloadAudio() {
1424    Mutex::Autolock autoLock(mLock);
1425    mFlags &= ~FLAG_OFFLOAD_AUDIO;
1426    ++mAudioDrainGeneration;
1427    if (mAudioRenderingStartGeneration != -1) {
1428        prepareForMediaRenderingStart_l();
1429    }
1430}
1431
1432void NuPlayer::Renderer::onEnableOffloadAudio() {
1433    Mutex::Autolock autoLock(mLock);
1434    mFlags |= FLAG_OFFLOAD_AUDIO;
1435    ++mAudioDrainGeneration;
1436    if (mAudioRenderingStartGeneration != -1) {
1437        prepareForMediaRenderingStart_l();
1438    }
1439}
1440
1441void NuPlayer::Renderer::onPause() {
1442    if (mPaused) {
1443        return;
1444    }
1445
1446    {
1447        Mutex::Autolock autoLock(mLock);
1448        // we do not increment audio drain generation so that we fill audio buffer during pause.
1449        ++mVideoDrainGeneration;
1450        prepareForMediaRenderingStart_l();
1451        mPaused = true;
1452        mMediaClock->setPlaybackRate(0.0);
1453    }
1454
1455    mDrainAudioQueuePending = false;
1456    mDrainVideoQueuePending = false;
1457
1458    if (mHasAudio) {
1459        mAudioSink->pause();
1460        startAudioOffloadPauseTimeout();
1461    }
1462
1463    ALOGV("now paused audio queue has %zu entries, video has %zu entries",
1464          mAudioQueue.size(), mVideoQueue.size());
1465}
1466
1467void NuPlayer::Renderer::onResume() {
1468    if (!mPaused) {
1469        return;
1470    }
1471
1472    if (mHasAudio) {
1473        cancelAudioOffloadPauseTimeout();
1474        status_t err = mAudioSink->start();
1475        if (err != OK) {
1476            notifyAudioTearDown();
1477        }
1478    }
1479
1480    {
1481        Mutex::Autolock autoLock(mLock);
1482        mPaused = false;
1483
1484        // configure audiosink as we did not do it when pausing
1485        if (mAudioSink != NULL && mAudioSink->ready()) {
1486            mAudioSink->setPlaybackRate(mPlaybackSettings);
1487        }
1488
1489        mMediaClock->setPlaybackRate(mPlaybackRate);
1490
1491        if (!mAudioQueue.empty()) {
1492            postDrainAudioQueue_l();
1493        }
1494    }
1495
1496    if (!mVideoQueue.empty()) {
1497        postDrainVideoQueue();
1498    }
1499}
1500
1501void NuPlayer::Renderer::onSetVideoFrameRate(float fps) {
1502    if (mVideoScheduler == NULL) {
1503        mVideoScheduler = new VideoFrameScheduler();
1504    }
1505    mVideoScheduler->init(fps);
1506}
1507
1508int32_t NuPlayer::Renderer::getQueueGeneration(bool audio) {
1509    Mutex::Autolock autoLock(mLock);
1510    return (audio ? mAudioQueueGeneration : mVideoQueueGeneration);
1511}
1512
1513int32_t NuPlayer::Renderer::getDrainGeneration(bool audio) {
1514    Mutex::Autolock autoLock(mLock);
1515    return (audio ? mAudioDrainGeneration : mVideoDrainGeneration);
1516}
1517
1518bool NuPlayer::Renderer::getSyncQueues() {
1519    Mutex::Autolock autoLock(mLock);
1520    return mSyncQueues;
1521}
1522
1523// TODO: Remove unnecessary calls to getPlayedOutAudioDurationUs()
1524// as it acquires locks and may query the audio driver.
1525//
1526// Some calls could conceivably retrieve extrapolated data instead of
1527// accessing getTimestamp() or getPosition() every time a data buffer with
1528// a media time is received.
1529//
1530// Calculate duration of played samples if played at normal rate (i.e., 1.0).
1531int64_t NuPlayer::Renderer::getPlayedOutAudioDurationUs(int64_t nowUs) {
1532    uint32_t numFramesPlayed;
1533    int64_t numFramesPlayedAt;
1534    AudioTimestamp ts;
1535    static const int64_t kStaleTimestamp100ms = 100000;
1536
1537    status_t res = mAudioSink->getTimestamp(ts);
1538    if (res == OK) {                 // case 1: mixing audio tracks and offloaded tracks.
1539        numFramesPlayed = ts.mPosition;
1540        numFramesPlayedAt =
1541            ts.mTime.tv_sec * 1000000LL + ts.mTime.tv_nsec / 1000;
1542        const int64_t timestampAge = nowUs - numFramesPlayedAt;
1543        if (timestampAge > kStaleTimestamp100ms) {
1544            // This is an audio FIXME.
1545            // getTimestamp returns a timestamp which may come from audio mixing threads.
1546            // After pausing, the MixerThread may go idle, thus the mTime estimate may
1547            // become stale. Assuming that the MixerThread runs 20ms, with FastMixer at 5ms,
1548            // the max latency should be about 25ms with an average around 12ms (to be verified).
1549            // For safety we use 100ms.
1550            ALOGV("getTimestamp: returned stale timestamp nowUs(%lld) numFramesPlayedAt(%lld)",
1551                    (long long)nowUs, (long long)numFramesPlayedAt);
1552            numFramesPlayedAt = nowUs - kStaleTimestamp100ms;
1553        }
1554        //ALOGD("getTimestamp: OK %d %lld", numFramesPlayed, (long long)numFramesPlayedAt);
1555    } else if (res == WOULD_BLOCK) { // case 2: transitory state on start of a new track
1556        numFramesPlayed = 0;
1557        numFramesPlayedAt = nowUs;
1558        //ALOGD("getTimestamp: WOULD_BLOCK %d %lld",
1559        //        numFramesPlayed, (long long)numFramesPlayedAt);
1560    } else {                         // case 3: transitory at new track or audio fast tracks.
1561        res = mAudioSink->getPosition(&numFramesPlayed);
1562        CHECK_EQ(res, (status_t)OK);
1563        numFramesPlayedAt = nowUs;
1564        numFramesPlayedAt += 1000LL * mAudioSink->latency() / 2; /* XXX */
1565        //ALOGD("getPosition: %u %lld", numFramesPlayed, (long long)numFramesPlayedAt);
1566    }
1567
1568    //CHECK_EQ(numFramesPlayed & (1 << 31), 0);  // can't be negative until 12.4 hrs, test
1569    int64_t durationUs = getDurationUsIfPlayedAtSampleRate(numFramesPlayed)
1570            + nowUs - numFramesPlayedAt;
1571    if (durationUs < 0) {
1572        // Occurs when numFramesPlayed position is very small and the following:
1573        // (1) In case 1, the time nowUs is computed before getTimestamp() is called and
1574        //     numFramesPlayedAt is greater than nowUs by time more than numFramesPlayed.
1575        // (2) In case 3, using getPosition and adding mAudioSink->latency() to
1576        //     numFramesPlayedAt, by a time amount greater than numFramesPlayed.
1577        //
1578        // Both of these are transitory conditions.
1579        ALOGV("getPlayedOutAudioDurationUs: negative duration %lld set to zero", (long long)durationUs);
1580        durationUs = 0;
1581    }
1582    ALOGV("getPlayedOutAudioDurationUs(%lld) nowUs(%lld) frames(%u) framesAt(%lld)",
1583            (long long)durationUs, (long long)nowUs, numFramesPlayed, (long long)numFramesPlayedAt);
1584    return durationUs;
1585}
1586
1587void NuPlayer::Renderer::onAudioTearDown(AudioTearDownReason reason) {
1588    if (mAudioTornDown) {
1589        return;
1590    }
1591    mAudioTornDown = true;
1592
1593    int64_t currentPositionUs;
1594    sp<AMessage> notify = mNotify->dup();
1595    if (getCurrentPosition(&currentPositionUs) == OK) {
1596        notify->setInt64("positionUs", currentPositionUs);
1597    }
1598
1599    mAudioSink->stop();
1600    mAudioSink->flush();
1601
1602    notify->setInt32("what", kWhatAudioTearDown);
1603    notify->setInt32("reason", reason);
1604    notify->post();
1605}
1606
1607void NuPlayer::Renderer::startAudioOffloadPauseTimeout() {
1608    if (offloadingAudio()) {
1609        mWakeLock->acquire();
1610        sp<AMessage> msg = new AMessage(kWhatAudioOffloadPauseTimeout, this);
1611        msg->setInt32("drainGeneration", mAudioOffloadPauseTimeoutGeneration);
1612        msg->post(kOffloadPauseMaxUs);
1613    }
1614}
1615
1616void NuPlayer::Renderer::cancelAudioOffloadPauseTimeout() {
1617    if (offloadingAudio()) {
1618        mWakeLock->release(true);
1619        ++mAudioOffloadPauseTimeoutGeneration;
1620    }
1621}
1622
1623status_t NuPlayer::Renderer::onOpenAudioSink(
1624        const sp<AMessage> &format,
1625        bool offloadOnly,
1626        bool hasVideo,
1627        uint32_t flags) {
1628    ALOGV("openAudioSink: offloadOnly(%d) offloadingAudio(%d)",
1629            offloadOnly, offloadingAudio());
1630    bool audioSinkChanged = false;
1631
1632    int32_t numChannels;
1633    CHECK(format->findInt32("channel-count", &numChannels));
1634
1635    int32_t channelMask;
1636    if (!format->findInt32("channel-mask", &channelMask)) {
1637        // signal to the AudioSink to derive the mask from count.
1638        channelMask = CHANNEL_MASK_USE_CHANNEL_ORDER;
1639    }
1640
1641    int32_t sampleRate;
1642    CHECK(format->findInt32("sample-rate", &sampleRate));
1643
1644    if (offloadingAudio()) {
1645        audio_format_t audioFormat = AUDIO_FORMAT_PCM_16_BIT;
1646        AString mime;
1647        CHECK(format->findString("mime", &mime));
1648        status_t err = mapMimeToAudioFormat(audioFormat, mime.c_str());
1649
1650        if (err != OK) {
1651            ALOGE("Couldn't map mime \"%s\" to a valid "
1652                    "audio_format", mime.c_str());
1653            onDisableOffloadAudio();
1654        } else {
1655            ALOGV("Mime \"%s\" mapped to audio_format 0x%x",
1656                    mime.c_str(), audioFormat);
1657
1658            int avgBitRate = -1;
1659            format->findInt32("bit-rate", &avgBitRate);
1660
1661            int32_t aacProfile = -1;
1662            if (audioFormat == AUDIO_FORMAT_AAC
1663                    && format->findInt32("aac-profile", &aacProfile)) {
1664                // Redefine AAC format as per aac profile
1665                mapAACProfileToAudioFormat(
1666                        audioFormat,
1667                        aacProfile);
1668            }
1669
1670            audio_offload_info_t offloadInfo = AUDIO_INFO_INITIALIZER;
1671            offloadInfo.duration_us = -1;
1672            format->findInt64(
1673                    "durationUs", &offloadInfo.duration_us);
1674            offloadInfo.sample_rate = sampleRate;
1675            offloadInfo.channel_mask = channelMask;
1676            offloadInfo.format = audioFormat;
1677            offloadInfo.stream_type = AUDIO_STREAM_MUSIC;
1678            offloadInfo.bit_rate = avgBitRate;
1679            offloadInfo.has_video = hasVideo;
1680            offloadInfo.is_streaming = true;
1681
1682            if (memcmp(&mCurrentOffloadInfo, &offloadInfo, sizeof(offloadInfo)) == 0) {
1683                ALOGV("openAudioSink: no change in offload mode");
1684                // no change from previous configuration, everything ok.
1685                return OK;
1686            }
1687            mCurrentPcmInfo = AUDIO_PCMINFO_INITIALIZER;
1688
1689            ALOGV("openAudioSink: try to open AudioSink in offload mode");
1690            uint32_t offloadFlags = flags;
1691            offloadFlags |= AUDIO_OUTPUT_FLAG_COMPRESS_OFFLOAD;
1692            offloadFlags &= ~AUDIO_OUTPUT_FLAG_DEEP_BUFFER;
1693            audioSinkChanged = true;
1694            mAudioSink->close();
1695
1696            err = mAudioSink->open(
1697                    sampleRate,
1698                    numChannels,
1699                    (audio_channel_mask_t)channelMask,
1700                    audioFormat,
1701                    0 /* bufferCount - unused */,
1702                    &NuPlayer::Renderer::AudioSinkCallback,
1703                    this,
1704                    (audio_output_flags_t)offloadFlags,
1705                    &offloadInfo);
1706
1707            if (err == OK) {
1708                err = mAudioSink->setPlaybackRate(mPlaybackSettings);
1709            }
1710
1711            if (err == OK) {
1712                // If the playback is offloaded to h/w, we pass
1713                // the HAL some metadata information.
1714                // We don't want to do this for PCM because it
1715                // will be going through the AudioFlinger mixer
1716                // before reaching the hardware.
1717                // TODO
1718                mCurrentOffloadInfo = offloadInfo;
1719                if (!mPaused) { // for preview mode, don't start if paused
1720                    err = mAudioSink->start();
1721                }
1722                ALOGV_IF(err == OK, "openAudioSink: offload succeeded");
1723            }
1724            if (err != OK) {
1725                // Clean up, fall back to non offload mode.
1726                mAudioSink->close();
1727                onDisableOffloadAudio();
1728                mCurrentOffloadInfo = AUDIO_INFO_INITIALIZER;
1729                ALOGV("openAudioSink: offload failed");
1730            } else {
1731                mUseAudioCallback = true;  // offload mode transfers data through callback
1732                ++mAudioDrainGeneration;  // discard pending kWhatDrainAudioQueue message.
1733            }
1734        }
1735    }
1736    if (!offloadOnly && !offloadingAudio()) {
1737        ALOGV("openAudioSink: open AudioSink in NON-offload mode");
1738        uint32_t pcmFlags = flags;
1739        pcmFlags &= ~AUDIO_OUTPUT_FLAG_COMPRESS_OFFLOAD;
1740
1741        const PcmInfo info = {
1742                (audio_channel_mask_t)channelMask,
1743                (audio_output_flags_t)pcmFlags,
1744                AUDIO_FORMAT_PCM_16_BIT, // TODO: change to audioFormat
1745                numChannels,
1746                sampleRate
1747        };
1748        if (memcmp(&mCurrentPcmInfo, &info, sizeof(info)) == 0) {
1749            ALOGV("openAudioSink: no change in pcm mode");
1750            // no change from previous configuration, everything ok.
1751            return OK;
1752        }
1753
1754        audioSinkChanged = true;
1755        mAudioSink->close();
1756        mCurrentOffloadInfo = AUDIO_INFO_INITIALIZER;
1757        // Note: It is possible to set up the callback, but not use it to send audio data.
1758        // This requires a fix in AudioSink to explicitly specify the transfer mode.
1759        mUseAudioCallback = getUseAudioCallbackSetting();
1760        if (mUseAudioCallback) {
1761            ++mAudioDrainGeneration;  // discard pending kWhatDrainAudioQueue message.
1762        }
1763
1764        // Compute the desired buffer size.
1765        // For callback mode, the amount of time before wakeup is about half the buffer size.
1766        const uint32_t frameCount =
1767                (unsigned long long)sampleRate * getAudioSinkPcmMsSetting() / 1000;
1768
1769        // The doNotReconnect means AudioSink will signal back and let NuPlayer to re-construct
1770        // AudioSink. We don't want this when there's video because it will cause a video seek to
1771        // the previous I frame. But we do want this when there's only audio because it will give
1772        // NuPlayer a chance to switch from non-offload mode to offload mode.
1773        // So we only set doNotReconnect when there's no video.
1774        const bool doNotReconnect = !hasVideo;
1775        status_t err = mAudioSink->open(
1776                    sampleRate,
1777                    numChannels,
1778                    (audio_channel_mask_t)channelMask,
1779                    AUDIO_FORMAT_PCM_16_BIT,
1780                    0 /* bufferCount - unused */,
1781                    mUseAudioCallback ? &NuPlayer::Renderer::AudioSinkCallback : NULL,
1782                    mUseAudioCallback ? this : NULL,
1783                    (audio_output_flags_t)pcmFlags,
1784                    NULL,
1785                    doNotReconnect,
1786                    frameCount);
1787        if (err == OK) {
1788            err = mAudioSink->setPlaybackRate(mPlaybackSettings);
1789        }
1790        if (err != OK) {
1791            ALOGW("openAudioSink: non offloaded open failed status: %d", err);
1792            mCurrentPcmInfo = AUDIO_PCMINFO_INITIALIZER;
1793            return err;
1794        }
1795        mCurrentPcmInfo = info;
1796        if (!mPaused) { // for preview mode, don't start if paused
1797            mAudioSink->start();
1798        }
1799    }
1800    if (audioSinkChanged) {
1801        onAudioSinkChanged();
1802    }
1803    mAudioTornDown = false;
1804    return OK;
1805}
1806
1807void NuPlayer::Renderer::onCloseAudioSink() {
1808    mAudioSink->close();
1809    mCurrentOffloadInfo = AUDIO_INFO_INITIALIZER;
1810    mCurrentPcmInfo = AUDIO_PCMINFO_INITIALIZER;
1811}
1812
1813}  // namespace android
1814
1815