1 /* 2 ** Copyright (C) 2008 The Android Open Source Project 3 ** 4 ** Licensed under the Apache License, Version 2.0 (the "License"); 5 ** you may not use this file except in compliance with the License. 6 ** You may obtain a copy of the License at 7 ** 8 ** http://www.apache.org/licenses/LICENSE-2.0 9 ** 10 ** Unless required by applicable law or agreed to in writing, software 11 ** distributed under the License is distributed on an "AS IS" BASIS, 12 ** WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 ** See the License for the specific language governing permissions and 14 ** 15 ** limitations under the License. 16 */ 17 18 #ifndef ANDROID_MEDIARECORDER_H 19 #define ANDROID_MEDIARECORDER_H 20 21 #include <utils/Log.h> 22 #include <utils/threads.h> 23 #include <utils/List.h> 24 #include <utils/Errors.h> 25 #include <media/IMediaRecorderClient.h> 26 #include <media/IMediaDeathNotifier.h> 27 28 namespace android { 29 30 class Surface; 31 class IMediaRecorder; 32 class ICamera; 33 34 typedef void (*media_completion_f)(status_t status, void *cookie); 35 36 /* Do not change these values without updating their counterparts 37 * in media/java/android/media/MediaRecorder.java! 38 */ 39 enum audio_source { 40 AUDIO_SOURCE_DEFAULT = 0, 41 AUDIO_SOURCE_MIC = 1, 42 AUDIO_SOURCE_VOICE_UPLINK = 2, 43 AUDIO_SOURCE_VOICE_DOWNLINK = 3, 44 AUDIO_SOURCE_VOICE_CALL = 4, 45 AUDIO_SOURCE_CAMCORDER = 5, 46 AUDIO_SOURCE_VOICE_RECOGNITION = 6, 47 AUDIO_SOURCE_VOICE_COMMUNICATION = 7, 48 AUDIO_SOURCE_MAX = AUDIO_SOURCE_VOICE_COMMUNICATION, 49 50 AUDIO_SOURCE_LIST_END // must be last - used to validate audio source type 51 }; 52 53 enum video_source { 54 VIDEO_SOURCE_DEFAULT = 0, 55 VIDEO_SOURCE_CAMERA = 1, 56 57 VIDEO_SOURCE_LIST_END // must be last - used to validate audio source type 58 }; 59 60 //Please update media/java/android/media/MediaRecorder.java if the following is updated. 61 enum output_format { 62 OUTPUT_FORMAT_DEFAULT = 0, 63 OUTPUT_FORMAT_THREE_GPP = 1, 64 OUTPUT_FORMAT_MPEG_4 = 2, 65 66 67 OUTPUT_FORMAT_AUDIO_ONLY_START = 3, // Used in validating the output format. Should be the 68 // at the start of the audio only output formats. 69 70 /* These are audio only file formats */ 71 OUTPUT_FORMAT_RAW_AMR = 3, //to be backward compatible 72 OUTPUT_FORMAT_AMR_NB = 3, 73 OUTPUT_FORMAT_AMR_WB = 4, 74 OUTPUT_FORMAT_AAC_ADIF = 5, 75 OUTPUT_FORMAT_AAC_ADTS = 6, 76 77 /* Stream over a socket, limited to a single stream */ 78 OUTPUT_FORMAT_RTP_AVP = 7, 79 80 /* H.264/AAC data encapsulated in MPEG2/TS */ 81 OUTPUT_FORMAT_MPEG2TS = 8, 82 83 OUTPUT_FORMAT_LIST_END // must be last - used to validate format type 84 }; 85 86 enum audio_encoder { 87 AUDIO_ENCODER_DEFAULT = 0, 88 AUDIO_ENCODER_AMR_NB = 1, 89 AUDIO_ENCODER_AMR_WB = 2, 90 AUDIO_ENCODER_AAC = 3, 91 AUDIO_ENCODER_AAC_PLUS = 4, 92 AUDIO_ENCODER_EAAC_PLUS = 5, 93 94 AUDIO_ENCODER_LIST_END // must be the last - used to validate the audio encoder type 95 }; 96 97 enum video_encoder { 98 VIDEO_ENCODER_DEFAULT = 0, 99 VIDEO_ENCODER_H263 = 1, 100 VIDEO_ENCODER_H264 = 2, 101 VIDEO_ENCODER_MPEG_4_SP = 3, 102 103 VIDEO_ENCODER_LIST_END // must be the last - used to validate the video encoder type 104 }; 105 106 /* 107 * The state machine of the media_recorder uses a set of different state names. 108 * The mapping between the media_recorder and the pvauthorengine is shown below: 109 * 110 * mediarecorder pvauthorengine 111 * ---------------------------------------------------------------- 112 * MEDIA_RECORDER_ERROR ERROR 113 * MEDIA_RECORDER_IDLE IDLE 114 * MEDIA_RECORDER_INITIALIZED OPENED 115 * MEDIA_RECORDER_DATASOURCE_CONFIGURED 116 * MEDIA_RECORDER_PREPARED INITIALIZED 117 * MEDIA_RECORDER_RECORDING RECORDING 118 */ 119 enum media_recorder_states { 120 MEDIA_RECORDER_ERROR = 0, 121 MEDIA_RECORDER_IDLE = 1 << 0, 122 MEDIA_RECORDER_INITIALIZED = 1 << 1, 123 MEDIA_RECORDER_DATASOURCE_CONFIGURED = 1 << 2, 124 MEDIA_RECORDER_PREPARED = 1 << 3, 125 MEDIA_RECORDER_RECORDING = 1 << 4, 126 }; 127 128 // The "msg" code passed to the listener in notify. 129 enum media_recorder_event_type { 130 MEDIA_RECORDER_EVENT_ERROR = 1, 131 MEDIA_RECORDER_EVENT_INFO = 2 132 }; 133 134 enum media_recorder_error_type { 135 MEDIA_RECORDER_ERROR_UNKNOWN = 1 136 }; 137 138 // The codes are distributed as follow: 139 // 0xx: Reserved 140 // 8xx: General info/warning 141 // 142 enum media_recorder_info_type { 143 MEDIA_RECORDER_INFO_UNKNOWN = 1, 144 MEDIA_RECORDER_INFO_MAX_DURATION_REACHED = 800, 145 MEDIA_RECORDER_INFO_MAX_FILESIZE_REACHED = 801, 146 MEDIA_RECORDER_INFO_COMPLETION_STATUS = 802, 147 MEDIA_RECORDER_INFO_PROGRESS_FRAME_STATUS = 803, 148 MEDIA_RECORDER_INFO_PROGRESS_TIME_STATUS = 804, 149 }; 150 151 // ---------------------------------------------------------------------------- 152 // ref-counted object for callbacks 153 class MediaRecorderListener: virtual public RefBase 154 { 155 public: 156 virtual void notify(int msg, int ext1, int ext2) = 0; 157 }; 158 159 class MediaRecorder : public BnMediaRecorderClient, 160 public virtual IMediaDeathNotifier 161 { 162 public: 163 MediaRecorder(); 164 ~MediaRecorder(); 165 166 void died(); 167 status_t initCheck(); 168 status_t setCamera(const sp<ICamera>& camera); 169 status_t setPreviewSurface(const sp<Surface>& surface); 170 status_t setVideoSource(int vs); 171 status_t setAudioSource(int as); 172 status_t setOutputFormat(int of); 173 status_t setVideoEncoder(int ve); 174 status_t setAudioEncoder(int ae); 175 status_t setOutputFile(const char* path); 176 status_t setOutputFile(int fd, int64_t offset, int64_t length); 177 status_t setVideoSize(int width, int height); 178 status_t setVideoFrameRate(int frames_per_second); 179 status_t setParameters(const String8& params); 180 status_t setListener(const sp<MediaRecorderListener>& listener); 181 status_t prepare(); 182 status_t getMaxAmplitude(int* max); 183 status_t start(); 184 status_t stop(); 185 status_t reset(); 186 status_t init(); 187 status_t close(); 188 status_t release(); 189 void notify(int msg, int ext1, int ext2); 190 191 private: 192 void doCleanUp(); 193 status_t doReset(); 194 195 sp<IMediaRecorder> mMediaRecorder; 196 sp<MediaRecorderListener> mListener; 197 media_recorder_states mCurrentState; 198 bool mIsAudioSourceSet; 199 bool mIsVideoSourceSet; 200 bool mIsAudioEncoderSet; 201 bool mIsVideoEncoderSet; 202 bool mIsOutputFileSet; 203 Mutex mLock; 204 Mutex mNotifyLock; 205 }; 206 207 }; // namespace android 208 209 #endif // ANDROID_MEDIARECORDER_H 210