CameraScan for Android 是一个简化扫描识别流程的通用基础库

/* * Copyright (C) Jenly, CameraScan 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 com.king.camera.scan; import android.annotation.SuppressLint; import android.content.Context; import android.content.pm.PackageManager; import android.view.MotionEvent; import android.view.ScaleGestureDetector; import android.view.View; import androidx.annotation.FloatRange; import androidx.annotation.NonNull; import androidx.annotation.Nullable; import androidx.camera.core.Camera; import androidx.camera.core.CameraInfo; import androidx.camera.core.CameraSelector; import androidx.camera.core.FocusMeteringAction; import androidx.camera.core.ImageAnalysis; import androidx.camera.core.MeteringPoint; import androidx.camera.core.Preview; import androidx.camera.core.TorchState; import androidx.camera.core.ZoomState; import androidx.camera.lifecycle.ProcessCameraProvider; import androidx.camera.view.PreviewView; import androidx.core.app.ComponentActivity; import androidx.core.content.ContextCompat; import androidx.fragment.app.Fragment; import androidx.lifecycle.LifecycleOwner; import androidx.lifecycle.MutableLiveData; import com.google.common.util.concurrent.ListenableFuture; import com.king.camera.scan.analyze.Analyzer; import com.king.camera.scan.config.CameraConfig; import com.king.camera.scan.config.CameraConfigFactory; import com.king.camera.scan.manager.AmbientLightManager; import com.king.camera.scan.manager.BeepManager; import com.king.camera.scan.util.LogUtils; import java.util.concurrent.Executors; /** * 相机扫描基类；{@link BaseCameraScan} 为 {@link CameraScan} 的默认实现 * <p> * 快速实现扫描识别主要有以下几种方式： * <p> * 1、通过继承 {@link BaseCameraScanActivity}或者{@link BaseCameraScanFragment}或其子类，可快速实现扫描识别。 * （适用于大多数场景，自定义布局时需覆写getLayoutId方法） * <p> * 2、在你项目的Activity或者Fragment中实例化一个{@link BaseCameraScan}。（适用于想在扫描界面写交互逻辑，又因为项目 * 架构或其它原因，无法直接或间接继承{@link BaseCameraScanActivity}或{@link BaseCameraScanFragment}时使用） * <p> * 3、继承{@link CameraScan}自己实现一个，可参照默认实现类{@link BaseCameraScan}，其他步骤同方式2。（高级用法，谨慎使用） * * @author <a href="mailto:jenly1314@gmail.com">Jenly</a> * <p> * <a href="https://github.com/jenly1314">Follow me</a> */ public class BaseCameraScan<T> extends CameraScan<T> { /** * Defines the maximum duration in milliseconds between a touch pad * touch and release for a given touch to be considered a tap (click) as * opposed to a hover movement gesture. */ private static final int HOVER_TAP_TIMEOUT = 150; /** * Defines the maximum distance in pixels that a touch pad touch can move * before being released for it to be considered a tap (click) as opposed * to a hover movement gesture. */ private static final int HOVER_TAP_SLOP = 20; /** * 每次缩放改变的步长 */ private static final float ZOOM_STEP_SIZE = 0.1F; private Context mContext; private LifecycleOwner mLifecycleOwner; /** * 预览视图 */ private PreviewView mPreviewView; private ListenableFuture<ProcessCameraProvider> mCameraProviderFuture; /** * 相机 */ private Camera mCamera; /** * 相机配置 */ private CameraConfig mCameraConfig; /** * 分析器 */ private Analyzer<T> mAnalyzer; /** * 是否分析 */ private volatile boolean isAnalyze = true; /** * 是否已经分析出结果 */ private volatile boolean isAnalyzeResult; /** * 闪光灯（手电筒）视图 */ private View flashlightView; /** * 分析结果 */ private MutableLiveData<AnalyzeResult<T>> mResultLiveData; /** * 扫描结果回调 */ private OnScanResultCallback mOnScanResultCallback; /** * 分析监听器 */ private Analyzer.OnAnalyzeListener<AnalyzeResult<T>> mOnAnalyzeListener; /** * 蜂鸣音效管理器：主要用于播放蜂鸣提示音和振动效果 */ private BeepManager mBeepManager; /** * 环境光线管理器：主要通过传感器来监听光线的亮度变化 */ private AmbientLightManager mAmbientLightManager; /** * 最后点击时间，根据两次点击时间间隔用于区分单机和触摸缩放事件 */ private long mLastHoveTapTime; /** * 是否是点击事件 */ private boolean isClickTap; /** * 按下时X坐标 */ private float mDownX; /** * 按下时Y坐标 */ private float mDownY; public BaseCameraScan(@NonNull ComponentActivity activity, @NonNull PreviewView previewView) { this(activity, activity, previewView); } public BaseCameraScan(@NonNull Fragment fragment, @NonNull PreviewView previewView) { this(fragment.getContext(), fragment.getViewLifecycleOwner(), previewView); } public BaseCameraScan(@NonNull Context context, @NonNull LifecycleOwner lifecycleOwner, @NonNull PreviewView previewView) { this.mContext = context; this.mLifecycleOwner = lifecycleOwner; this.mPreviewView = previewView; initData(); } /** * 缩放手势检测 */ private ScaleGestureDetector.OnScaleGestureListener mOnScaleGestureListener = new ScaleGestureDetector.SimpleOnScaleGestureListener() { @Override public boolean onScale(ScaleGestureDetector detector) { float scale = detector.getScaleFactor(); if (mCamera != null) { float ratio = mCamera.getCameraInfo().getZoomState().getValue().getZoomRatio(); // 根据缩放的手势和当前比例进行缩放 zoomTo(ratio * scale); return true; } return false; } }; /** * 初始化 */ @SuppressLint("ClickableViewAccessibility") private void initData() { mResultLiveData = new MutableLiveData<>(); mResultLiveData.observe(mLifecycleOwner, result -> { if (result != null) { handleAnalyzeResult(result); } else if (mOnScanResultCallback != null) { mOnScanResultCallback.onScanResultFailure(); } }); mOnAnalyzeListener = new Analyzer.OnAnalyzeListener<AnalyzeResult<T>>() { @Override public void onSuccess(@NonNull AnalyzeResult<T> result) { mResultLiveData.postValue(result); } @Override public void onFailure(@Nullable Exception e) { mResultLiveData.postValue(null); } }; ScaleGestureDetector scaleGestureDetector = new ScaleGestureDetector(mContext, mOnScaleGestureListener); mPreviewView.setOnTouchListener((v, event) -> { handlePreviewViewClickTap(event); if (isNeedTouchZoom()) { return scaleGestureDetector.onTouchEvent(event); } return false; }); mBeepManager = new BeepManager(mContext); mAmbientLightManager = new AmbientLightManager(mContext); if (mAmbientLightManager != null) { mAmbientL