CameraService.h revision 2fd2440d0175ca3e196b01b7541a9e0d4ed9a694
1/* 2** 3** Copyright (C) 2008, The Android Open Source Project 4** 5** Licensed under the Apache License, Version 2.0 (the "License"); 6** you may not use this file except in compliance with the License. 7** You may obtain a copy of the License at 8** 9** http://www.apache.org/licenses/LICENSE-2.0 10** 11** Unless required by applicable law or agreed to in writing, software 12** distributed under the License is distributed on an "AS IS" BASIS, 13** WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 14** See the License for the specific language governing permissions and 15** limitations under the License. 16*/ 17 18#ifndef ANDROID_SERVERS_CAMERA_CAMERASERVICE_H 19#define ANDROID_SERVERS_CAMERA_CAMERASERVICE_H 20 21#include <binder/BinderService.h> 22#include <camera/ICameraService.h> 23#include <hardware/camera.h> 24 25/* This needs to be increased if we can have more cameras */ 26#define MAX_CAMERAS 2 27 28namespace android { 29 30class MemoryHeapBase; 31class MediaPlayer; 32class CameraHardwareInterface; 33 34class CameraService : 35 public BinderService<CameraService>, 36 public BnCameraService 37{ 38 class Client; 39 friend class BinderService<CameraService>; 40public: 41 static char const* getServiceName() { return "media.camera"; } 42 43 CameraService(); 44 virtual ~CameraService(); 45 46 virtual int32_t getNumberOfCameras(); 47 virtual status_t getCameraInfo(int cameraId, 48 struct CameraInfo* cameraInfo); 49 virtual sp<ICamera> connect(const sp<ICameraClient>& cameraClient, int cameraId, 50 bool force, bool keep); 51 virtual void removeClient(const sp<ICameraClient>& cameraClient); 52 virtual sp<Client> getClientById(int cameraId); 53 54 virtual status_t dump(int fd, const Vector<String16>& args); 55 virtual status_t onTransact(uint32_t code, const Parcel& data, 56 Parcel* reply, uint32_t flags); 57 virtual void onFirstRef(); 58 59 enum sound_kind { 60 SOUND_SHUTTER = 0, 61 SOUND_RECORDING = 1, 62 NUM_SOUNDS 63 }; 64 65 void loadSound(); 66 void playSound(sound_kind kind); 67 void releaseSound(); 68 69private: 70 Mutex mServiceLock; 71 wp<Client> mClient[MAX_CAMERAS]; // protected by mServiceLock 72 int mNumberOfCameras; 73 74 // atomics to record whether the hardware is allocated to some client. 75 volatile int32_t mBusy[MAX_CAMERAS]; 76 void setCameraBusy(int cameraId); 77 void setCameraFree(int cameraId); 78 79 // sounds 80 MediaPlayer* newMediaPlayer(const char *file); 81 82 Mutex mSoundLock; 83 sp<MediaPlayer> mSoundPlayer[NUM_SOUNDS]; 84 int mSoundRef; // reference count (release all MediaPlayer when 0) 85 86 class Client : public BnCamera 87 { 88 public: 89 // ICamera interface (see ICamera for details) 90 virtual void disconnect(); 91 virtual status_t connect(const sp<ICameraClient>& client); 92 virtual status_t lock(); 93 virtual status_t unlock(); 94 virtual status_t setPreviewDisplay(const sp<Surface>& surface); 95 virtual status_t setPreviewTexture(const sp<ISurfaceTexture>& surfaceTexture); 96 virtual void setPreviewCallbackFlag(int flag); 97 virtual status_t startPreview(); 98 virtual void stopPreview(); 99 virtual bool previewEnabled(); 100 virtual status_t storeMetaDataInBuffers(bool enabled); 101 virtual status_t startRecording(); 102 virtual void stopRecording(); 103 virtual bool recordingEnabled(); 104 virtual void releaseRecordingFrame(const sp<IMemory>& mem); 105 virtual status_t autoFocus(); 106 virtual status_t cancelAutoFocus(); 107 virtual status_t takePicture(int msgType); 108 virtual status_t setParameters(const String8& params); 109 virtual String8 getParameters() const; 110 virtual status_t sendCommand(int32_t cmd, int32_t arg1, int32_t arg2); 111 private: 112 friend class CameraService; 113 Client(const sp<CameraService>& cameraService, 114 const sp<ICameraClient>& cameraClient, 115 const sp<CameraHardwareInterface>& hardware, 116 int cameraId, 117 int cameraFacing, 118 int clientPid, 119 bool keep); 120 ~Client(); 121 122 // return our camera client 123 const sp<ICameraClient>& getCameraClient() { return mCameraClient; } 124 125 // check whether the calling process matches mClientPid. 126 status_t checkPid() const; 127 status_t checkPidAndHardware() const; // also check mHardware != 0 128 129 // these are internal functions used to set up preview buffers 130 status_t registerPreviewBuffers(); 131 132 // camera operation mode 133 enum camera_mode { 134 CAMERA_PREVIEW_MODE = 0, // frame automatically released 135 CAMERA_RECORDING_MODE = 1, // frame has to be explicitly released by releaseRecordingFrame() 136 }; 137 // these are internal functions used for preview/recording 138 status_t startCameraMode(camera_mode mode); 139 status_t startPreviewMode(); 140 status_t startRecordingMode(); 141 142 // internal function used by sendCommand to enable/disable shutter sound. 143 status_t enableShutterSound(bool enable); 144 145 // these are static callback functions 146 static void notifyCallback(int32_t msgType, int32_t ext1, int32_t ext2, void* user); 147 static void dataCallback(int32_t msgType, const sp<IMemory>& dataPtr, 148 camera_frame_metadata_t *metadata, void* user); 149 static void dataCallbackTimestamp(nsecs_t timestamp, int32_t msgType, const sp<IMemory>& dataPtr, void* user); 150 // convert client from cookie 151 static sp<Client> getClientFromCookie(void* user); 152 // handlers for messages 153 void handleShutter(void); 154 void handlePreviewData(int32_t msgType, const sp<IMemory>& mem, 155 camera_frame_metadata_t *metadata); 156 void handlePostview(const sp<IMemory>& mem); 157 void handleRawPicture(const sp<IMemory>& mem); 158 void handleCompressedPicture(const sp<IMemory>& mem); 159 void handleGenericNotify(int32_t msgType, int32_t ext1, int32_t ext2); 160 void handleGenericData(int32_t msgType, const sp<IMemory>& dataPtr, 161 camera_frame_metadata_t *metadata); 162 void handleGenericDataTimestamp(nsecs_t timestamp, int32_t msgType, const sp<IMemory>& dataPtr); 163 164 void copyFrameAndPostCopiedFrame( 165 int32_t msgType, 166 const sp<ICameraClient>& client, 167 const sp<IMemoryHeap>& heap, 168 size_t offset, size_t size, 169 camera_frame_metadata_t *metadata); 170 171 int getOrientation(int orientation, bool mirror); 172 173 status_t setPreviewWindow( 174 const sp<IBinder>& binder, 175 const sp<ANativeWindow>& window); 176 177 void disconnectInternal(bool needCheckPid); 178 bool keep() const; 179 void waitRelease(int ms); 180 181 182 // these are initialized in the constructor. 183 sp<CameraService> mCameraService; // immutable after constructor 184 sp<ICameraClient> mCameraClient; 185 int mCameraId; // immutable after constructor 186 int mCameraFacing; // immutable after constructor 187 pid_t mClientPid; 188 // Client wants to keep the camera from taking by other clients. 189 bool mKeep; 190 sp<CameraHardwareInterface> mHardware; // cleared after disconnect() 191 int mPreviewCallbackFlag; 192 int mOrientation; // Current display orientation 193 bool mPlayShutterSound; 194 195 // Ensures atomicity among the public methods 196 mutable Mutex mLock; 197 // This will get notified when the hardware is released. 198 Condition mReleaseCondition; 199 // This is a binder of Surface or SurfaceTexture. 200 sp<IBinder> mSurface; 201 sp<ANativeWindow> mPreviewWindow; 202 203 // If the user want us to return a copy of the preview frame (instead 204 // of the original one), we allocate mPreviewBuffer and reuse it if possible. 205 sp<MemoryHeapBase> mPreviewBuffer; 206 207 // We need to avoid the deadlock when the incoming command thread and 208 // the CameraHardwareInterface callback thread both want to grab mLock. 209 // An extra flag is used to tell the callback thread that it should stop 210 // trying to deliver the callback messages if the client is not 211 // interested in it anymore. For example, if the client is calling 212 // stopPreview(), the preview frame messages do not need to be delivered 213 // anymore. 214 215 // This function takes the same parameter as the enableMsgType() and 216 // disableMsgType() functions in CameraHardwareInterface. 217 void enableMsgType(int32_t msgType); 218 void disableMsgType(int32_t msgType); 219 volatile int32_t mMsgEnabled; 220 221 // This function keeps trying to grab mLock, or give up if the message 222 // is found to be disabled. It returns true if mLock is grabbed. 223 bool lockIfMessageWanted(int32_t msgType); 224 }; 225 226 camera_module_t *mModule; 227}; 228 229} // namespace android 230 231#endif 232