NuPlayer.h revision e4d18c7f84186b935ac569d5919059c455edd390
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#ifndef NU_PLAYER_H_ 18 19#define NU_PLAYER_H_ 20 21#include <media/AudioResamplerPublic.h> 22#include <media/MediaPlayerInterface.h> 23#include <media/stagefright/foundation/AHandler.h> 24 25namespace android { 26 27struct ABuffer; 28struct AMessage; 29struct AudioPlaybackRate; 30struct AVSyncSettings; 31class IDataSource; 32class MetaData; 33struct NuPlayerDriver; 34 35struct NuPlayer : public AHandler { 36 NuPlayer(); 37 38 void setUID(uid_t uid); 39 40 void setDriver(const wp<NuPlayerDriver> &driver); 41 42 void setDataSourceAsync(const sp<IStreamSource> &source); 43 44 void setDataSourceAsync( 45 const sp<IMediaHTTPService> &httpService, 46 const char *url, 47 const KeyedVector<String8, String8> *headers); 48 49 void setDataSourceAsync(int fd, int64_t offset, int64_t length); 50 51 void setDataSourceAsync(const sp<DataSource> &source); 52 53 void prepareAsync(); 54 55 void setVideoSurfaceTextureAsync( 56 const sp<IGraphicBufferProducer> &bufferProducer); 57 58 void setAudioSink(const sp<MediaPlayerBase::AudioSink> &sink); 59 status_t setPlaybackSettings(const AudioPlaybackRate &rate); 60 status_t getPlaybackSettings(AudioPlaybackRate *rate /* nonnull */); 61 status_t setSyncSettings(const AVSyncSettings &sync, float videoFpsHint); 62 status_t getSyncSettings(AVSyncSettings *sync /* nonnull */, float *videoFps /* nonnull */); 63 64 void start(); 65 66 void pause(); 67 68 // Will notify the driver through "notifyResetComplete" once finished. 69 void resetAsync(); 70 71 // Will notify the driver through "notifySeekComplete" once finished 72 // and needNotify is true. 73 void seekToAsync(int64_t seekTimeUs, bool needNotify = false); 74 75 status_t setVideoScalingMode(int32_t mode); 76 status_t getTrackInfo(Parcel* reply) const; 77 status_t getSelectedTrack(int32_t type, Parcel* reply) const; 78 status_t selectTrack(size_t trackIndex, bool select, int64_t timeUs); 79 status_t getCurrentPosition(int64_t *mediaUs); 80 void getStats(Vector<sp<AMessage> > *mTrackStats); 81 82 sp<MetaData> getFileMeta(); 83 float getFrameRate(); 84 85protected: 86 virtual ~NuPlayer(); 87 88 virtual void onMessageReceived(const sp<AMessage> &msg); 89 90public: 91 struct NuPlayerStreamListener; 92 struct Source; 93 94private: 95 struct Decoder; 96 struct DecoderBase; 97 struct DecoderPassThrough; 98 struct CCDecoder; 99 struct GenericSource; 100 struct HTTPLiveSource; 101 struct Renderer; 102 struct RTSPSource; 103 struct StreamingSource; 104 struct Action; 105 struct SeekAction; 106 struct SetSurfaceAction; 107 struct ResumeDecoderAction; 108 struct FlushDecoderAction; 109 struct PostMessageAction; 110 struct SimpleAction; 111 112 enum { 113 kWhatSetDataSource = '=DaS', 114 kWhatPrepare = 'prep', 115 kWhatSetVideoSurface = '=VSu', 116 kWhatSetAudioSink = '=AuS', 117 kWhatMoreDataQueued = 'more', 118 kWhatConfigPlayback = 'cfPB', 119 kWhatConfigSync = 'cfSy', 120 kWhatGetPlaybackSettings = 'gPbS', 121 kWhatGetSyncSettings = 'gSyS', 122 kWhatStart = 'strt', 123 kWhatScanSources = 'scan', 124 kWhatVideoNotify = 'vidN', 125 kWhatAudioNotify = 'audN', 126 kWhatClosedCaptionNotify = 'capN', 127 kWhatRendererNotify = 'renN', 128 kWhatReset = 'rset', 129 kWhatSeek = 'seek', 130 kWhatPause = 'paus', 131 kWhatResume = 'rsme', 132 kWhatPollDuration = 'polD', 133 kWhatSourceNotify = 'srcN', 134 kWhatGetTrackInfo = 'gTrI', 135 kWhatGetSelectedTrack = 'gSel', 136 kWhatSelectTrack = 'selT', 137 }; 138 139 wp<NuPlayerDriver> mDriver; 140 bool mUIDValid; 141 uid_t mUID; 142 sp<Source> mSource; 143 uint32_t mSourceFlags; 144 sp<Surface> mSurface; 145 sp<MediaPlayerBase::AudioSink> mAudioSink; 146 sp<DecoderBase> mVideoDecoder; 147 bool mOffloadAudio; 148 sp<DecoderBase> mAudioDecoder; 149 sp<CCDecoder> mCCDecoder; 150 sp<Renderer> mRenderer; 151 sp<ALooper> mRendererLooper; 152 int32_t mAudioDecoderGeneration; 153 int32_t mVideoDecoderGeneration; 154 int32_t mRendererGeneration; 155 156 List<sp<Action> > mDeferredActions; 157 158 bool mAudioEOS; 159 bool mVideoEOS; 160 161 bool mScanSourcesPending; 162 int32_t mScanSourcesGeneration; 163 164 int32_t mPollDurationGeneration; 165 int32_t mTimedTextGeneration; 166 167 enum FlushStatus { 168 NONE, 169 FLUSHING_DECODER, 170 FLUSHING_DECODER_SHUTDOWN, 171 SHUTTING_DOWN_DECODER, 172 FLUSHED, 173 SHUT_DOWN, 174 }; 175 176 enum FlushCommand { 177 FLUSH_CMD_NONE, 178 FLUSH_CMD_FLUSH, 179 FLUSH_CMD_SHUTDOWN, 180 }; 181 182 // Status of flush responses from the decoder and renderer. 183 bool mFlushComplete[2][2]; 184 185 FlushStatus mFlushingAudio; 186 FlushStatus mFlushingVideo; 187 188 // Status of flush responses from the decoder and renderer. 189 bool mResumePending; 190 191 int32_t mVideoScalingMode; 192 193 AudioPlaybackRate mPlaybackSettings; 194 AVSyncSettings mSyncSettings; 195 float mVideoFpsHint; 196 bool mStarted; 197 bool mSourceStarted; 198 199 // Actual pause state, either as requested by client or due to buffering. 200 bool mPaused; 201 202 // Pause state as requested by client. Note that if mPausedByClient is 203 // true, mPaused is always true; if mPausedByClient is false, mPaused could 204 // still become true, when we pause internally due to buffering. 205 bool mPausedByClient; 206 207 // Pause state as requested by source (internally) due to buffering 208 bool mPausedForBuffering; 209 210 inline const sp<DecoderBase> &getDecoder(bool audio) { 211 return audio ? mAudioDecoder : mVideoDecoder; 212 } 213 214 inline void clearFlushComplete() { 215 mFlushComplete[0][0] = false; 216 mFlushComplete[0][1] = false; 217 mFlushComplete[1][0] = false; 218 mFlushComplete[1][1] = false; 219 } 220 221 void tryOpenAudioSinkForOffload(const sp<AMessage> &format, bool hasVideo); 222 void closeAudioSink(); 223 void determineAudioModeChange(); 224 225 status_t instantiateDecoder(bool audio, sp<DecoderBase> *decoder); 226 227 status_t onInstantiateSecureDecoders(); 228 229 void updateVideoSize( 230 const sp<AMessage> &inputFormat, 231 const sp<AMessage> &outputFormat = NULL); 232 233 void notifyListener(int msg, int ext1, int ext2, const Parcel *in = NULL); 234 235 void handleFlushComplete(bool audio, bool isDecoder); 236 void finishFlushIfPossible(); 237 238 void onStart(int64_t startPositionUs = -1); 239 void onResume(); 240 void onPause(); 241 242 bool audioDecoderStillNeeded(); 243 244 void flushDecoder(bool audio, bool needShutdown); 245 246 void finishResume(); 247 void notifyDriverSeekComplete(); 248 249 void postScanSources(); 250 251 void schedulePollDuration(); 252 void cancelPollDuration(); 253 254 void processDeferredActions(); 255 256 void performSeek(int64_t seekTimeUs); 257 void performDecoderFlush(FlushCommand audio, FlushCommand video); 258 void performReset(); 259 void performScanSources(); 260 void performSetSurface(const sp<Surface> &wrapper); 261 void performResumeDecoders(bool needNotify); 262 263 void onSourceNotify(const sp<AMessage> &msg); 264 void onClosedCaptionNotify(const sp<AMessage> &msg); 265 266 void queueDecoderShutdown( 267 bool audio, bool video, const sp<AMessage> &reply); 268 269 void sendSubtitleData(const sp<ABuffer> &buffer, int32_t baseIndex); 270 void sendTimedMetaData(const sp<ABuffer> &buffer); 271 void sendTimedTextData(const sp<ABuffer> &buffer); 272 273 void writeTrackInfo(Parcel* reply, const sp<AMessage> format) const; 274 275 DISALLOW_EVIL_CONSTRUCTORS(NuPlayer); 276}; 277 278} // namespace android 279 280#endif // NU_PLAYER_H_ 281