| /* |
| * Copyright (C) 2013 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. |
| */ |
| |
| package android.hardware.camera2.impl; |
| |
| import static android.hardware.camera2.CameraAccessException.CAMERA_IN_USE; |
| |
| import android.hardware.camera2.CameraAccessException; |
| import android.hardware.camera2.CameraMetadata; |
| import android.hardware.camera2.CameraCharacteristics; |
| import android.hardware.camera2.CaptureRequest; |
| import android.hardware.camera2.CaptureResult; |
| import android.hardware.camera2.ICameraDeviceCallbacks; |
| import android.hardware.camera2.ICameraDeviceUser; |
| import android.hardware.camera2.utils.CameraBinderDecorator; |
| import android.hardware.camera2.utils.CameraRuntimeException; |
| import android.os.IBinder; |
| import android.os.RemoteException; |
| import android.os.Handler; |
| import android.os.Looper; |
| import android.util.Log; |
| import android.util.SparseArray; |
| import android.view.Surface; |
| |
| import java.util.ArrayList; |
| import java.util.HashMap; |
| import java.util.HashSet; |
| import java.util.List; |
| import java.util.Stack; |
| |
| /** |
| * HAL2.1+ implementation of CameraDevice. Use CameraManager#open to instantiate |
| */ |
| public class CameraDevice implements android.hardware.camera2.CameraDevice { |
| |
| private final String TAG; |
| private final boolean DEBUG; |
| |
| // TODO: guard every function with if (!mRemoteDevice) check (if it was closed) |
| private ICameraDeviceUser mRemoteDevice; |
| |
| private final Object mLock = new Object(); |
| private final CameraDeviceCallbacks mCallbacks = new CameraDeviceCallbacks(); |
| |
| private StateListener mDeviceListener; |
| private Handler mDeviceHandler; |
| |
| private final SparseArray<CaptureListenerHolder> mCaptureListenerMap = |
| new SparseArray<CaptureListenerHolder>(); |
| |
| private final Stack<Integer> mRepeatingRequestIdStack = new Stack<Integer>(); |
| // Map stream IDs to Surfaces |
| private final SparseArray<Surface> mConfiguredOutputs = new SparseArray<Surface>(); |
| |
| private final String mCameraId; |
| |
| public CameraDevice(String cameraId) { |
| mCameraId = cameraId; |
| TAG = String.format("CameraDevice-%s-JV", mCameraId); |
| DEBUG = Log.isLoggable(TAG, Log.DEBUG); |
| } |
| |
| public CameraDeviceCallbacks getCallbacks() { |
| return mCallbacks; |
| } |
| |
| public void setRemoteDevice(ICameraDeviceUser remoteDevice) { |
| // TODO: Move from decorator to direct binder-mediated exceptions |
| mRemoteDevice = CameraBinderDecorator.newInstance(remoteDevice); |
| } |
| |
| @Override |
| public String getId() { |
| return mCameraId; |
| } |
| |
| @Override |
| public CameraCharacteristics getProperties() throws CameraAccessException { |
| |
| CameraMetadataNative info = new CameraMetadataNative(); |
| |
| try { |
| mRemoteDevice.getCameraInfo(/*out*/info); |
| } catch(CameraRuntimeException e) { |
| throw e.asChecked(); |
| } catch(RemoteException e) { |
| // impossible |
| return null; |
| } |
| |
| CameraCharacteristics properties = new CameraCharacteristics(info); |
| return properties; |
| } |
| |
| @Override |
| public void configureOutputs(List<Surface> outputs) throws CameraAccessException { |
| synchronized (mLock) { |
| HashSet<Surface> addSet = new HashSet<Surface>(outputs); // Streams to create |
| List<Integer> deleteList = new ArrayList<Integer>(); // Streams to delete |
| |
| // Determine which streams need to be created, which to be deleted |
| for (int i = 0; i < mConfiguredOutputs.size(); ++i) { |
| int streamId = mConfiguredOutputs.keyAt(i); |
| Surface s = mConfiguredOutputs.valueAt(i); |
| |
| if (!outputs.contains(s)) { |
| deleteList.add(streamId); |
| } else { |
| addSet.remove(s); // Don't create a stream previously created |
| } |
| } |
| |
| try { |
| // TODO: mRemoteDevice.beginConfigure |
| |
| // Delete all streams first (to free up HW resources) |
| for (Integer streamId : deleteList) { |
| mRemoteDevice.deleteStream(streamId); |
| mConfiguredOutputs.delete(streamId); |
| } |
| |
| // Add all new streams |
| for (Surface s : addSet) { |
| // TODO: remove width,height,format since we are ignoring |
| // it. |
| int streamId = mRemoteDevice.createStream(0, 0, 0, s); |
| mConfiguredOutputs.put(streamId, s); |
| } |
| |
| // TODO: mRemoteDevice.endConfigure |
| } catch (CameraRuntimeException e) { |
| if (e.getReason() == CAMERA_IN_USE) { |
| throw new IllegalStateException("The camera is currently busy." + |
| " You must call waitUntilIdle before trying to reconfigure."); |
| } |
| |
| throw e.asChecked(); |
| } catch (RemoteException e) { |
| // impossible |
| return; |
| } |
| } |
| } |
| |
| @Override |
| public CaptureRequest.Builder createCaptureRequest(int templateType) |
| throws CameraAccessException { |
| synchronized (mLock) { |
| |
| CameraMetadataNative templatedRequest = new CameraMetadataNative(); |
| |
| try { |
| mRemoteDevice.createDefaultRequest(templateType, /* out */templatedRequest); |
| } catch (CameraRuntimeException e) { |
| throw e.asChecked(); |
| } catch (RemoteException e) { |
| // impossible |
| return null; |
| } |
| |
| CaptureRequest.Builder builder = |
| new CaptureRequest.Builder(templatedRequest); |
| |
| return builder; |
| } |
| } |
| |
| @Override |
| public int capture(CaptureRequest request, CaptureListener listener, Handler handler) |
| throws CameraAccessException { |
| return submitCaptureRequest(request, listener, handler, /*streaming*/false); |
| } |
| |
| @Override |
| public int captureBurst(List<CaptureRequest> requests, CaptureListener listener, |
| Handler handler) throws CameraAccessException { |
| if (requests.isEmpty()) { |
| Log.w(TAG, "Capture burst request list is empty, do nothing!"); |
| return -1; |
| } |
| // TODO |
| throw new UnsupportedOperationException("Burst capture implemented yet"); |
| |
| } |
| |
| private int submitCaptureRequest(CaptureRequest request, CaptureListener listener, |
| Handler handler, boolean repeating) throws CameraAccessException { |
| |
| // Need a valid handler, or current thread needs to have a looper, if |
| // listener is valid |
| if (handler == null && listener != null) { |
| Looper looper = Looper.myLooper(); |
| if (looper == null) { |
| throw new IllegalArgumentException( |
| "No handler given, and current thread has no looper!"); |
| } |
| handler = new Handler(looper); |
| } |
| |
| synchronized (mLock) { |
| |
| int requestId; |
| |
| try { |
| requestId = mRemoteDevice.submitRequest(request, repeating); |
| } catch (CameraRuntimeException e) { |
| throw e.asChecked(); |
| } catch (RemoteException e) { |
| // impossible |
| return -1; |
| } |
| if (listener != null) { |
| mCaptureListenerMap.put(requestId, new CaptureListenerHolder(listener, request, |
| handler, repeating)); |
| } |
| |
| if (repeating) { |
| mRepeatingRequestIdStack.add(requestId); |
| } |
| |
| return requestId; |
| } |
| } |
| |
| @Override |
| public int setRepeatingRequest(CaptureRequest request, CaptureListener listener, |
| Handler handler) throws CameraAccessException { |
| return submitCaptureRequest(request, listener, handler, /*streaming*/true); |
| } |
| |
| @Override |
| public int setRepeatingBurst(List<CaptureRequest> requests, CaptureListener listener, |
| Handler handler) throws CameraAccessException { |
| if (requests.isEmpty()) { |
| Log.w(TAG, "Set Repeating burst request list is empty, do nothing!"); |
| return -1; |
| } |
| // TODO |
| throw new UnsupportedOperationException("Burst capture implemented yet"); |
| } |
| |
| @Override |
| public void stopRepeating() throws CameraAccessException { |
| |
| synchronized (mLock) { |
| |
| while (!mRepeatingRequestIdStack.isEmpty()) { |
| int requestId = mRepeatingRequestIdStack.pop(); |
| |
| try { |
| mRemoteDevice.cancelRequest(requestId); |
| } catch (CameraRuntimeException e) { |
| throw e.asChecked(); |
| } catch (RemoteException e) { |
| // impossible |
| return; |
| } |
| } |
| } |
| } |
| |
| @Override |
| public void waitUntilIdle() throws CameraAccessException { |
| |
| synchronized (mLock) { |
| checkIfCameraClosed(); |
| if (!mRepeatingRequestIdStack.isEmpty()) { |
| throw new IllegalStateException("Active repeating request ongoing"); |
| } |
| |
| try { |
| mRemoteDevice.waitUntilIdle(); |
| } catch (CameraRuntimeException e) { |
| throw e.asChecked(); |
| } catch (RemoteException e) { |
| // impossible |
| return; |
| } |
| } |
| } |
| |
| @Override |
| public void setDeviceListener(StateListener listener, Handler handler) { |
| synchronized (mLock) { |
| mDeviceListener = listener; |
| mDeviceHandler = handler; |
| } |
| } |
| |
| @Override |
| public void flush() throws CameraAccessException { |
| synchronized (mLock) { |
| try { |
| mRemoteDevice.flush(); |
| } catch (CameraRuntimeException e) { |
| throw e.asChecked(); |
| } catch (RemoteException e) { |
| // impossible |
| return; |
| } |
| } |
| } |
| |
| @Override |
| public void close() { |
| |
| // TODO: every method should throw IllegalStateException after close has been called |
| |
| synchronized (mLock) { |
| |
| try { |
| if (mRemoteDevice != null) { |
| mRemoteDevice.disconnect(); |
| } |
| } catch (CameraRuntimeException e) { |
| Log.e(TAG, "Exception while closing: ", e.asChecked()); |
| } catch (RemoteException e) { |
| // impossible |
| } |
| |
| mRemoteDevice = null; |
| |
| } |
| } |
| |
| @Override |
| protected void finalize() throws Throwable { |
| try { |
| close(); |
| } |
| finally { |
| super.finalize(); |
| } |
| } |
| |
| static class CaptureListenerHolder { |
| |
| private final boolean mRepeating; |
| private final CaptureListener mListener; |
| private final CaptureRequest mRequest; |
| private final Handler mHandler; |
| |
| CaptureListenerHolder(CaptureListener listener, CaptureRequest request, Handler handler, |
| boolean repeating) { |
| if (listener == null || handler == null) { |
| throw new UnsupportedOperationException( |
| "Must have a valid handler and a valid listener"); |
| } |
| mRepeating = repeating; |
| mHandler = handler; |
| mRequest = request; |
| mListener = listener; |
| } |
| |
| public boolean isRepeating() { |
| return mRepeating; |
| } |
| |
| public CaptureListener getListener() { |
| return mListener; |
| } |
| |
| public CaptureRequest getRequest() { |
| return mRequest; |
| } |
| |
| public Handler getHandler() { |
| return mHandler; |
| } |
| |
| } |
| |
| // TODO: unit tests |
| public class CameraDeviceCallbacks extends ICameraDeviceCallbacks.Stub { |
| |
| @Override |
| public IBinder asBinder() { |
| return this; |
| } |
| |
| // TODO: consider rename to onMessageReceived |
| @Override |
| public void notifyCallback(int msgType, int ext1, int ext2) throws RemoteException { |
| if (DEBUG) { |
| Log.d(TAG, "Got message " + msgType + " ext1: " + ext1 + " , ext2: " + ext2); |
| } |
| // TODO implement rest |
| } |
| |
| @Override |
| public void onResultReceived(int requestId, CameraMetadataNative result) |
| throws RemoteException { |
| if (DEBUG) { |
| Log.d(TAG, "Received result for id " + requestId); |
| } |
| final CaptureListenerHolder holder; |
| |
| synchronized (mLock) { |
| // TODO: move this whole map into this class to make it more testable, |
| // exposing the methods necessary like subscribeToRequest, unsubscribe.. |
| // TODO: make class static class |
| |
| holder = CameraDevice.this.mCaptureListenerMap.get(requestId); |
| |
| // Clean up listener once we no longer expect to see it. |
| |
| // TODO: how to handle repeating listeners? |
| // we probably want cancelRequest to return # of times it already enqueued and |
| // keep a counter. |
| if (holder != null && !holder.isRepeating()) { |
| CameraDevice.this.mCaptureListenerMap.remove(requestId); |
| } |
| } |
| |
| // Check if we have a listener for this |
| if (holder == null) { |
| return; |
| } |
| |
| final CaptureRequest request = holder.getRequest(); |
| final CaptureResult resultAsCapture = new CaptureResult(result, request, requestId); |
| |
| holder.getHandler().post( |
| new Runnable() { |
| @Override |
| public void run() { |
| holder.getListener().onCaptureCompleted( |
| CameraDevice.this, |
| request, |
| resultAsCapture); |
| } |
| }); |
| } |
| |
| } |
| |
| private void checkIfCameraClosed() { |
| if (mRemoteDevice == null) { |
| throw new IllegalStateException("CameraDevice was already closed"); |
| } |
| } |
| } |