19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/* 29066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Copyright (C) 2007 The Android Open Source Project 39066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 49066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 59066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * you may not use this file except in compliance with the License. 69066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * You may obtain a copy of the License at 79066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 89066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 99066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See the License for the specific language governing permissions and 149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * limitations under the License. 159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project#ifndef ANDROID_MEDIAPLAYER_H 189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project#define ANDROID_MEDIAPLAYER_H 199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 200795272aa226f4e965968a03daddc53ce30b7cdaMathias Agopian#include <binder/IMemory.h> 219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project#include <media/IMediaPlayerClient.h> 229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project#include <media/IMediaPlayer.h> 2334bbc22cbca0004475788f06be2300fef23c6a52James Dong#include <media/IMediaDeathNotifier.h> 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 25256430093679e1d62b54fb0c852126e54d162f6fAndreas Huber#include <utils/KeyedVector.h> 26256430093679e1d62b54fb0c852126e54d162f6fAndreas Huber#include <utils/String8.h> 27256430093679e1d62b54fb0c852126e54d162f6fAndreas Huber 289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectnamespace android { 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 30000479f9e325b4e426a67033abd92d47da412725Mathias Agopianclass Surface; 31000479f9e325b4e426a67033abd92d47da412725Mathias Agopian 329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectenum media_event_type { 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project MEDIA_NOP = 0, // interface test message 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project MEDIA_PREPARED = 1, 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project MEDIA_PLAYBACK_COMPLETE = 2, 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project MEDIA_BUFFERING_UPDATE = 3, 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project MEDIA_SEEK_COMPLETE = 4, 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project MEDIA_SET_VIDEO_SIZE = 5, 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project MEDIA_ERROR = 100, 40c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project MEDIA_INFO = 200, 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project}; 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 43c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project// Generic error codes for the media player framework. Errors are fatal, the 44c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project// playback must abort. 45c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project// 46c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project// Errors are communicated back to the client using the 47c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project// MediaPlayerListener::notify method defined below. 48c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project// In this situation, 'notify' is invoked with the following: 49c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project// 'msg' is set to MEDIA_ERROR. 50c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project// 'ext1' should be a value from the enum media_error_type. 51c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project// 'ext2' contains an implementation dependant error code to provide 52c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project// more details. Should default to 0 when not used. 53c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project// 54c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project// The codes are distributed as follow: 55c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project// 0xx: Reserved 56c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project// 1xx: Android Player errors. Something went wrong inside the MediaPlayer. 57c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project// 2xx: Media errors (e.g Codec not supported). There is a problem with the 58c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project// media itself. 59c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project// 3xx: Runtime errors. Some extraordinary condition arose making the playback 60c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project// impossible. 61c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project// 62c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Projectenum media_error_type { 63c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project // 0xx 64c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project MEDIA_ERROR_UNKNOWN = 1, 65c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project // 1xx 66c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project MEDIA_ERROR_SERVER_DIED = 100, 67c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project // 2xx 68c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project MEDIA_ERROR_NOT_VALID_FOR_PROGRESSIVE_PLAYBACK = 200, 69c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project // 3xx 70c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project}; 71c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project 72c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project 73c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project// Info and warning codes for the media player framework. These are non fatal, 74c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project// the playback is going on but there might be some user visible issues. 75c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project// 76c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project// Info and warning messages are communicated back to the client using the 77c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project// MediaPlayerListener::notify method defined below. In this situation, 78c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project// 'notify' is invoked with the following: 79c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project// 'msg' is set to MEDIA_INFO. 80c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project// 'ext1' should be a value from the enum media_info_type. 8162e73f466e52b98ecc2eef85010618a655b40924Ravi K Yenduri// 'ext2' contains an implementation dependant info code to provide 82c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project// more details. Should default to 0 when not used. 83c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project// 84c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project// The codes are distributed as follow: 85c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project// 0xx: Reserved 86c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project// 7xx: Android Player info/warning (e.g player lagging behind.) 87c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project// 8xx: Media info/warning (e.g media badly interleaved.) 8832f82774884bdd709789ab9f3ccdf5b972ff7681Nicolas Catania// 89c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Projectenum media_info_type { 90c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project // 0xx 91c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project MEDIA_INFO_UNKNOWN = 1, 92c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project // 7xx 93c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project // The video is too complex for the decoder: it can't decode frames fast 94c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project // enough. Possibly only the audio plays fine at this stage. 95c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project MEDIA_INFO_VIDEO_TRACK_LAGGING = 700, 96c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project // 8xx 97c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project // Bad interleaving means that a media has been improperly interleaved or not 98c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project // interleaved at all, e.g has all the video samples first then all the audio 99c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project // ones. Video is playing but a lot of disk seek may be happening. 100c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project MEDIA_INFO_BAD_INTERLEAVING = 800, 101c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project // The media is not seekable (e.g live stream). 102c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project MEDIA_INFO_NOT_SEEKABLE = 801, 103b2c693919be966f179080a9ec70a7a82dbf57627Nicolas Catania // New media metadata is available. 104b2c693919be966f179080a9ec70a7a82dbf57627Nicolas Catania MEDIA_INFO_METADATA_UPDATE = 802, 105c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project}; 106c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project 107c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project 1089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectenum media_player_states { 1109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project MEDIA_PLAYER_STATE_ERROR = 0, 1119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project MEDIA_PLAYER_IDLE = 1 << 0, 1129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project MEDIA_PLAYER_INITIALIZED = 1 << 1, 1139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project MEDIA_PLAYER_PREPARING = 1 << 2, 1149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project MEDIA_PLAYER_PREPARED = 1 << 3, 1159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project MEDIA_PLAYER_STARTED = 1 << 4, 1169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project MEDIA_PLAYER_PAUSED = 1 << 5, 1179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project MEDIA_PLAYER_STOPPED = 1 << 6, 1189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project MEDIA_PLAYER_PLAYBACK_COMPLETE = 1 << 7 1199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project}; 1209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project// ---------------------------------------------------------------------------- 1229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project// ref-counted object for callbacks 1239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectclass MediaPlayerListener: virtual public RefBase 1249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project{ 1259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic: 1269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project virtual void notify(int msg, int ext1, int ext2) = 0; 1279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project}; 1289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12934bbc22cbca0004475788f06be2300fef23c6a52James Dongclass MediaPlayer : public BnMediaPlayerClient, 13034bbc22cbca0004475788f06be2300fef23c6a52James Dong public virtual IMediaDeathNotifier 1319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project{ 1329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic: 1339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project MediaPlayer(); 1349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ~MediaPlayer(); 13534bbc22cbca0004475788f06be2300fef23c6a52James Dong void died(); 1369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void disconnect(); 137256430093679e1d62b54fb0c852126e54d162f6fAndreas Huber 138256430093679e1d62b54fb0c852126e54d162f6fAndreas Huber status_t setDataSource( 139256430093679e1d62b54fb0c852126e54d162f6fAndreas Huber const char *url, 140256430093679e1d62b54fb0c852126e54d162f6fAndreas Huber const KeyedVector<String8, String8> *headers); 141256430093679e1d62b54fb0c852126e54d162f6fAndreas Huber 1429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project status_t setDataSource(int fd, int64_t offset, int64_t length); 1439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project status_t setVideoSurface(const sp<Surface>& surface); 1449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project status_t setListener(const sp<MediaPlayerListener>& listener); 1459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project status_t prepare(); 1469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project status_t prepareAsync(); 1479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project status_t start(); 1489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project status_t stop(); 1499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project status_t pause(); 1509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project bool isPlaying(); 1519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project status_t getVideoWidth(int *w); 1529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project status_t getVideoHeight(int *h); 1539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project status_t seekTo(int msec); 1549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project status_t getCurrentPosition(int *msec); 1559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project status_t getDuration(int *msec); 1569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project status_t reset(); 1579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project status_t setAudioStreamType(int type); 1589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project status_t setLooping(int loop); 1599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project bool isLooping(); 1609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project status_t setVolume(float leftVolume, float rightVolume); 1619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void notify(int msg, int ext1, int ext2); 1629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static sp<IMemory> decode(const char* url, uint32_t *pSampleRate, int* pNumChannels, int* pFormat); 1639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static sp<IMemory> decode(int fd, int64_t offset, int64_t length, uint32_t *pSampleRate, int* pNumChannels, int* pFormat); 164c39d2e3c012fb96999991e30659a474f9f30f789Marco Nelissen static int snoop(short *data, int len, int kind); 16520cb94eeb5b9672573fc86bf51e09bd66a774581Nicolas Catania status_t invoke(const Parcel& request, Parcel *reply); 166b2c693919be966f179080a9ec70a7a82dbf57627Nicolas Catania status_t setMetadataFilter(const Parcel& filter); 1675d55c7119820ee9bb06fc072e416fe98ba77cd28Nicolas Catania status_t getMetadata(bool update_only, bool apply_filter, Parcel *metadata); 168fbb3885024ac9c90f322b6259d7e519c8927e6ffAndreas Huber status_t suspend(); 169fbb3885024ac9c90f322b6259d7e519c8927e6ffAndreas Huber status_t resume(); 1709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectprivate: 1719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void clear_l(); 1729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project status_t seekTo_l(int msec); 1739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project status_t prepareAsync_l(); 1749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project status_t getDuration_l(int *msec); 1759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project status_t setDataSource(const sp<IMediaPlayer>& player); 1769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sp<IMediaPlayer> mPlayer; 178ebb020aebc157ff127458dc20e1d0066b86bb99dJason Sams thread_id_t mLockThreadId; 1799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Mutex mLock; 1809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Mutex mNotifyLock; 1819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Condition mSignal; 1829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sp<MediaPlayerListener> mListener; 1839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void* mCookie; 1849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project media_player_states mCurrentState; 1859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int mDuration; 1869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int mCurrentPosition; 1879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int mSeekPosition; 1889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project bool mPrepareSync; 1899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project status_t mPrepareStatus; 1909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int mStreamType; 1919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project bool mLoop; 1929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float mLeftVolume; 1939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float mRightVolume; 1949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int mVideoWidth; 1959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int mVideoHeight; 1969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project}; 1979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project}; // namespace android 1999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project#endif // ANDROID_MEDIAPLAYER_H 201