android_GenericPlayer.h revision 4ee246c55533bdab8ab5fa0f0581744fe58e7c91
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 6670c49ae2867094072a4365423417ea452bf82231Jean-Michel Trivi 674ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi void setVolume(bool mute, bool useStereoPos, XApermille stereoPos, XAmillibel volume); 6837dc2fccf3f122b79ebd554de209d0a3c94ae161Jean-Michel Trivi 6913837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Triviprotected: 7037dc2fccf3f122b79ebd554de209d0a3c94ae161Jean-Michel Trivi Mutex mSettingsLock; 7113837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi 7213837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi void resetDataLocator(); 7313837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi DataLocator2 mDataLocator; 7413837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi int mDataLocatorType; 7513837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi 764ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi // Constants used to identify the messages in this player's AHandler message loop 774ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi // in onMessageReceived() 7813837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi enum { 794ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi kWhatPrepare = 'prep', 804ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi kWhatNotif = 'noti', 814ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi kWhatPlay = 'play', 824ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi kWhatPause = 'paus', 834ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi kWhatSeek = 'seek', 844ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi kWhatSeekComplete = 'skcp', 854ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi kWhatLoop = 'loop', 864ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi kWhatVolumeUpdate = 'volu', 874ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi kWhatBufferingUpdate = 'bufu', 884ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi kWhatBuffUpdateThres = 'buut', 8913837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi }; 9013837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi 9113837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi // Send a notification to one of the event listeners 9237dc2fccf3f122b79ebd554de209d0a3c94ae161Jean-Michel Trivi virtual void notify(const char* event, int data1, bool async); 9337dc2fccf3f122b79ebd554de209d0a3c94ae161Jean-Michel Trivi virtual void notify(const char* event, int data1, int data2, bool async); 9413837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi 9513837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi // AHandler implementation 9613837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi virtual void onMessageReceived(const sp<AMessage> &msg); 9713837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi 9813837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi // Async event handlers (called from GenericPlayer's event loop) 9913837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi virtual void onPrepare(); 10013837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi virtual void onNotify(const sp<AMessage> &msg); 10113837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi virtual void onPlay(); 10213837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi virtual void onPause(); 10313837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi virtual void onSeek(const sp<AMessage> &msg); 10413837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi virtual void onLoop(const sp<AMessage> &msg); 10537dc2fccf3f122b79ebd554de209d0a3c94ae161Jean-Michel Trivi virtual void onVolumeUpdate(); 1064ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi virtual void onSeekComplete(); 1074ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi virtual void onBufferingUpdate(const sp<AMessage> &msg); 1084ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi virtual void onSetBufferingUpdateThreshold(const sp<AMessage> &msg); 1094ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi 1104ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi // Convenience methods 1114ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi // for async notifications of prefetch status and cache fill level, needs to be called 1124ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi // with mSettingsLock locked 1134ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi void notifyStatus(); 1144ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi void notifyCacheFill(); 1154ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi // for internal async notification to update state that the player is no longer seeking 1164ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi void seekComplete(); 1174ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi void bufferingUpdate(int16_t fillLevelPerMille); 11813837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi 11913837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi // Event notification from GenericPlayer to OpenSL ES / OpenMAX AL framework 12013837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi notif_cbf_t mNotifyClient; 12113837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi void* mNotifyUser; 12213837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi 12313837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi enum { 12413837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi kFlagPrepared = 1 <<0, 12513837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi kFlagPreparing = 1 <<1, 12613837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi kFlagPlaying = 1 <<2, 12713837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi kFlagBuffering = 1 <<3, 12813837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi kFlagSeeking = 1 <<4, 12913837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi kFlagLooping = 1 <<5, 13013837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi }; 13113837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi 13213837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi uint32_t mStateFlags; 13313837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi 13413837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi sp<ALooper> mLooper; 13513837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi int32_t mLooperPriority; 13613837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi 13713837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi AudioPlayback_Parameters mPlaybackParams; 13813837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi 13937dc2fccf3f122b79ebd554de209d0a3c94ae161Jean-Michel Trivi AndroidAudioLevels mAndroidAudioLevels; 14037dc2fccf3f122b79ebd554de209d0a3c94ae161Jean-Michel Trivi int mChannelCount; // this is used for the panning law, and is not exposed outside of the object 1414ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi int32_t mDurationMsec; 1424ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi int32_t mPositionMsec; 1434ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi 1444ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi CacheStatus_t mCacheStatus; 1454ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi int16_t mCacheFill; // cache fill level + played back level in permille 1464ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi int16_t mLastNotifiedCacheFill; // last cache fill level communicated to the listener 1474ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi int16_t mCacheFillNotifThreshold; // threshold in cache fill level for cache fill to be reported 1484ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi 14937dc2fccf3f122b79ebd554de209d0a3c94ae161Jean-Michel Trivi 15013837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Triviprivate: 15113837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi DISALLOW_EVIL_CONSTRUCTORS(GenericPlayer); 15213837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi}; 15313837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi 15413837cf3f7be0eb8b1a9552bd99a89f98c987720Jean-Michel Trivi} // namespace android 1554ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi 1564ee246c55533bdab8ab5fa0f0581744fe58e7c91Jean-Michel Trivi#endif /* __ANDROID_GENERICPLAYER_H__ */ 157