/* ** Copyright (C) 2008 The Android Open Source Project ** ** Licensed under the Apache License, Version 2.0 (the "License"); ** you may not use this file except in compliance with the License. ** You may obtain a copy of the License at ** ** http://www.apache.org/licenses/LICENSE-2.0 ** ** Unless required by applicable law or agreed to in writing, software ** distributed under the License is distributed on an "AS IS" BASIS, ** WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. ** See the License for the specific language governing permissions and ** ** limitations under the License. */ #ifndef ANDROID_MEDIARECORDER_H #define ANDROID_MEDIARECORDER_H #include #include #include #include #include #include namespace android { class Surface; class IMediaRecorder; class ICamera; typedef void (*media_completion_f)(status_t status, void *cookie); /* Do not change these values without updating their counterparts * in media/java/android/media/MediaRecorder.java! */ enum audio_source { AUDIO_SOURCE_DEFAULT = 0, AUDIO_SOURCE_MIC = 1, AUDIO_SOURCE_VOICE_UPLINK = 2, AUDIO_SOURCE_VOICE_DOWNLINK = 3, AUDIO_SOURCE_VOICE_CALL = 4, AUDIO_SOURCE_CAMCORDER = 5, AUDIO_SOURCE_VOICE_RECOGNITION = 6, AUDIO_SOURCE_VOICE_COMMUNICATION = 7, AUDIO_SOURCE_FM_RX = 8, AUDIO_SOURCE_FM_RX_A2DP = 9, AUDIO_SOURCE_MAX = AUDIO_SOURCE_FM_RX_A2DP, AUDIO_SOURCE_LIST_END // must be last - used to validate audio source type }; enum video_source { VIDEO_SOURCE_DEFAULT = 0, VIDEO_SOURCE_CAMERA = 1, VIDEO_SOURCE_LIST_END // must be last - used to validate audio source type }; //Please update media/java/android/media/MediaRecorder.java if the following is updated. enum output_format { OUTPUT_FORMAT_DEFAULT = 0, OUTPUT_FORMAT_THREE_GPP = 1, OUTPUT_FORMAT_MPEG_4 = 2, OUTPUT_FORMAT_AUDIO_ONLY_START = 3, // Used in validating the output format. Should be the // at the start of the audio only output formats. /* These are audio only file formats */ OUTPUT_FORMAT_RAW_AMR = 3, //to be backward compatible OUTPUT_FORMAT_AMR_NB = 3, OUTPUT_FORMAT_AMR_WB = 4, OUTPUT_FORMAT_AAC_ADIF = 5, OUTPUT_FORMAT_AAC_ADTS = 6, /* Stream over a socket, limited to a single stream */ OUTPUT_FORMAT_RTP_AVP = 7, /* H.264/AAC data encapsulated in MPEG2/TS */ OUTPUT_FORMAT_MPEG2TS = 8, OUTPUT_FORMAT_QCP = 9, // QCP file format OUTPUT_FORMAT_THREE_GPP2 = 10, /*3GPP2*/ OUTPUT_FORMAT_LIST_END // must be last - used to validate format type }; enum audio_encoder { AUDIO_ENCODER_DEFAULT = 0, AUDIO_ENCODER_AMR_NB = 1, AUDIO_ENCODER_AMR_WB = 2, AUDIO_ENCODER_AAC = 3, AUDIO_ENCODER_AAC_PLUS = 4, AUDIO_ENCODER_EAAC_PLUS = 5, AUDIO_ENCODER_EVRC = 6, AUDIO_ENCODER_QCELP = 7, AUDIO_ENCODER_LIST_END // must be the last - used to validate the audio encoder type }; enum video_encoder { VIDEO_ENCODER_DEFAULT = 0, VIDEO_ENCODER_H263 = 1, VIDEO_ENCODER_H264 = 2, VIDEO_ENCODER_MPEG_4_SP = 3, VIDEO_ENCODER_LIST_END // must be the last - used to validate the video encoder type }; /* * The state machine of the media_recorder uses a set of different state names. * The mapping between the media_recorder and the pvauthorengine is shown below: * * mediarecorder pvauthorengine * ---------------------------------------------------------------- * MEDIA_RECORDER_ERROR ERROR * MEDIA_RECORDER_IDLE IDLE * MEDIA_RECORDER_INITIALIZED OPENED * MEDIA_RECORDER_DATASOURCE_CONFIGURED * MEDIA_RECORDER_PREPARED INITIALIZED * MEDIA_RECORDER_RECORDING RECORDING */ enum media_recorder_states { MEDIA_RECORDER_ERROR = 0, MEDIA_RECORDER_IDLE = 1 << 0, MEDIA_RECORDER_INITIALIZED = 1 << 1, MEDIA_RECORDER_DATASOURCE_CONFIGURED = 1 << 2, MEDIA_RECORDER_PREPARED = 1 << 3, MEDIA_RECORDER_RECORDING = 1 << 4, }; // The "msg" code passed to the listener in notify. enum media_recorder_event_type { MEDIA_RECORDER_EVENT_ERROR = 1, MEDIA_RECORDER_EVENT_INFO = 2, MEDIA_RECORDER_MSG_COMPRESSED_IMAGE = 8 }; enum media_recorder_error_type { MEDIA_RECORDER_ERROR_UNKNOWN = 1, MEDIA_RECORDER_ERROR_RESOURCE = 2 }; // The codes are distributed as follow: // 0xx: Reserved // 8xx: General info/warning // enum media_recorder_info_type { MEDIA_RECORDER_INFO_UNKNOWN = 1, MEDIA_RECORDER_INFO_MAX_DURATION_REACHED = 800, MEDIA_RECORDER_INFO_MAX_FILESIZE_REACHED = 801, MEDIA_RECORDER_INFO_COMPLETION_STATUS = 802, MEDIA_RECORDER_INFO_PROGRESS_FRAME_STATUS = 803, MEDIA_RECORDER_INFO_PROGRESS_TIME_STATUS = 804, MEDIA_RECORDER_UNSUPPORTED_RESOLUTION = 805, }; // ---------------------------------------------------------------------------- // ref-counted object for callbacks class MediaRecorderListener: virtual public RefBase { public: virtual void notify(int msg, int ext1, int ext2) = 0; virtual void postData(int32_t msgType, const sp& dataPtr) = 0; }; class MediaRecorder : public BnMediaRecorderClient, public virtual IMediaDeathNotifier { public: MediaRecorder(); ~MediaRecorder(); void died(); status_t initCheck(); status_t setCamera(const sp& camera); status_t setPreviewSurface(const sp& surface); status_t setVideoSource(int vs); status_t setAudioSource(int as); status_t setOutputFormat(int of); status_t setVideoEncoder(int ve); status_t setAudioEncoder(int ae); status_t setOutputFile(const char* path); status_t setOutputFile(int fd, int64_t offset, int64_t length); status_t setVideoSize(int width, int height); status_t setVideoFrameRate(int frames_per_second); status_t setParameters(const String8& params); status_t setCameraParameters(const String8& params); status_t setListener(const sp& listener); status_t prepare(); status_t getMaxAmplitude(int* max); status_t start(); status_t takeLiveSnapshot(); status_t stop(); status_t reset(); status_t init(); status_t close(); status_t release(); void notify(int msg, int ext1, int ext2); void dataCallback(int32_t msgType, const sp& dataPtr); private: void doCleanUp(); status_t doReset(); sp mMediaRecorder; sp mListener; media_recorder_states mCurrentState; bool mIsAudioSourceSet; bool mIsVideoSourceSet; bool mIsAudioEncoderSet; bool mIsVideoEncoderSet; bool mIsOutputFileSet; Mutex mLock; Mutex mNotifyLock; Mutex mdataCallbackLock; }; }; // namespace android #endif // ANDROID_MEDIARECORDER_H