42419ce28a
The purpose of ICameraRecordingProxy and ICameraRecordingProxyListener is to allow applications using the camera during recording. Camera service allows only one client at a time. Since camcorder application needs to own the camera to do things like zoom, the media recorder cannot access the camera directly during recording. So ICameraRecordingProxy is a proxy of ICamera, which allows the media recorder to start/stop the recording and release recording frames. ICameraRecordingProxyListener is an interface that allows the recorder to receive video frames during recording. ICameraRecordingProxy startRecording() stopRecording() releaseRecordingFrame() ICameraRecordingProxyListener dataCallbackTimestamp() The camcorder app opens the camera and starts the preview. The app passes ICamera and ICameraRecordingProxy to the media recorder by MediaRecorder::setCamera(). The recorder uses ICamera to setup the camera in MediaRecorder::start(). After setup, the recorder disconnects from camera service. The recorder calls ICameraRecordingProxy::startRecording() and passes a ICameraRecordingProxyListener to the app. The app connects back to camera service and starts the recording. The app owns the camera and can do things like zoom. The media recorder receives the video frames from the listener and releases them by ICameraRecordingProxy::releaseRecordingFrame. The recorder calls ICameraRecordingProxy::stopRecording() to stop the recording. The call sequences are as follows: 1. The app: Camera.unlock(). 2. The app: MediaRecorder.setCamera(). 3. Start recording (1) The app: MediaRecorder.start(). (2) The recorder: ICamera.unlock() and ICamera.disconnect(). (3) The recorder: ICameraRecordingProxy.startRecording(). (4) The app: ICamera.reconnect(). (5) The app: ICamera.startRecording(). 4. During recording (1) The recorder: receive frames from ICameraRecordingProxyListener.dataCallbackTimestamp() (2) The recorder: release frames by ICameraRecordingProxy.releaseRecordingFrame(). 5. Stop recording (1) The app: MediaRecorder.stop() (2) The recorder: ICameraRecordingProxy.stopRecording(). (3) The app: ICamera.stopRecording(). bug:2644213 Change-Id: I15269397defc25cbbcae16abc071c8349c123122
74 lines
2.5 KiB
C++
74 lines
2.5 KiB
C++
/*
|
|
**
|
|
** Copyright 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_IMEDIARECORDER_H
|
|
#define ANDROID_IMEDIARECORDER_H
|
|
|
|
#include <binder/IInterface.h>
|
|
|
|
namespace android {
|
|
|
|
class Surface;
|
|
class ICamera;
|
|
class ICameraRecordingProxy;
|
|
class IMediaRecorderClient;
|
|
|
|
class IMediaRecorder: public IInterface
|
|
{
|
|
public:
|
|
DECLARE_META_INTERFACE(MediaRecorder);
|
|
|
|
virtual status_t setCamera(const sp<ICamera>& camera,
|
|
const sp<ICameraRecordingProxy>& proxy) = 0;
|
|
virtual status_t setPreviewSurface(const sp<Surface>& surface) = 0;
|
|
virtual status_t setVideoSource(int vs) = 0;
|
|
virtual status_t setAudioSource(int as) = 0;
|
|
virtual status_t setOutputFormat(int of) = 0;
|
|
virtual status_t setVideoEncoder(int ve) = 0;
|
|
virtual status_t setAudioEncoder(int ae) = 0;
|
|
virtual status_t setOutputFile(const char* path) = 0;
|
|
virtual status_t setOutputFile(int fd, int64_t offset, int64_t length) = 0;
|
|
virtual status_t setOutputFileAuxiliary(int fd) = 0;
|
|
virtual status_t setVideoSize(int width, int height) = 0;
|
|
virtual status_t setVideoFrameRate(int frames_per_second) = 0;
|
|
virtual status_t setParameters(const String8& params) = 0;
|
|
virtual status_t setListener(const sp<IMediaRecorderClient>& listener) = 0;
|
|
virtual status_t prepare() = 0;
|
|
virtual status_t getMaxAmplitude(int* max) = 0;
|
|
virtual status_t start() = 0;
|
|
virtual status_t stop() = 0;
|
|
virtual status_t reset() = 0;
|
|
virtual status_t init() = 0;
|
|
virtual status_t close() = 0;
|
|
virtual status_t release() = 0;
|
|
};
|
|
|
|
// ----------------------------------------------------------------------------
|
|
|
|
class BnMediaRecorder: public BnInterface<IMediaRecorder>
|
|
{
|
|
public:
|
|
virtual status_t onTransact( uint32_t code,
|
|
const Parcel& data,
|
|
Parcel* reply,
|
|
uint32_t flags = 0);
|
|
};
|
|
|
|
}; // namespace android
|
|
|
|
#endif // ANDROID_IMEDIARECORDER_H
|