android_GenericPlayer.h revision 7f5cc1afe49395fefaad9b2bbd728a45d1bfda6a
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); 5213837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi 5313837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi virtual void setDataSource(const char *uri); 5413837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi virtual void setDataSource(int fd, int64_t offset, int64_t length); 5513837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi 5613837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi virtual void prepare(); 5713837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi virtual void play(); 5813837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi virtual void pause(); 5913837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi virtual void stop(); 6013837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi virtual void seek(int64_t timeMsec); 6113837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi virtual void loop(bool loop); 624ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi virtual void setBufferingUpdateThreshold(int16_t thresholdPercent); 6313837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi 644ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi virtual void getDurationMsec(int* msec); // ANDROID_UNKNOWN_TIME if unknown 654ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi virtual void getPositionMsec(int* msec); // ANDROID_UNKNOWN_TIME if unknown 667f5cc1afe49395fefaad9b2bbd728a45d1bfda6aJean-Michel Trivi virtual void getSampleRate(uint32_t* hz);// ANDROID_UNKNOWN_SAMPLERATE if unknown 6770c49ae2867094072a4365423417ea452bf82231Jean-Michel Trivi 684ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi void setVolume(bool mute, bool useStereoPos, XApermille stereoPos, XAmillibel volume); 6937dc2fccf3f122b79ebd554de209d0a3c94ae161Jean-Michel Trivi 7013837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Triviprotected: 7137dc2fccf3f122b79ebd554de209d0a3c94ae161Jean-Michel Trivi Mutex mSettingsLock; 7213837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi 7313837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi void resetDataLocator(); 7413837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi DataLocator2 mDataLocator; 7513837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi int mDataLocatorType; 7613837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi 774ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi // Constants used to identify the messages in this player's AHandler message loop 784ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi // in onMessageReceived() 7913837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi enum { 804ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi kWhatPrepare = 'prep', 814ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi kWhatNotif = 'noti', 824ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi kWhatPlay = 'play', 834ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi kWhatPause = 'paus', 844ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi kWhatSeek = 'seek', 854ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi kWhatSeekComplete = 'skcp', 864ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi kWhatLoop = 'loop', 874ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi kWhatVolumeUpdate = 'volu', 884ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi kWhatBufferingUpdate = 'bufu', 894ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi kWhatBuffUpdateThres = 'buut', 9013837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi }; 9113837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi 9213837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi // Send a notification to one of the event listeners 9337dc2fccf3f122b79ebd554de209d0a3c94ae161Jean-Michel Trivi virtual void notify(const char* event, int data1, bool async); 9437dc2fccf3f122b79ebd554de209d0a3c94ae161Jean-Michel Trivi virtual void notify(const char* event, int data1, int data2, bool async); 9513837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi 9613837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi // AHandler implementation 9713837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi virtual void onMessageReceived(const sp<AMessage> &msg); 9813837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi 9913837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi // Async event handlers (called from GenericPlayer's event loop) 10013837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi virtual void onPrepare(); 10113837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi virtual void onNotify(const sp<AMessage> &msg); 10213837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi virtual void onPlay(); 10313837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi virtual void onPause(); 10413837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi virtual void onSeek(const sp<AMessage> &msg); 10513837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi virtual void onLoop(const sp<AMessage> &msg); 10637dc2fccf3f122b79ebd554de209d0a3c94ae161Jean-Michel Trivi virtual void onVolumeUpdate(); 1074ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi virtual void onSeekComplete(); 1084ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi virtual void onBufferingUpdate(const sp<AMessage> &msg); 1094ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi virtual void onSetBufferingUpdateThreshold(const sp<AMessage> &msg); 1104ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi 1114ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi // Convenience methods 1124ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi // for async notifications of prefetch status and cache fill level, needs to be called 1134ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi // with mSettingsLock locked 1144ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi void notifyStatus(); 1154ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi void notifyCacheFill(); 1164ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi // for internal async notification to update state that the player is no longer seeking 1174ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi void seekComplete(); 1184ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi void bufferingUpdate(int16_t fillLevelPerMille); 11913837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi 12013837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi // Event notification from GenericPlayer to OpenSL ES / OpenMAX AL framework 12113837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi notif_cbf_t mNotifyClient; 12213837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi void* mNotifyUser; 12313837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi 12413837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi enum { 12513837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi kFlagPrepared = 1 <<0, 12613837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi kFlagPreparing = 1 <<1, 12713837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi kFlagPlaying = 1 <<2, 12813837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi kFlagBuffering = 1 <<3, 12913837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi kFlagSeeking = 1 <<4, 13013837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi kFlagLooping = 1 <<5, 13113837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi }; 13213837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi 13313837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi uint32_t mStateFlags; 13413837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi 13513837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi sp<ALooper> mLooper; 13613837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi int32_t mLooperPriority; 13713837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi 13813837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi AudioPlayback_Parameters mPlaybackParams; 13913837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi 14037dc2fccf3f122b79ebd554de209d0a3c94ae161Jean-Michel Trivi AndroidAudioLevels mAndroidAudioLevels; 14137dc2fccf3f122b79ebd554de209d0a3c94ae161Jean-Michel Trivi int mChannelCount; // this is used for the panning law, and is not exposed outside of the object 1424ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi int32_t mDurationMsec; 1434ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi int32_t mPositionMsec; 1447f5cc1afe49395fefaad9b2bbd728a45d1bfda6aJean-Michel Trivi uint32_t mSampleRateHz; 1454ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi 1464ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi CacheStatus_t mCacheStatus; 1474ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi int16_t mCacheFill; // cache fill level + played back level in permille 1484ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi int16_t mLastNotifiedCacheFill; // last cache fill level communicated to the listener 1494ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi int16_t mCacheFillNotifThreshold; // threshold in cache fill level for cache fill to be reported 1504ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi 15137dc2fccf3f122b79ebd554de209d0a3c94ae161Jean-Michel Trivi 15213837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Triviprivate: 15313837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi DISALLOW_EVIL_CONSTRUCTORS(GenericPlayer); 15413837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi}; 15513837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi 15613837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi} // namespace android 1574ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi 1584ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi#endif /* __ANDROID_GENERICPLAYER_H__ */ 159