blob: 9cba2f1b9085ac745a88bab2d5ec37f0d731a342 [file] [log] [blame]
Igor Murashkin44cfcf02013-03-01 16:22:28 -08001/*
2 * Copyright (C) 2013 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 ANDROID_SERVERS_CAMERA_CAMERA2CLIENT_BASE_H
18#define ANDROID_SERVERS_CAMERA_CAMERA2CLIENT_BASE_H
19
Eino-Ville Talvala7b82efe2013-07-25 17:12:35 -070020#include "common/CameraDeviceBase.h"
Jianing Weicb0652e2014-03-12 18:29:36 -070021#include "camera/CaptureResult.h"
Igor Murashkin44cfcf02013-03-01 16:22:28 -080022
23namespace android {
24
25class IMemory;
26
Eino-Ville Talvala7b82efe2013-07-25 17:12:35 -070027class CameraService;
28
Igor Murashkin44cfcf02013-03-01 16:22:28 -080029template <typename TClientBase>
30class Camera2ClientBase :
31 public TClientBase,
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -080032 public NotificationListener
Igor Murashkin44cfcf02013-03-01 16:22:28 -080033{
34public:
35 typedef typename TClientBase::TCamCallbacks TCamCallbacks;
36
37 /**
Ruben Brunk9efdf952015-03-18 23:11:57 -070038 * Base binder interface (see ICamera/ICameraDeviceUser for details)
Igor Murashkin44cfcf02013-03-01 16:22:28 -080039 */
Eino-Ville Talvalad56db1d2015-12-17 16:50:35 -080040 virtual status_t connect(const sp<TCamCallbacks>& callbacks);
41 virtual binder::Status disconnect();
Igor Murashkin44cfcf02013-03-01 16:22:28 -080042
43 /**
44 * Interface used by CameraService
45 */
46
47 // TODO: too many params, move into a ClientArgs<T>
48 Camera2ClientBase(const sp<CameraService>& cameraService,
49 const sp<TCamCallbacks>& remoteCallback,
50 const String16& clientPackageName,
Jayant Chowdharyeb0169f2022-01-31 00:00:02 -080051 bool systemNativeClient,
Jooyung Han3f9a3b42020-01-23 12:27:18 +090052 const std::optional<String16>& clientFeatureId,
Eino-Ville Talvala2f09bac2016-12-13 11:29:54 -080053 const String8& cameraId,
Yin-Chia Yehc3e9d6f2018-02-06 10:56:32 -080054 int api1CameraId,
Igor Murashkin44cfcf02013-03-01 16:22:28 -080055 int cameraFacing,
Emilian Peev8b64f282021-03-25 16:49:57 -070056 int sensorOrientation,
Igor Murashkin44cfcf02013-03-01 16:22:28 -080057 int clientPid,
58 uid_t clientUid,
Shuzhen Wangd4abdf72021-05-28 11:22:50 -070059 int servicePid,
Emilian Peev5104fe92021-10-21 14:27:09 -070060 bool overrideForPerfClass,
61 bool legacyClient = false);
Igor Murashkin44cfcf02013-03-01 16:22:28 -080062 virtual ~Camera2ClientBase();
63
Emilian Peevbd8c5032018-02-14 23:05:40 +000064 virtual status_t initialize(sp<CameraProviderManager> manager, const String8& monitorTags);
Eino-Ville Talvalac4003962016-01-13 10:07:04 -080065 virtual status_t dumpClient(int fd, const Vector<String16>& args);
Avichal Rakesh7e53cad2021-10-05 13:46:30 -070066 virtual status_t startWatchingTags(const String8 &tags, int out);
67 virtual status_t stopWatchingTags(int out);
68 virtual status_t dumpWatchedEventsToVector(std::vector<std::string> &out);
Igor Murashkin44cfcf02013-03-01 16:22:28 -080069
70 /**
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -080071 * NotificationListener implementation
Igor Murashkin44cfcf02013-03-01 16:22:28 -080072 */
73
Eino-Ville Talvalad56db1d2015-12-17 16:50:35 -080074 virtual void notifyError(int32_t errorCode,
Jianing Weicb0652e2014-03-12 18:29:36 -070075 const CaptureResultExtras& resultExtras);
Austin Borger4a870a32022-02-25 01:48:41 +000076 // Returns errors on app ops permission failures
77 virtual status_t notifyActive(float maxPreviewFps);
Shuzhen Wangd26b1862022-03-07 12:05:05 -080078 virtual void notifyIdle(int64_t /*requestCount*/, int64_t /*resultErrorCount*/,
79 bool /*deviceError*/,
80 const std::vector<hardware::CameraStreamStats>&) {}
Jianing Weicb0652e2014-03-12 18:29:36 -070081 virtual void notifyShutter(const CaptureResultExtras& resultExtras,
82 nsecs_t timestamp);
Igor Murashkin44cfcf02013-03-01 16:22:28 -080083 virtual void notifyAutoFocus(uint8_t newState, int triggerId);
84 virtual void notifyAutoExposure(uint8_t newState, int triggerId);
85 virtual void notifyAutoWhitebalance(uint8_t newState,
86 int triggerId);
Eino-Ville Talvala4d44cad2015-04-11 13:15:45 -070087 virtual void notifyPrepared(int streamId);
Shuzhen Wang9d066012016-09-30 11:30:20 -070088 virtual void notifyRequestQueueEmpty();
Chien-Yu Chene8c535e2016-04-14 12:18:26 -070089 virtual void notifyRepeatingRequestError(long lastFrameNumber);
Igor Murashkin44cfcf02013-03-01 16:22:28 -080090
Shuzhen Wangd26b1862022-03-07 12:05:05 -080091 void notifyIdleWithUserTag(int64_t requestCount, int64_t resultErrorCount,
92 bool deviceError,
93 const std::vector<hardware::CameraStreamStats>& streamStats,
94 const std::string& userTag);
95
Igor Murashkin44cfcf02013-03-01 16:22:28 -080096 int getCameraId() const;
97 const sp<CameraDeviceBase>&
98 getCameraDevice();
Yin-Chia Yehcd8fce82014-06-18 10:51:34 -070099 int getCameraDeviceVersion() const;
Igor Murashkin44cfcf02013-03-01 16:22:28 -0800100 const sp<CameraService>&
101 getCameraService();
102
103 /**
104 * Interface used by independent components of CameraClient2Base.
105 */
106
107 // Simple class to ensure that access to TCamCallbacks is serialized
108 // by requiring mRemoteCallbackLock to be locked before access to
109 // mRemoteCallback is possible.
110 class SharedCameraCallbacks {
111 public:
112 class Lock {
113 public:
Chih-Hung Hsieh8b0b9712016-08-09 14:25:53 -0700114 explicit Lock(SharedCameraCallbacks &client);
Igor Murashkin44cfcf02013-03-01 16:22:28 -0800115 ~Lock();
116 sp<TCamCallbacks> &mRemoteCallback;
117 private:
118 SharedCameraCallbacks &mSharedClient;
119 };
Chih-Hung Hsieh8b0b9712016-08-09 14:25:53 -0700120 explicit SharedCameraCallbacks(const sp<TCamCallbacks>& client);
Igor Murashkin44cfcf02013-03-01 16:22:28 -0800121 SharedCameraCallbacks& operator=(const sp<TCamCallbacks>& client);
122 void clear();
123 private:
124 sp<TCamCallbacks> mRemoteCallback;
125 mutable Mutex mRemoteCallbackLock;
126 } mSharedCameraCallbacks;
127
Cliff Wud3a05312021-04-26 23:07:31 +0800128 status_t injectCamera(const String8& injectedCamId,
129 sp<CameraProviderManager> manager) override;
130 status_t stopInjection() override;
131
Igor Murashkin44cfcf02013-03-01 16:22:28 -0800132protected:
133
Eino-Ville Talvalab9d2f332014-09-18 17:24:22 -0700134 // The PID provided in the constructor call
135 pid_t mInitialClientPid;
Jayant Chowdhary22441f32021-12-26 18:35:41 -0800136 bool mOverrideForPerfClass = false;
137 bool mLegacyClient = false;
Eino-Ville Talvalab9d2f332014-09-18 17:24:22 -0700138
Igor Murashkine7ee7632013-06-11 18:10:18 -0700139 virtual sp<IBinder> asBinderWrapper() {
Marco Nelissen06b46062014-11-14 07:58:25 -0800140 return IInterface::asBinder(this);
Igor Murashkine7ee7632013-06-11 18:10:18 -0700141 }
142
Igor Murashkin44cfcf02013-03-01 16:22:28 -0800143 virtual status_t dumpDevice(int fd, const Vector<String16>& args);
144
145 /** Binder client interface-related private members */
146
147 // Mutex that must be locked by methods implementing the binder client
148 // interface. Ensures serialization between incoming client calls.
149 // All methods in this class hierarchy that append 'L' to the name assume
150 // that mBinderSerializationLock is locked when they're called
151 mutable Mutex mBinderSerializationLock;
152
Eino-Ville Talvalad309fb92015-11-25 12:12:45 -0800153 /** CameraDeviceBase instance wrapping HAL3+ entry */
Igor Murashkin44cfcf02013-03-01 16:22:28 -0800154
Yin-Chia Yehcd8fce82014-06-18 10:51:34 -0700155 const int mDeviceVersion;
Yin-Chia Yehc5248132018-08-15 12:19:20 -0700156
Jayant Chowdhary22441f32021-12-26 18:35:41 -0800157 // Note: This was previously set to const to avoid mDevice being updated -
158 // b/112639939 (update of sp<> is racy) during dumpDevice (which is important to be lock free
159 // for debugging purpose). The const has been removed since CameraDeviceBase
160 // needs to be set during initializeImpl(). This must not be set / cleared
161 // anywhere else.
162 sp<CameraDeviceBase> mDevice;
Igor Murashkin44cfcf02013-03-01 16:22:28 -0800163
164 /** Utility members */
165
166 // Verify that caller is the owner of the camera
167 status_t checkPid(const char *checkLocation) const;
168
169 virtual void detachDevice();
Eino-Ville Talvala412fe562015-08-20 17:08:32 -0700170
171 bool mDeviceActive;
Eino-Ville Talvala2f09bac2016-12-13 11:29:54 -0800172
Yin-Chia Yehc3e9d6f2018-02-06 10:56:32 -0800173 const int mApi1CameraId; // -1 if client is API2
174
Eino-Ville Talvala2f09bac2016-12-13 11:29:54 -0800175private:
176 template<typename TProviderPtr>
Emilian Peevbd8c5032018-02-14 23:05:40 +0000177 status_t initializeImpl(TProviderPtr providerPtr, const String8& monitorTags);
Igor Murashkin44cfcf02013-03-01 16:22:28 -0800178};
179
180}; // namespace android
181
182#endif