1 /*
2  * Copyright (C) 2009 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  * limitations under the License.
15  */
16 
17 #ifndef STAGEFRIGHT_RECORDER_H_
18 
19 #define STAGEFRIGHT_RECORDER_H_
20 
21 #include <media/MediaAnalyticsItem.h>
22 #include <media/MediaRecorderBase.h>
23 #include <camera/CameraParameters.h>
24 #include <utils/String8.h>
25 
26 #include <system/audio.h>
27 
28 #include <media/hardware/MetadataBufferType.h>
29 
30 namespace android {
31 
32 class Camera;
33 class ICameraRecordingProxy;
34 class CameraSource;
35 class CameraSourceTimeLapse;
36 struct MediaCodecSource;
37 struct MediaSource;
38 struct MediaWriter;
39 class MetaData;
40 struct AudioSource;
41 class MediaProfiles;
42 struct ALooper;
43 
44 struct StagefrightRecorder : public MediaRecorderBase {
45     explicit StagefrightRecorder(const String16 &opPackageName);
46     virtual ~StagefrightRecorder();
47     virtual status_t init();
48     virtual status_t setAudioSource(audio_source_t as);
49     virtual status_t setVideoSource(video_source vs);
50     virtual status_t setOutputFormat(output_format of);
51     virtual status_t setAudioEncoder(audio_encoder ae);
52     virtual status_t setVideoEncoder(video_encoder ve);
53     virtual status_t setVideoSize(int width, int height);
54     virtual status_t setVideoFrameRate(int frames_per_second);
55     virtual status_t setCamera(const sp<hardware::ICamera>& camera, const sp<ICameraRecordingProxy>& proxy);
56     virtual status_t setPreviewSurface(const sp<IGraphicBufferProducer>& surface);
57     virtual status_t setInputSurface(const sp<PersistentSurface>& surface);
58     virtual status_t setOutputFile(int fd);
59     virtual status_t setNextOutputFile(int fd);
60     virtual status_t setParameters(const String8 &params);
61     virtual status_t setListener(const sp<IMediaRecorderClient> &listener);
62     virtual status_t setClientName(const String16 &clientName);
63     virtual status_t prepare();
64     virtual status_t start();
65     virtual status_t pause();
66     virtual status_t resume();
67     virtual status_t stop();
68     virtual status_t close();
69     virtual status_t reset();
70     virtual status_t getMaxAmplitude(int *max);
71     virtual status_t getMetrics(Parcel *reply);
72     virtual status_t dump(int fd, const Vector<String16> &args) const;
73     // Querying a SurfaceMediaSourcer
74     virtual sp<IGraphicBufferProducer> querySurfaceMediaSource() const;
75     virtual status_t setInputDevice(audio_port_handle_t deviceId);
76     virtual status_t getRoutedDeviceId(audio_port_handle_t* deviceId);
77     virtual void setAudioDeviceCallback(const sp<AudioSystem::AudioDeviceCallback>& callback);
78     virtual status_t enableAudioDeviceCallback(bool enabled);
79     virtual status_t getActiveMicrophones(std::vector<media::MicrophoneInfo>* activeMicrophones);
80 
81 
82 private:
83     mutable Mutex mLock;
84     sp<hardware::ICamera> mCamera;
85     sp<ICameraRecordingProxy> mCameraProxy;
86     sp<IGraphicBufferProducer> mPreviewSurface;
87     sp<PersistentSurface> mPersistentSurface;
88     sp<IMediaRecorderClient> mListener;
89     String16 mClientName;
90     uid_t mClientUid;
91     pid_t mClientPid;
92     sp<MediaWriter> mWriter;
93     int mOutputFd;
94     sp<AudioSource> mAudioSourceNode;
95 
96     MediaAnalyticsItem *mAnalyticsItem;
97     bool mAnalyticsDirty;
98     void flushAndResetMetrics(bool reinitialize);
99     void updateMetrics();
100 
101     audio_source_t mAudioSource;
102     video_source mVideoSource;
103     output_format mOutputFormat;
104     audio_encoder mAudioEncoder;
105     video_encoder mVideoEncoder;
106     bool mUse64BitFileOffset;
107     int32_t mVideoWidth, mVideoHeight;
108     int32_t mFrameRate;
109     int32_t mVideoBitRate;
110     int32_t mAudioBitRate;
111     int32_t mAudioChannels;
112     int32_t mSampleRate;
113     int32_t mInterleaveDurationUs;
114     int32_t mIFramesIntervalSec;
115     int32_t mCameraId;
116     int32_t mVideoEncoderProfile;
117     int32_t mVideoEncoderLevel;
118     int32_t mMovieTimeScale;
119     int32_t mVideoTimeScale;
120     int32_t mAudioTimeScale;
121     int64_t mMaxFileSizeBytes;
122     int64_t mMaxFileDurationUs;
123     int64_t mTrackEveryTimeDurationUs;
124     int32_t mRotationDegrees;  // Clockwise
125     int32_t mLatitudex10000;
126     int32_t mLongitudex10000;
127     int32_t mStartTimeOffsetMs;
128     int32_t mTotalBitRate;
129 
130     int64_t mDurationRecordedUs;
131     int64_t mStartedRecordingUs;
132     int64_t mDurationPausedUs;
133     int32_t mNPauses;
134 
135     bool mCaptureFpsEnable;
136     double mCaptureFps;
137     int64_t mTimeBetweenCaptureUs;
138     sp<CameraSourceTimeLapse> mCameraSourceTimeLapse;
139 
140     String8 mParams;
141 
142     MetadataBufferType mMetaDataStoredInVideoBuffers;
143     MediaProfiles *mEncoderProfiles;
144 
145     int64_t mPauseStartTimeUs;
146     int64_t mTotalPausedDurationUs;
147     sp<MediaCodecSource> mAudioEncoderSource;
148     sp<MediaCodecSource> mVideoEncoderSource;
149 
150     bool mStarted;
151     // Needed when GLFrames are encoded.
152     // An <IGraphicBufferProducer> pointer
153     // will be sent to the client side using which the
154     // frame buffers will be queued and dequeued
155     sp<IGraphicBufferProducer> mGraphicBufferProducer;
156     sp<ALooper> mLooper;
157 
158     audio_port_handle_t mSelectedDeviceId;
159     bool mDeviceCallbackEnabled;
160     wp<AudioSystem::AudioDeviceCallback> mAudioDeviceCallback;
161 
162     static const int kMaxHighSpeedFps = 1000;
163 
164     status_t prepareInternal();
165     status_t setupMPEG4orWEBMRecording();
166     void setupMPEG4orWEBMMetaData(sp<MetaData> *meta);
167     status_t setupAMRRecording();
168     status_t setupAACRecording();
169     status_t setupRawAudioRecording();
170     status_t setupRTPRecording();
171     status_t setupMPEG2TSRecording();
172     sp<MediaCodecSource> createAudioSource();
173     status_t checkVideoEncoderCapabilities();
174     status_t checkAudioEncoderCapabilities();
175     // Generic MediaSource set-up. Returns the appropriate
176     // source (CameraSource or SurfaceMediaSource)
177     // depending on the videosource type
178     status_t setupMediaSource(sp<MediaSource> *mediaSource);
179     status_t setupCameraSource(sp<CameraSource> *cameraSource);
180     status_t setupAudioEncoder(const sp<MediaWriter>& writer);
181     status_t setupVideoEncoder(const sp<MediaSource>& cameraSource, sp<MediaCodecSource> *source);
182 
183     // Encoding parameter handling utilities
184     status_t setParameter(const String8 &key, const String8 &value);
185     status_t setParamAudioEncodingBitRate(int32_t bitRate);
186     status_t setParamAudioNumberOfChannels(int32_t channles);
187     status_t setParamAudioSamplingRate(int32_t sampleRate);
188     status_t setParamAudioTimeScale(int32_t timeScale);
189     status_t setParamCaptureFpsEnable(int32_t timeLapseEnable);
190     status_t setParamCaptureFps(double fps);
191     status_t setParamVideoEncodingBitRate(int32_t bitRate);
192     status_t setParamVideoIFramesInterval(int32_t seconds);
193     status_t setParamVideoEncoderProfile(int32_t profile);
194     status_t setParamVideoEncoderLevel(int32_t level);
195     status_t setParamVideoCameraId(int32_t cameraId);
196     status_t setParamVideoTimeScale(int32_t timeScale);
197     status_t setParamVideoRotation(int32_t degrees);
198     status_t setParamTrackTimeStatus(int64_t timeDurationUs);
199     status_t setParamInterleaveDuration(int32_t durationUs);
200     status_t setParam64BitFileOffset(bool use64BitFileOffset);
201     status_t setParamMaxFileDurationUs(int64_t timeUs);
202     status_t setParamMaxFileSizeBytes(int64_t bytes);
203     status_t setParamMovieTimeScale(int32_t timeScale);
204     status_t setParamGeoDataLongitude(int64_t longitudex10000);
205     status_t setParamGeoDataLatitude(int64_t latitudex10000);
206     void clipVideoBitRate();
207     void clipVideoFrameRate();
208     void clipVideoFrameWidth();
209     void clipVideoFrameHeight();
210     void clipAudioBitRate();
211     void clipAudioSampleRate();
212     void clipNumberOfAudioChannels();
213     void setDefaultProfileIfNecessary();
214     void setDefaultVideoEncoderIfNecessary();
215 
216 
217     StagefrightRecorder(const StagefrightRecorder &);
218     StagefrightRecorder &operator=(const StagefrightRecorder &);
219 };
220 
221 }  // namespace android
222 
223 #endif  // STAGEFRIGHT_RECORDER_H_
224