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 23 #include <camera/ICameraService.h> 24 #include <camera/CameraHardwareInterface.h> 25 26 /* This needs to be increased if we can have more cameras */ 27 #define MAX_CAMERAS 2 28 29 namespace android { 30 31 class MemoryHeapBase; 32 class MediaPlayer; 33 34 class CameraService : 35 public BinderService<CameraService>, 36 public BnCameraService 37 { 38 class Client; 39 friend class BinderService<CameraService>; 40 public: getServiceName()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 virtual void removeClient(const sp<ICameraClient>& cameraClient); 51 virtual sp<Client> getClientById(int cameraId); 52 53 virtual status_t dump(int fd, const Vector<String16>& args); 54 virtual status_t onTransact(uint32_t code, const Parcel& data, 55 Parcel* reply, uint32_t flags); 56 57 enum sound_kind { 58 SOUND_SHUTTER = 0, 59 SOUND_RECORDING = 1, 60 NUM_SOUNDS 61 }; 62 63 void loadSound(); 64 void playSound(sound_kind kind); 65 void releaseSound(); 66 67 private: 68 Mutex mServiceLock; 69 wp<Client> mClient[MAX_CAMERAS]; // protected by mServiceLock 70 int mNumberOfCameras; 71 72 // atomics to record whether the hardware is allocated to some client. 73 volatile int32_t mBusy[MAX_CAMERAS]; 74 void setCameraBusy(int cameraId); 75 void setCameraFree(int cameraId); 76 77 // sounds 78 Mutex mSoundLock; 79 sp<MediaPlayer> mSoundPlayer[NUM_SOUNDS]; 80 int mSoundRef; // reference count (release all MediaPlayer when 0) 81 82 class Client : public BnCamera 83 { 84 public: 85 // ICamera interface (see ICamera for details) 86 virtual void disconnect(); 87 virtual status_t connect(const sp<ICameraClient>& client); 88 virtual status_t lock(); 89 virtual status_t unlock(); 90 virtual status_t setPreviewDisplay(const sp<ISurface>& surface); 91 virtual void setPreviewCallbackFlag(int flag); 92 virtual status_t startPreview(); 93 virtual void stopPreview(); 94 virtual bool previewEnabled(); 95 virtual status_t startRecording(); 96 virtual void stopRecording(); 97 virtual bool recordingEnabled(); 98 virtual void releaseRecordingFrame(const sp<IMemory>& mem); 99 virtual status_t autoFocus(); 100 virtual status_t cancelAutoFocus(); 101 virtual status_t takePicture(); 102 virtual status_t setParameters(const String8& params); 103 virtual String8 getParameters() const; 104 virtual status_t sendCommand(int32_t cmd, int32_t arg1, int32_t arg2); 105 private: 106 friend class CameraService; 107 Client(const sp<CameraService>& cameraService, 108 const sp<ICameraClient>& cameraClient, 109 const sp<CameraHardwareInterface>& hardware, 110 int cameraId, 111 int cameraFacing, 112 int clientPid); 113 ~Client(); 114 115 // return our camera client getCameraClient()116 const sp<ICameraClient>& getCameraClient() { return mCameraClient; } 117 118 // check whether the calling process matches mClientPid. 119 status_t checkPid() const; 120 status_t checkPidAndHardware() const; // also check mHardware != 0 121 122 // these are internal functions used to set up preview buffers 123 status_t registerPreviewBuffers(); 124 status_t setOverlay(); 125 126 // camera operation mode 127 enum camera_mode { 128 CAMERA_PREVIEW_MODE = 0, // frame automatically released 129 CAMERA_RECORDING_MODE = 1, // frame has to be explicitly released by releaseRecordingFrame() 130 }; 131 // these are internal functions used for preview/recording 132 status_t startCameraMode(camera_mode mode); 133 status_t startPreviewMode(); 134 status_t startRecordingMode(); 135 136 // these are static callback functions 137 static void notifyCallback(int32_t msgType, int32_t ext1, int32_t ext2, void* user); 138 static void dataCallback(int32_t msgType, const sp<IMemory>& dataPtr, void* user); 139 static void dataCallbackTimestamp(nsecs_t timestamp, int32_t msgType, const sp<IMemory>& dataPtr, void* user); 140 // convert client from cookie 141 static sp<Client> getClientFromCookie(void* user); 142 // handlers for messages 143 void handleShutter(image_rect_type *size); 144 void handlePreviewData(const sp<IMemory>& mem); 145 void handlePostview(const sp<IMemory>& mem); 146 void handleRawPicture(const sp<IMemory>& mem); 147 void handleCompressedPicture(const sp<IMemory>& mem); 148 void handleGenericNotify(int32_t msgType, int32_t ext1, int32_t ext2); 149 void handleGenericData(int32_t msgType, const sp<IMemory>& dataPtr); 150 void handleGenericDataTimestamp(nsecs_t timestamp, int32_t msgType, const sp<IMemory>& dataPtr); 151 152 void copyFrameAndPostCopiedFrame( 153 const sp<ICameraClient>& client, 154 const sp<IMemoryHeap>& heap, 155 size_t offset, size_t size); 156 157 int getOrientation(int orientation, bool mirror); 158 159 // these are initialized in the constructor. 160 sp<CameraService> mCameraService; // immutable after constructor 161 sp<ICameraClient> mCameraClient; 162 int mCameraId; // immutable after constructor 163 int mCameraFacing; // immutable after constructor 164 pid_t mClientPid; 165 sp<CameraHardwareInterface> mHardware; // cleared after disconnect() 166 bool mUseOverlay; // immutable after constructor 167 sp<OverlayRef> mOverlayRef; 168 int mOverlayW; 169 int mOverlayH; 170 int mPreviewCallbackFlag; 171 int mOrientation; // Current display orientation 172 // True if display orientation has been changed. This is only used in overlay. 173 int mOrientationChanged; 174 175 // Ensures atomicity among the public methods 176 mutable Mutex mLock; 177 sp<ISurface> mSurface; 178 179 // If the user want us to return a copy of the preview frame (instead 180 // of the original one), we allocate mPreviewBuffer and reuse it if possible. 181 sp<MemoryHeapBase> mPreviewBuffer; 182 183 // We need to avoid the deadlock when the incoming command thread and 184 // the CameraHardwareInterface callback thread both want to grab mLock. 185 // An extra flag is used to tell the callback thread that it should stop 186 // trying to deliver the callback messages if the client is not 187 // interested in it anymore. For example, if the client is calling 188 // stopPreview(), the preview frame messages do not need to be delivered 189 // anymore. 190 191 // This function takes the same parameter as the enableMsgType() and 192 // disableMsgType() functions in CameraHardwareInterface. 193 void enableMsgType(int32_t msgType); 194 void disableMsgType(int32_t msgType); 195 volatile int32_t mMsgEnabled; 196 197 // This function keeps trying to grab mLock, or give up if the message 198 // is found to be disabled. It returns true if mLock is grabbed. 199 bool lockIfMessageWanted(int32_t msgType); 200 }; 201 }; 202 203 } // namespace android 204 205 #endif 206