1.概述
本文将仿照此前博文Android NDK Camera2小结的方式，来记录Camera1的使用。
Camera1仅为Java实现（不必纠结于此，Native实现...JNI反调...你懂的~且性能差别不大）。
本文的讲解基于UML Component图，描述Camera1核心对象及API的调用生成关系。如缩略图不清晰，可点击放大。
Component图中，模块为函数，节点为对象。横向（左或右）箭头为资源释放操作调用。调用过程与顺序/时机无关。
其中绿色模块为Camera对象成员方法，黄色为Camera类静态方法。
粉色为Camera.Parameters对象成员方法。
红色为自定义方法，需要自行实现。
Component图未包含所有接口，仅为Camera1预览模式的简单实现。
2.Camera1的使用
相比于Camera2的复杂架构，Camera1（android.hardware.Camera）十分简单，仅为一个类文件。因此，操作也即为简便。
遵循以下步骤便可完成预览。
2.1获取Camera数量
使用静态方法Camera.getNumberOfCameras，获取camera数量num。Camera ID范围为【0，num-1】。
int cameraCount = Camera.getNumberOfCameras();
2.2获取CameraInfo
以Camera ID作为传参，调用静态方法Camera.getCameraInfo，获取对应CameraInfo。CameraInfo仅包括三项，Facing(镜头方向，前置/后置)，orientation（镜头旋转角度）和canDisableShutterSound（是否支持取消快门声音）。
通常通过CameraInfo，来确定要使用的Camera。
for (int i = 0; i < cameraCount; i++) {
Camera.CameraInfo cameraInfo = new Camera.CameraInfo();
Camera.getCameraInfo(i, cameraInfo);
}
2.3开启Camera
以Camera ID作为传参，调用静态方法Camera.open即可打开设备，该方法将返回一个Camera对象。但打开设备，并不代表能够看到画面。仍需要后续操作，来完成预览。包括设置Camera.Parameters，以及画布（surface View）。若需要使用图片数据，则需要设置Callback接口。
Camera camera = Camera.open(cameraId);
2.4设置Camera配置参数
获取Camera对象后，调用成员方法getParameters，可以获取Camera.Parameters。Camera.Parameters中包含的信息，要远多于CameraInfo。在获取Camera.Parameters后，可以调用成员方法getSupportedXXXX来获取相应的数据。例如分辨率，预览格式等。
对于分辨率，可以调用Camera.Parameters成员方法getSupportedPreviewSizes，获取List<Camera.Size>。设置则是调用Camera.Parameters成员方法setPreviewSize。
Camera.Parameters params = camera.getParameters();
List<Camera.Size> supportSizes = params.getSupportedPreviewSizes();
...
mParams.setPreviewSize(width, height);
对于预览格式，可以调用Camera.Parameters成员方法getSupportedPreviewFormats，获取List<Integer>。设置则是调用setPreviewFormat。由于前端为视频流，因此，通常使用PixelFormat.YCbCr_420_SP。
parameters.setPreviewFormat(PixelFormat.YCbCr_420_SP);
当然，还有其它一些参数可以设置，例如曝光补偿（可参照关于Android Camera的曝光补偿），焦距（可参照关于Android Camera变焦）等。
List<Integer> zoomRatios =parameters.getZoomRatios();
int MAX_ZOOM = mParams.getMaxZoom();
int tMaxExposure=parameters.getMaxExposureCompensation();
int tMinExposure=parameters.getMinExposureCompensation();
...
mParams.setZoom(currentZoom);
parameters.setExposureCompensation(mExposureCompensationRate);
在设置完Camera.Parameters子项后，需要将其回填给Camera，需要调用Camera成员方法setParameters。
mCamera.setParameters(mParams);
2.5设置预览界面
surface view为Camera的画布，仅需将其SurfaceHolder作为传参，调用Camera的成员方法setPreviewDisplay即可完成预览界面设置。
SurfaceHolder holder;
...
mCamera.setPreviewDisplay(holder);
2.6预览画面矫正
通过用Camera的成员方法setDisplayOrientation调设置画面的矫正角度，使得画面以自然0度显示在画布上。通常使用角度为0，90，180，270。关于android设备的角度问题，将另辟博文描述。
mCamera.setDisplayOrientation(90);
2.7设置previewCallback
如果想获取图像数据，则需要通过调用Camera的成员方法setPreviewCallback添加Callback方法。默认返回为YCbCr_420_SP格式的数据。
PreviewCallback mpreview = new PreviewCallback() {
public void onPreviewFrame(byte[] data, Camera camera) {
}
};
mCamera.setPreviewCallback(mpreview);
public interface PreviewCallback
{
/**
* Called as preview frames are displayed. This callback is invoked
* on the event thread {@link #open(int)} was called from.
*
* <p>If using the {@link android.graphics.ImageFormat#YV12} format,
* refer to the equations in {@link Camera.Parameters#setPreviewFormat}
* for the arrangement of the pixel data in the preview callback
* buffers.
*
* @param data the contents of the preview frame in the format defined
* by {@link android.graphics.ImageFormat}, which can be queried
* with {@link android.hardware.Camera.Parameters#getPreviewFormat()}.
* If {@link android.hardware.Camera.Parameters#setPreviewFormat(int)}
* is never called, the default will be the YCbCr_420_SP
* (NV21) format.
* @param camera the Camera service object.
*/
void onPreviewFrame(byte[] data, Camera camera);
};
2.8启动预览
完成相关设置后，仅需调用Camera成员方法startPreview即可。
mCamera.startPreview();
2.9停止预览
调用Camera成员方法stopPreview即可。
mCamera.stopPreview()
2.10关闭相机
调用Camera成员方法release即可。
mCamera.release();
3.结束语
Android Camera2 Java实现始于andorid 5.0, Native 实现则开始于android7.0（API level24）。
到目前为止，5.0以上系统市场占有率为85%，7.0以上系统仅为37%，因此，Camera2不足以适配所有Android 设备。
所以，Camera1虽然最终将被替代，但仍有存在价值。Camera1仅为单个类，没有Camera2复杂的结构，并且java实现还是相对简单实用。在不考虑被遗弃的情况，Camera1还是更为通用。