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