android_GenericPlayer.h revision 49935c51fddcd0caa0030e2aac0c3a7ba3339e3d
113837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi/* 213837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi * Copyright (C) 2011 The Android Open Source Project 313837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi * 413837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi * Licensed under the Apache License, Version 2.0 (the "License"); 513837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi * you may not use this file except in compliance with the License. 613837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi * You may obtain a copy of the License at 713837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi * 813837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi * http://www.apache.org/licenses/LICENSE-2.0 913837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi * 1013837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi * Unless required by applicable law or agreed to in writing, software 1113837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi * distributed under the License is distributed on an "AS IS" BASIS, 1213837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 1313837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi * See the License for the specific language governing permissions and 1413837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi * limitations under the License. 1513837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi */ 1613837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi 174ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi#ifndef __ANDROID_GENERICPLAYER_H__ 184ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi#define __ANDROID_GENERICPLAYER_H__ 194ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi 204ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi#include <media/stagefright/foundation/AHandler.h> 214ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi#include <media/stagefright/foundation/ALooper.h> 224ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi#include <media/stagefright/foundation/AMessage.h> 2313837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi 2413837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi//-------------------------------------------------------------------------------------------------- 254ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi/** 264ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi * Message parameters for AHandler messages, see list in GenericPlayer::kWhatxxx 274ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi */ 284ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi#define WHATPARAM_SEEK_SEEKTIME_MS "seekTimeMs" 294ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi#define WHATPARAM_LOOP_LOOPING "looping" 304ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi#define WHATPARAM_BUFFERING_UPDATE "bufferingUpdate" 314ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi#define WHATPARAM_BUFFERING_UPDATETHRESHOLD_PERCENT "buffUpdateThreshold" 324ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi 3313837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivinamespace android { 3413837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi 3513837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Triviclass GenericPlayer : public AHandler 3613837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi{ 3713837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivipublic: 3813837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi 3913837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi enum { 404ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi kEventPrepared = 'prep', 414ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi kEventHasVideoSize = 'vsiz', 424ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi kEventPrefetchStatusChange = 'pfsc', 434ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi kEventPrefetchFillLevelUpdate = 'pflu', 444ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi kEventEndOfStream = 'eos' 4513837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi }; 4613837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi 474ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi 4813837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi GenericPlayer(const AudioPlayback_Parameters* params); 4913837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi virtual ~GenericPlayer(); 5013837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi 5113837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi virtual void init(const notif_cbf_t cbf, void* notifUser); 52e6ded5c61944a87fa9e472dec3a6929855d42aebJean-Michel Trivi virtual void preDestroy(); 5313837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi 5413837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi virtual void setDataSource(const char *uri); 5513837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi virtual void setDataSource(int fd, int64_t offset, int64_t length); 5613837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi 5713837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi virtual void prepare(); 5813837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi virtual void play(); 5913837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi virtual void pause(); 6013837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi virtual void stop(); 6113837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi virtual void seek(int64_t timeMsec); 6213837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi virtual void loop(bool loop); 634ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi virtual void setBufferingUpdateThreshold(int16_t thresholdPercent); 6413837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi 654b0e0b2860ffd5e246b42c8a434833cca2f068b3Jean-Michel Trivi virtual void getDurationMsec(int* msec); //msec != NULL, ANDROID_UNKNOWN_TIME if unknown 664b0e0b2860ffd5e246b42c8a434833cca2f068b3Jean-Michel Trivi virtual void getPositionMsec(int* msec); //msec != NULL, ANDROID_UNKNOWN_TIME if unknown 674b0e0b2860ffd5e246b42c8a434833cca2f068b3Jean-Michel Trivi virtual void getSampleRate(uint32_t* hz);// hz != NULL, UNKNOWN_SAMPLERATE if unknown 6870c49ae2867094072a4365423417ea452bf82231Jean-Michel Trivi 694ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi void setVolume(bool mute, bool useStereoPos, XApermille stereoPos, XAmillibel volume); 7037dc2fccf3f122b79ebd554de209d0a3c94ae161Jean-Michel Trivi 7113837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Triviprotected: 724b0e0b2860ffd5e246b42c8a434833cca2f068b3Jean-Michel Trivi // mutex used for set vs use of volume and cache (fill, threshold) settings 7337dc2fccf3f122b79ebd554de209d0a3c94ae161Jean-Michel Trivi Mutex mSettingsLock; 7413837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi 7513837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi void resetDataLocator(); 7613837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi DataLocator2 mDataLocator; 7713837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi int mDataLocatorType; 7813837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi 794ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi // Constants used to identify the messages in this player's AHandler message loop 804ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi // in onMessageReceived() 8113837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi enum { 824ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi kWhatPrepare = 'prep', 834ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi kWhatNotif = 'noti', 844ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi kWhatPlay = 'play', 854ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi kWhatPause = 'paus', 864ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi kWhatSeek = 'seek', 874ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi kWhatSeekComplete = 'skcp', 884ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi kWhatLoop = 'loop', 894ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi kWhatVolumeUpdate = 'volu', 904ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi kWhatBufferingUpdate = 'bufu', 914ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi kWhatBuffUpdateThres = 'buut', 924b0e0b2860ffd5e246b42c8a434833cca2f068b3Jean-Michel Trivi kWhatMediaPlayerInfo = 'mpin' 9313837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi }; 9413837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi 9513837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi // Send a notification to one of the event listeners 9637dc2fccf3f122b79ebd554de209d0a3c94ae161Jean-Michel Trivi virtual void notify(const char* event, int data1, bool async); 9737dc2fccf3f122b79ebd554de209d0a3c94ae161Jean-Michel Trivi virtual void notify(const char* event, int data1, int data2, bool async); 9813837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi 9913837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi // AHandler implementation 10013837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi virtual void onMessageReceived(const sp<AMessage> &msg); 10113837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi 10213837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi // Async event handlers (called from GenericPlayer's event loop) 10313837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi virtual void onPrepare(); 10413837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi virtual void onNotify(const sp<AMessage> &msg); 10513837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi virtual void onPlay(); 10613837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi virtual void onPause(); 10713837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi virtual void onSeek(const sp<AMessage> &msg); 10813837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi virtual void onLoop(const sp<AMessage> &msg); 10937dc2fccf3f122b79ebd554de209d0a3c94ae161Jean-Michel Trivi virtual void onVolumeUpdate(); 1104ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi virtual void onSeekComplete(); 1114ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi virtual void onBufferingUpdate(const sp<AMessage> &msg); 1124ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi virtual void onSetBufferingUpdateThreshold(const sp<AMessage> &msg); 1134ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi 1144ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi // Convenience methods 1154ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi // for async notifications of prefetch status and cache fill level, needs to be called 1164ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi // with mSettingsLock locked 1174ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi void notifyStatus(); 1184ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi void notifyCacheFill(); 1194ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi // for internal async notification to update state that the player is no longer seeking 1204ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi void seekComplete(); 1214ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi void bufferingUpdate(int16_t fillLevelPerMille); 12213837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi 12313837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi // Event notification from GenericPlayer to OpenSL ES / OpenMAX AL framework 12413837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi notif_cbf_t mNotifyClient; 12513837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi void* mNotifyUser; 126e6ded5c61944a87fa9e472dec3a6929855d42aebJean-Michel Trivi // lock to protect mNotifyClient and mNotifyUser updates 127e6ded5c61944a87fa9e472dec3a6929855d42aebJean-Michel Trivi Mutex mNotifyClientLock; 12813837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi 12949935c51fddcd0caa0030e2aac0c3a7ba3339e3dGlenn Kasten // Bits for mStateFlags 13013837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi enum { 13149935c51fddcd0caa0030e2aac0c3a7ba3339e3dGlenn Kasten kFlagPrepared = 1 << 0, // use only for successful preparation 13249935c51fddcd0caa0030e2aac0c3a7ba3339e3dGlenn Kasten kFlagPreparing = 1 << 1, 13349935c51fddcd0caa0030e2aac0c3a7ba3339e3dGlenn Kasten kFlagPlaying = 1 << 2, 13449935c51fddcd0caa0030e2aac0c3a7ba3339e3dGlenn Kasten kFlagBuffering = 1 << 3, 13549935c51fddcd0caa0030e2aac0c3a7ba3339e3dGlenn Kasten kFlagSeeking = 1 << 4, 13649935c51fddcd0caa0030e2aac0c3a7ba3339e3dGlenn Kasten kFlagLooping = 1 << 5, 13749935c51fddcd0caa0030e2aac0c3a7ba3339e3dGlenn Kasten kFlagPreparedUnsuccessfully = 1 << 6, 13813837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi }; 13913837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi 14013837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi uint32_t mStateFlags; 14113837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi 14213837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi sp<ALooper> mLooper; 14313837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi int32_t mLooperPriority; 14413837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi 14513837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi AudioPlayback_Parameters mPlaybackParams; 14613837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi 14737dc2fccf3f122b79ebd554de209d0a3c94ae161Jean-Michel Trivi AndroidAudioLevels mAndroidAudioLevels; 14837dc2fccf3f122b79ebd554de209d0a3c94ae161Jean-Michel Trivi int mChannelCount; // this is used for the panning law, and is not exposed outside of the object 1494ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi int32_t mDurationMsec; 1504b0e0b2860ffd5e246b42c8a434833cca2f068b3Jean-Michel Trivi // position is not protected by any lock in this generic class, may be different in subclasses 1514ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi int32_t mPositionMsec; 1527f5cc1afe49395fefaad9b2bbd728a45d1bfda6aJean-Michel Trivi uint32_t mSampleRateHz; 1534ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi 1544ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi CacheStatus_t mCacheStatus; 1554ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi int16_t mCacheFill; // cache fill level + played back level in permille 1564ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi int16_t mLastNotifiedCacheFill; // last cache fill level communicated to the listener 1574ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi int16_t mCacheFillNotifThreshold; // threshold in cache fill level for cache fill to be reported 1584ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi 15913837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Triviprivate: 16013837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi DISALLOW_EVIL_CONSTRUCTORS(GenericPlayer); 16113837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi}; 16213837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi 16313837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi} // namespace android 1644ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi 1654ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi#endif /* __ANDROID_GENERICPLAYER_H__ */ 166