一、前言
Android自定义相机开发中，常常会有通过手势放大或缩小相机预览画面的需求，即数码变焦DigitalZoom。
二、接口说明
1. 获取最大的放大倍数
float maxZoom = mCameraCharacteristics.get(CameraCharacteristics.SCALER_AVAILABLE_MAX_DIGITAL_ZOOM);
怎么理解这个值呢？
假设正常预览画面（即没有缩放）矩形为 activity_rect，放大后的预览画面矩形为 crop_rect，那么它们宽高的比值最大就只能为maxZoom，例如我测试中获取的该值为 10.0。（PS：activity_rect的宽高为分子，crop_rect的宽高是分母）
2. 获取未缩放的正常预览画面大小
Rect rect = mCameraCharacteristics.get(CameraCharacteristics.SENSOR_INFO_ACTIVE_ARRAY_SIZE);
这个大小要用来计算我们最终放大后显示的画面大小。
3. 相机预览请求构造者设置显示的画面区域
mPreviewRequestBuilder.set(CaptureRequest.SCALER_CROP_REGION, zoomRect);
计算得到的 zoomRect，通过上述接口设置给预览。
关于 SCALER_CROP_REGION ，详情可以参考：/reference/android/hardware/camera2/CaptureRequest#SCALER_CROP_REGION
三、代码实现
1. 相机View处理触碰事件
private float mOldDistance;@Overridepublic boolean onTouchEvent(MotionEvent event) {if (event.getPointerCount() == 2) {// 当触碰点有2个时，才去放大缩小switch (event.getAction() & MotionEvent.ACTION_MASK) {case MotionEvent.ACTION_POINTER_DOWN:// 点下时，得到两个点间的距离为mOldDistancemOldDistance = getFingerSpacing(event);break;case MotionEvent.ACTION_MOVE:// 移动时，根据距离是变大还是变小，去放大还是缩小预览画面float newDistance = getFingerSpacing(event);if (newDistance > mOldDistance) {mCameraProxy.handleZoom(true);} else if (newDistance < mOldDistance) {mCameraProxy.handleZoom(false);}// 更新mOldDistancemOldDistance = newDistance;break;default:break;}}return super.onTouchEvent(event);}private static float getFingerSpacing(MotionEvent event) {float x = event.getX(0) - event.getX(1);float y = event.getY(0) - event.getY(1);return (float) Math.sqrt(x * x + y * y);}
上面我们只处理了触碰事件，预览放大或缩小的逻辑由 mCameraProxy 的handleZoom(boolean isZoomIn)实现。
2. handleZoom() 实现
private final int MAX_ZOOM = 100; // 放大的最大值，用于计算每次放大/缩小操作改变的大小private int mZoom = 0; // 缩放private float mStepWidth; // 每次改变的宽度大小private float mStepHeight; // 每次改变的高度大小// 每次切换摄像头计算一次就行，结果缓存到成员变量中private void initZoomParameter() {Rect rect = mCameraCharacteristics.get(CameraCharacteristics.SENSOR_INFO_ACTIVE_ARRAY_SIZE);Log.d(TAG, "sensor_info_active_array_size: " + rect);// max_digital_zoom 表示 active_rect 除以 crop_rect 的最大值float max_digital_zoom = mCameraCharacteristics.get(CameraCharacteristics.SCALER_AVAILABLE_MAX_DIGITAL_ZOOM);Log.d(TAG, "max_digital_zoom: " + max_digital_zoom);// crop_rect的最小宽高float minWidth = rect.width() / max_digital_zoom;float minHeight = rect.height() / max_digital_zoom;// 因为缩放时两边都要变化，所以要除以2mStepWidth = (rect.width() - minWidth) / MAX_ZOOM / 2;mStepHeight = (rect.height() - minHeight) / MAX_ZOOM / 2;}public void handleZoom(boolean isZoomIn) {if (mCameraDevice == null || mCameraCharacteristics == null || mPreviewRequestBuilder == null) {return;}if (isZoomIn && mZoom < MAX_ZOOM) {// 放大mZoom++;} else if (mZoom > 0) {// 缩小mZoom--;}Log.v(TAG, "handleZoom: mZoom: " + mZoom);Rect rect = mCameraCharacteristics.get(CameraCharacteristics.SENSOR_INFO_ACTIVE_ARRAY_SIZE);int cropW = (int) (mStepWidth * mZoom);int cropH = (int) (mStepHeight * mZoom);Rect zoomRect = new Rect(rect.left + cropW, rect.top + cropH, rect.right - cropW, rect.bottom - cropH);Log.d(TAG, "zoomRect: " + zoomRect);mPreviewRequestBuilder.set(CaptureRequest.SCALER_CROP_REGION, zoomRect);startPreview(); // 需要重新 start preview 才能生效}
再简单说明一下上面的代码，因为本身maxZoom的值并不会很大，如果直接使用 1~maxZoom 的 int 值去放大缩小，画面变化就很剧烈，所以设置了一个MAX_ZOOM = 100去把这个过程划分成了100份，这个值可以自己设定。所以 mZoom 的判定范围也就变成了 0~MAX_ZOOM 。
再说计算 mStepWidth 和 mStepHeight 的代码。原Rect的宽是rect.width()，放大到最大时 zoomRect 的宽是rect.width() / maxZoom，因为有左右两边，所以它们的差值需要除以2，然后划分成 MAX_ZOOM 份，需要再除以 MAX_ZOOM 。
最后，放大时我们让 mZoom 自增1，缩小时让 mZoom 自减1，根据 mZoom 就可以得到剪裁的宽高大大小了。
四、工程地址
完整的代码可见：
/afei-cn/CameraDemo/blob/master/app/src/main/java/com/afei/camerademo/camera/Camera2Proxy.java
相关使用实例可见：
自定义Camera系列之：SurfaceView + Camera2
自定义Camera系列之：TextureView + Camera2
自定义Camera系列之：GLSurfaceView + Camera2
