mediaplayer.h revision 640adb3cf89cc9b826372009fad8c9b3d120482e
1f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)/* 2f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) * Copyright (C) 2007 The Android Open Source Project 3f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) * 4f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) * Licensed under the Apache License, Version 2.0 (the "License"); 5f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) * you may not use this file except in compliance with the License. 6f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) * You may obtain a copy of the License at 7f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) * 8f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) * http://www.apache.org/licenses/LICENSE-2.0 9f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) * 10f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) * Unless required by applicable law or agreed to in writing, software 11f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) * distributed under the License is distributed on an "AS IS" BASIS, 12f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) * See the License for the specific language governing permissions and 14f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) * limitations under the License. 15f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) */ 16f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) 17f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)#ifndef ANDROID_MEDIAPLAYER_H 18f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)#define ANDROID_MEDIAPLAYER_H 19f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) 20f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)#include <arpa/inet.h> 21f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) 22f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)#include <binder/IMemory.h> 23f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)#include <media/IMediaPlayerClient.h> 24f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)#include <media/IMediaPlayer.h> 25f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)#include <media/IMediaDeathNotifier.h> 26f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)#include <media/IStreamSource.h> 27f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) 28f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)#include <utils/KeyedVector.h> 29f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)#include <utils/String8.h> 30f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) 31f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)class ANativeWindow; 32f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) 33f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)namespace android { 34f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) 35f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)class Surface; 36f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)class IGraphicBufferProducer; 37f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) 38f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)enum media_event_type { 39f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) MEDIA_NOP = 0, // interface test message 40f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) MEDIA_PREPARED = 1, 41f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) MEDIA_PLAYBACK_COMPLETE = 2, 42f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) MEDIA_BUFFERING_UPDATE = 3, 43f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) MEDIA_SEEK_COMPLETE = 4, 44f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) MEDIA_SET_VIDEO_SIZE = 5, 45f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) MEDIA_STARTED = 6, 46f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) MEDIA_PAUSED = 7, 47f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) MEDIA_STOPPED = 8, 48f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) MEDIA_SKIPPED = 9, 49f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) MEDIA_TIMED_TEXT = 99, 50f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) MEDIA_ERROR = 100, 51f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) MEDIA_INFO = 200, 52f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) MEDIA_SUBTITLE_DATA = 201, 53f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)}; 54f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) 55f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)// Generic error codes for the media player framework. Errors are fatal, the 56f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)// playback must abort. 57f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)// 58f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)// Errors are communicated back to the client using the 59f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)// MediaPlayerListener::notify method defined below. 60f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)// In this situation, 'notify' is invoked with the following: 61f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)// 'msg' is set to MEDIA_ERROR. 62f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)// 'ext1' should be a value from the enum media_error_type. 63f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)// 'ext2' contains an implementation dependant error code to provide 64f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)// more details. Should default to 0 when not used. 65f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)// 66f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)// The codes are distributed as follow: 67f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)// 0xx: Reserved 68f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)// 1xx: Android Player errors. Something went wrong inside the MediaPlayer. 69f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)// 2xx: Media errors (e.g Codec not supported). There is a problem with the 70f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)// media itself. 71f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)// 3xx: Runtime errors. Some extraordinary condition arose making the playback 72f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)// impossible. 73f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)// 74f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)enum media_error_type { 75f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) // 0xx 76f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) MEDIA_ERROR_UNKNOWN = 1, 77f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) // 1xx 78f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) MEDIA_ERROR_SERVER_DIED = 100, 79f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) // 2xx 80f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) MEDIA_ERROR_NOT_VALID_FOR_PROGRESSIVE_PLAYBACK = 200, 81f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) // 3xx 82f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)}; 83f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) 84f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) 85f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)// Info and warning codes for the media player framework. These are non fatal, 86f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)// the playback is going on but there might be some user visible issues. 87f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)// 88f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)// Info and warning messages are communicated back to the client using the 89f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)// MediaPlayerListener::notify method defined below. In this situation, 90f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)// 'notify' is invoked with the following: 91f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)// 'msg' is set to MEDIA_INFO. 92f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)// 'ext1' should be a value from the enum media_info_type. 93f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)// 'ext2' contains an implementation dependant info code to provide 94f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)// more details. Should default to 0 when not used. 95f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)// 96f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)// The codes are distributed as follow: 97f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)// 0xx: Reserved 98f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)// 7xx: Android Player info/warning (e.g player lagging behind.) 99f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)// 8xx: Media info/warning (e.g media badly interleaved.) 100f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)// 101f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)enum media_info_type { 102f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) // 0xx 103f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) MEDIA_INFO_UNKNOWN = 1, 104f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) // The player was started because it was used as the next player for another 105f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) // player, which just completed playback 106f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) MEDIA_INFO_STARTED_AS_NEXT = 2, 107f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) // The player just pushed the very first video frame for rendering 108f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) MEDIA_INFO_RENDERING_START = 3, 109f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) // 7xx 110f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) // The video is too complex for the decoder: it can't decode frames fast 111f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) // enough. Possibly only the audio plays fine at this stage. 112f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) MEDIA_INFO_VIDEO_TRACK_LAGGING = 700, 113f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) // MediaPlayer is temporarily pausing playback internally in order to 114f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) // buffer more data. 115f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) MEDIA_INFO_BUFFERING_START = 701, 116f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) // MediaPlayer is resuming playback after filling buffers. 117f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) MEDIA_INFO_BUFFERING_END = 702, 118f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) // Bandwidth in recent past 119f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) MEDIA_INFO_NETWORK_BANDWIDTH = 703, 120f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) 121f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) // 8xx 122f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) // Bad interleaving means that a media has been improperly interleaved or not 123f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) // interleaved at all, e.g has all the video samples first then all the audio 124f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) // ones. Video is playing but a lot of disk seek may be happening. 125f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) MEDIA_INFO_BAD_INTERLEAVING = 800, 126f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) // The media is not seekable (e.g live stream). 127f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) MEDIA_INFO_NOT_SEEKABLE = 801, 128f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) // New media metadata is available. 129f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) MEDIA_INFO_METADATA_UPDATE = 802, 130f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) 131f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) //9xx 132f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) MEDIA_INFO_TIMED_TEXT_ERROR = 900, 133f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)}; 134f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) 135f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) 136f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) 137f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)enum media_player_states { 138f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) MEDIA_PLAYER_STATE_ERROR = 0, 139f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) MEDIA_PLAYER_IDLE = 1 << 0, 140f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) MEDIA_PLAYER_INITIALIZED = 1 << 1, 141f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) MEDIA_PLAYER_PREPARING = 1 << 2, 142f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) MEDIA_PLAYER_PREPARED = 1 << 3, 143f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) MEDIA_PLAYER_STARTED = 1 << 4, 144f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) MEDIA_PLAYER_PAUSED = 1 << 5, 145f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) MEDIA_PLAYER_STOPPED = 1 << 6, 146f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) MEDIA_PLAYER_PLAYBACK_COMPLETE = 1 << 7 147f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)}; 148f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) 149f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)// Keep KEY_PARAMETER_* in sync with MediaPlayer.java. 150f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)// The same enum space is used for both set and get, in case there are future keys that 151f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)// can be both set and get. But as of now, all parameters are either set only or get only. 152f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)enum media_parameter_keys { 153f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) // Streaming/buffering parameters 154f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) KEY_PARAMETER_CACHE_STAT_COLLECT_FREQ_MS = 1100, // set only 155f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) 156f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) // Return a Parcel containing a single int, which is the channel count of the 157f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) // audio track, or zero for error (e.g. no audio track) or unknown. 158f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) KEY_PARAMETER_AUDIO_CHANNEL_COUNT = 1200, // get only 159f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) 160f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) // Playback rate expressed in permille (1000 is normal speed), saved as int32_t, with negative 161f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) // values used for rewinding or reverse playback. 162f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) KEY_PARAMETER_PLAYBACK_RATE_PERMILLE = 1300, // set only 163f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) 164f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) // Set a Parcel containing the value of a parcelled Java AudioAttribute instance 165f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) KEY_PARAMETER_AUDIO_ATTRIBUTES = 1400 // set only 166f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)}; 167f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) 168f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)// Keep INVOKE_ID_* in sync with MediaPlayer.java. 169f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)enum media_player_invoke_ids { 170f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) INVOKE_ID_GET_TRACK_INFO = 1, 171f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) INVOKE_ID_ADD_EXTERNAL_SOURCE = 2, 172f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) INVOKE_ID_ADD_EXTERNAL_SOURCE_FD = 3, 173f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) INVOKE_ID_SELECT_TRACK = 4, 174f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) INVOKE_ID_UNSELECT_TRACK = 5, 175f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) INVOKE_ID_SET_VIDEO_SCALING_MODE = 6, 176f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) INVOKE_ID_GET_SELECTED_TRACK = 7 177f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)}; 178f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) 179f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)// Keep MEDIA_TRACK_TYPE_* in sync with MediaPlayer.java. 180f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)enum media_track_type { 181f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) MEDIA_TRACK_TYPE_UNKNOWN = 0, 182f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) MEDIA_TRACK_TYPE_VIDEO = 1, 183f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) MEDIA_TRACK_TYPE_AUDIO = 2, 184f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) MEDIA_TRACK_TYPE_TIMEDTEXT = 3, 185f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) MEDIA_TRACK_TYPE_SUBTITLE = 4, 186f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)}; 187f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) 188f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)// ---------------------------------------------------------------------------- 189f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)// ref-counted object for callbacks 190f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)class MediaPlayerListener: virtual public RefBase 191f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles){ 192f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)public: 193f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) virtual void notify(int msg, int ext1, int ext2, const Parcel *obj) = 0; 194f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)}; 195f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) 196f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)struct IMediaHTTPService; 197f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) 198f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)class MediaPlayer : public BnMediaPlayerClient, 199f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) public virtual IMediaDeathNotifier 200f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles){ 201f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)public: 202f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) MediaPlayer(); 203f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) ~MediaPlayer(); 204f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) void died(); 205f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) void disconnect(); 206f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) 207f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) status_t setDataSource( 208f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) const sp<IMediaHTTPService> &httpService, 209f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) const char *url, 210f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) const KeyedVector<String8, String8> *headers); 211f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) 212f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) status_t setDataSource(int fd, int64_t offset, int64_t length); 213f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) status_t setDataSource(const sp<IStreamSource> &source); 214f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) status_t setVideoSurfaceTexture( 215f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) const sp<IGraphicBufferProducer>& bufferProducer); 216f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) status_t setListener(const sp<MediaPlayerListener>& listener); 217f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) status_t prepare(); 218f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) status_t prepareAsync(); 219f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) status_t start(); 220f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) status_t stop(); 221f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) status_t pause(); 222f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) bool isPlaying(); 223f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) status_t getVideoWidth(int *w); 224f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) status_t getVideoHeight(int *h); 225f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) status_t seekTo(int msec); 226f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) status_t getCurrentPosition(int *msec); 227f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) status_t getDuration(int *msec); 228f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) status_t reset(); 229f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) status_t setAudioStreamType(audio_stream_type_t type); 230f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) status_t getAudioStreamType(audio_stream_type_t *type); 231f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) status_t setLooping(int loop); 232f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) bool isLooping(); 233f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) status_t setVolume(float leftVolume, float rightVolume); 234f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) void notify(int msg, int ext1, int ext2, const Parcel *obj = NULL); 235f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) static status_t decode( 236f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) const sp<IMediaHTTPService> &httpService, 237f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) const char* url, 238f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) uint32_t *pSampleRate, 239f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) int* pNumChannels, 240f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) audio_format_t* pFormat, 241f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) const sp<IMemoryHeap>& heap, 242f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) size_t *pSize); 243f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) static status_t decode(int fd, int64_t offset, int64_t length, uint32_t *pSampleRate, 244f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) int* pNumChannels, audio_format_t* pFormat, 245f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) const sp<IMemoryHeap>& heap, size_t *pSize); 246f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) status_t invoke(const Parcel& request, Parcel *reply); 247f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) status_t setMetadataFilter(const Parcel& filter); 248f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) status_t getMetadata(bool update_only, bool apply_filter, Parcel *metadata); 249f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) status_t setAudioSessionId(int sessionId); 250f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) int getAudioSessionId(); 251f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) status_t setAuxEffectSendLevel(float level); 252f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) status_t attachAuxEffect(int effectId); 253f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) status_t setParameter(int key, const Parcel& request); 254f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) status_t getParameter(int key, Parcel* reply); 255f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) status_t setRetransmitEndpoint(const char* addrString, uint16_t port); 256f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) status_t setNextMediaPlayer(const sp<MediaPlayer>& player); 257f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) 258f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)private: 259f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) void clear_l(); 260f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) status_t seekTo_l(int msec); 261f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) status_t prepareAsync_l(); 262f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) status_t getDuration_l(int *msec); 263f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) status_t attachNewPlayer(const sp<IMediaPlayer>& player); 264f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) status_t reset_l(); 265f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) status_t doSetRetransmitEndpoint(const sp<IMediaPlayer>& player); 266f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) status_t checkStateForKeySet_l(int key); 267f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) 268f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) sp<IMediaPlayer> mPlayer; 269f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) thread_id_t mLockThreadId; 270f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) Mutex mLock; 271f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) Mutex mNotifyLock; 272f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) Condition mSignal; 273f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) sp<MediaPlayerListener> mListener; 274f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) void* mCookie; 275f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) media_player_states mCurrentState; 276f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) int mCurrentPosition; 277f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) int mSeekPosition; 278f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) bool mPrepareSync; 279f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) status_t mPrepareStatus; 280f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) audio_stream_type_t mStreamType; 281f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) Parcel* mAudioAttributesParcel; 282f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) bool mLoop; 283f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) float mLeftVolume; 284f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) float mRightVolume; 285f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) int mVideoWidth; 286f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) int mVideoHeight; 287f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) int mAudioSessionId; 288f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) float mSendLevel; 289f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) struct sockaddr_in mRetransmitEndpoint; 290f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) bool mRetransmitEndpointValid; 291f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)}; 292f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) 293f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)}; // namespace android 294f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles) 295f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)#endif // ANDROID_MEDIAPLAYER_H 296f4ed1cf5d184064c4cf0e4359c6d5d8aadb50afaTorne (Richard Coles)