Home | History | Annotate | Download | only in media
      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 class ICameraRecordingProxy;
     34 class ISurfaceTexture;
     35 class SurfaceTextureClient;
     36 
     37 typedef void (*media_completion_f)(status_t status, void *cookie);
     38 
     39 enum video_source {
     40     VIDEO_SOURCE_DEFAULT = 0,
     41     VIDEO_SOURCE_CAMERA = 1,
     42     VIDEO_SOURCE_GRALLOC_BUFFER = 2,
     43 
     44     VIDEO_SOURCE_LIST_END  // must be last - used to validate audio source type
     45 };
     46 
     47 //Please update media/java/android/media/MediaRecorder.java if the following is updated.
     48 enum output_format {
     49     OUTPUT_FORMAT_DEFAULT = 0,
     50     OUTPUT_FORMAT_THREE_GPP = 1,
     51     OUTPUT_FORMAT_MPEG_4 = 2,
     52 
     53 
     54     OUTPUT_FORMAT_AUDIO_ONLY_START = 3, // Used in validating the output format.  Should be the
     55                                         //  at the start of the audio only output formats.
     56 
     57     /* These are audio only file formats */
     58     OUTPUT_FORMAT_RAW_AMR = 3, //to be backward compatible
     59     OUTPUT_FORMAT_AMR_NB = 3,
     60     OUTPUT_FORMAT_AMR_WB = 4,
     61     OUTPUT_FORMAT_AAC_ADIF = 5,
     62     OUTPUT_FORMAT_AAC_ADTS = 6,
     63 
     64     /* Stream over a socket, limited to a single stream */
     65     OUTPUT_FORMAT_RTP_AVP = 7,
     66 
     67     /* H.264/AAC data encapsulated in MPEG2/TS */
     68     OUTPUT_FORMAT_MPEG2TS = 8,
     69 
     70     OUTPUT_FORMAT_LIST_END // must be last - used to validate format type
     71 };
     72 
     73 enum audio_encoder {
     74     AUDIO_ENCODER_DEFAULT = 0,
     75     AUDIO_ENCODER_AMR_NB = 1,
     76     AUDIO_ENCODER_AMR_WB = 2,
     77     AUDIO_ENCODER_AAC = 3,
     78     AUDIO_ENCODER_AAC_PLUS = 4,
     79     AUDIO_ENCODER_EAAC_PLUS = 5,
     80 
     81     AUDIO_ENCODER_LIST_END // must be the last - used to validate the audio encoder type
     82 };
     83 
     84 enum video_encoder {
     85     VIDEO_ENCODER_DEFAULT = 0,
     86     VIDEO_ENCODER_H263 = 1,
     87     VIDEO_ENCODER_H264 = 2,
     88     VIDEO_ENCODER_MPEG_4_SP = 3,
     89 
     90     VIDEO_ENCODER_LIST_END // must be the last - used to validate the video encoder type
     91 };
     92 
     93 /*
     94  * The state machine of the media_recorder.
     95  */
     96 enum media_recorder_states {
     97     // Error state.
     98     MEDIA_RECORDER_ERROR                 =      0,
     99 
    100     // Recorder was just created.
    101     MEDIA_RECORDER_IDLE                  = 1 << 0,
    102 
    103     // Recorder has been initialized.
    104     MEDIA_RECORDER_INITIALIZED           = 1 << 1,
    105 
    106     // Configuration of the recorder has been completed.
    107     MEDIA_RECORDER_DATASOURCE_CONFIGURED = 1 << 2,
    108 
    109     // Recorder is ready to start.
    110     MEDIA_RECORDER_PREPARED              = 1 << 3,
    111 
    112     // Recording is in progress.
    113     MEDIA_RECORDER_RECORDING             = 1 << 4,
    114 };
    115 
    116 // The "msg" code passed to the listener in notify.
    117 enum media_recorder_event_type {
    118     MEDIA_RECORDER_EVENT_LIST_START               = 1,
    119     MEDIA_RECORDER_EVENT_ERROR                    = 1,
    120     MEDIA_RECORDER_EVENT_INFO                     = 2,
    121     MEDIA_RECORDER_EVENT_LIST_END                 = 99,
    122 
    123     // Track related event types
    124     MEDIA_RECORDER_TRACK_EVENT_LIST_START         = 100,
    125     MEDIA_RECORDER_TRACK_EVENT_ERROR              = 100,
    126     MEDIA_RECORDER_TRACK_EVENT_INFO               = 101,
    127     MEDIA_RECORDER_TRACK_EVENT_LIST_END           = 1000,
    128 };
    129 
    130 /*
    131  * The (part of) "what" code passed to the listener in notify.
    132  * When the error or info type is track specific, the what has
    133  * the following layout:
    134  * the left-most 16-bit is meant for error or info type.
    135  * the right-most 4-bit is meant for track id.
    136  * the rest is reserved.
    137  *
    138  * | track id | reserved |     error or info type     |
    139  * 31         28         16                           0
    140  *
    141  */
    142 enum media_recorder_error_type {
    143     MEDIA_RECORDER_ERROR_UNKNOWN                   = 1,
    144 
    145     // Track related error type
    146     MEDIA_RECORDER_TRACK_ERROR_LIST_START          = 100,
    147     MEDIA_RECORDER_TRACK_ERROR_GENERAL             = 100,
    148     MEDIA_RECORDER_ERROR_VIDEO_NO_SYNC_FRAME       = 200,
    149     MEDIA_RECORDER_TRACK_ERROR_LIST_END            = 1000,
    150 };
    151 
    152 // The codes are distributed as follow:
    153 //   0xx: Reserved
    154 //   8xx: General info/warning
    155 //
    156 enum media_recorder_info_type {
    157     MEDIA_RECORDER_INFO_UNKNOWN                   = 1,
    158 
    159     MEDIA_RECORDER_INFO_MAX_DURATION_REACHED      = 800,
    160     MEDIA_RECORDER_INFO_MAX_FILESIZE_REACHED      = 801,
    161 
    162     // All track related informtional events start here
    163     MEDIA_RECORDER_TRACK_INFO_LIST_START           = 1000,
    164     MEDIA_RECORDER_TRACK_INFO_COMPLETION_STATUS    = 1000,
    165     MEDIA_RECORDER_TRACK_INFO_PROGRESS_IN_TIME     = 1001,
    166     MEDIA_RECORDER_TRACK_INFO_TYPE                 = 1002,
    167     MEDIA_RECORDER_TRACK_INFO_DURATION_MS          = 1003,
    168 
    169     // The time to measure the max chunk duration
    170     MEDIA_RECORDER_TRACK_INFO_MAX_CHUNK_DUR_MS     = 1004,
    171 
    172     MEDIA_RECORDER_TRACK_INFO_ENCODED_FRAMES       = 1005,
    173 
    174     // The time to measure how well the audio and video
    175     // track data is interleaved.
    176     MEDIA_RECORDER_TRACK_INTER_CHUNK_TIME_MS       = 1006,
    177 
    178     // The time to measure system response. Note that
    179     // the delay does not include the intentional delay
    180     // we use to eliminate the recording sound.
    181     MEDIA_RECORDER_TRACK_INFO_INITIAL_DELAY_MS     = 1007,
    182 
    183     // The time used to compensate for initial A/V sync.
    184     MEDIA_RECORDER_TRACK_INFO_START_OFFSET_MS      = 1008,
    185 
    186     // Total number of bytes of the media data.
    187     MEDIA_RECORDER_TRACK_INFO_DATA_KBYTES          = 1009,
    188 
    189     MEDIA_RECORDER_TRACK_INFO_LIST_END             = 2000,
    190 };
    191 
    192 // ----------------------------------------------------------------------------
    193 // ref-counted object for callbacks
    194 class MediaRecorderListener: virtual public RefBase
    195 {
    196 public:
    197     virtual void notify(int msg, int ext1, int ext2) = 0;
    198 };
    199 
    200 class MediaRecorder : public BnMediaRecorderClient,
    201                       public virtual IMediaDeathNotifier
    202 {
    203 public:
    204     MediaRecorder();
    205     ~MediaRecorder();
    206 
    207     void        died();
    208     status_t    initCheck();
    209     status_t    setCamera(const sp<ICamera>& camera, const sp<ICameraRecordingProxy>& proxy);
    210     status_t    setPreviewSurface(const sp<Surface>& surface);
    211     status_t    setVideoSource(int vs);
    212     status_t    setAudioSource(int as);
    213     status_t    setOutputFormat(int of);
    214     status_t    setVideoEncoder(int ve);
    215     status_t    setAudioEncoder(int ae);
    216     status_t    setOutputFile(const char* path);
    217     status_t    setOutputFile(int fd, int64_t offset, int64_t length);
    218     status_t    setVideoSize(int width, int height);
    219     status_t    setVideoFrameRate(int frames_per_second);
    220     status_t    setParameters(const String8& params);
    221     status_t    setListener(const sp<MediaRecorderListener>& listener);
    222     status_t    prepare();
    223     status_t    getMaxAmplitude(int* max);
    224     status_t    start();
    225     status_t    stop();
    226     status_t    reset();
    227     status_t    init();
    228     status_t    close();
    229     status_t    release();
    230     void        notify(int msg, int ext1, int ext2);
    231     sp<ISurfaceTexture>     querySurfaceMediaSourceFromMediaServer();
    232 
    233 private:
    234     void                    doCleanUp();
    235     status_t                doReset();
    236 
    237     sp<IMediaRecorder>          mMediaRecorder;
    238     sp<MediaRecorderListener>   mListener;
    239 
    240     // Reference toISurfaceTexture
    241     // for encoding GL Frames. That is useful only when the
    242     // video source is set to VIDEO_SOURCE_GRALLOC_BUFFER
    243     sp<ISurfaceTexture>         mSurfaceMediaSource;
    244 
    245     media_recorder_states       mCurrentState;
    246     bool                        mIsAudioSourceSet;
    247     bool                        mIsVideoSourceSet;
    248     bool                        mIsAudioEncoderSet;
    249     bool                        mIsVideoEncoderSet;
    250     bool                        mIsOutputFileSet;
    251     Mutex                       mLock;
    252     Mutex                       mNotifyLock;
    253 };
    254 
    255 };  // namespace android
    256 
    257 #endif // ANDROID_MEDIARECORDER_H
    258