AudioPlayer.h revision a99a5bca365277271915cbaeea811ad87131270d
1/* 2 * Copyright (C) 2009 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#ifndef AUDIO_PLAYER_H_ 18 19#define AUDIO_PLAYER_H_ 20 21#include <media/MediaPlayerInterface.h> 22#include <media/stagefright/MediaBuffer.h> 23#include <media/stagefright/TimeSource.h> 24#include <utils/threads.h> 25 26namespace android { 27 28class MediaSource; 29class AudioTrack; 30class AwesomePlayer; 31 32class AudioPlayer : public TimeSource { 33public: 34 enum { 35 REACHED_EOS, 36 SEEK_COMPLETE 37 }; 38 39 AudioPlayer(const sp<MediaPlayerBase::AudioSink> &audioSink, 40 bool allowDeepBuffering = false, 41 AwesomePlayer *audioObserver = NULL); 42 43 virtual ~AudioPlayer(); 44 45 // Caller retains ownership of "source". 46 void setSource(const sp<MediaSource> &source); 47 48 // Return time in us. 49 virtual int64_t getRealTimeUs(); 50 51 status_t start(bool sourceAlreadyStarted = false); 52 53 void pause(bool playPendingSamples = false); 54 void resume(); 55 56 // Returns the timestamp of the last buffer played (in us). 57 int64_t getMediaTimeUs(); 58 59 // Returns true iff a mapping is established, i.e. the AudioPlayer 60 // has played at least one frame of audio. 61 bool getMediaTimeMapping(int64_t *realtime_us, int64_t *mediatime_us); 62 63 status_t seekTo(int64_t time_us); 64 65 bool isSeeking(); 66 bool reachedEOS(status_t *finalStatus); 67 68 status_t setPlaybackRatePermille(int32_t ratePermille); 69 70private: 71 friend class VideoEditorAudioPlayer; 72 sp<MediaSource> mSource; 73 AudioTrack *mAudioTrack; 74 75 MediaBuffer *mInputBuffer; 76 77 int mSampleRate; 78 int64_t mLatencyUs; 79 size_t mFrameSize; 80 81 Mutex mLock; 82 int64_t mNumFramesPlayed; 83 int64_t mNumFramesPlayedSysTimeUs; 84 85 int64_t mPositionTimeMediaUs; 86 int64_t mPositionTimeRealUs; 87 88 bool mSeeking; 89 bool mReachedEOS; 90 status_t mFinalStatus; 91 int64_t mSeekTimeUs; 92 93 bool mStarted; 94 95 bool mIsFirstBuffer; 96 status_t mFirstBufferResult; 97 MediaBuffer *mFirstBuffer; 98 99 sp<MediaPlayerBase::AudioSink> mAudioSink; 100 bool mAllowDeepBuffering; // allow audio deep audio buffers. Helps with low power audio 101 // playback but implies high latency 102 AwesomePlayer *mObserver; 103 int64_t mPinnedTimeUs; 104 105 static void AudioCallback(int event, void *user, void *info); 106 void AudioCallback(int event, void *info); 107 108 static size_t AudioSinkCallback( 109 MediaPlayerBase::AudioSink *audioSink, 110 void *data, size_t size, void *me); 111 112 size_t fillBuffer(void *data, size_t size); 113 114 int64_t getRealTimeUsLocked() const; 115 116 void reset(); 117 118 uint32_t getNumFramesPendingPlayout() const; 119 120 AudioPlayer(const AudioPlayer &); 121 AudioPlayer &operator=(const AudioPlayer &); 122}; 123 124} // namespace android 125 126#endif // AUDIO_PLAYER_H_ 127