依星源码资源网,依星资源网

 找回密码
 立即注册

QQ登录

只需一步,快速开始

【好消息,好消息,好消息】VIP会员可以发表文章赚积分啦 !
查看: 117|回复: 0

一个Android 简化扫描识别流程的通用基础库JAVA源码

[复制链接] 主动推送

2164

主题

2172

帖子

3430

积分

管理员

Rank: 9Rank: 9Rank: 9

积分
3430
发表于 2024-11-3 12:51:23 | 显示全部楼层 |阅读模式
一个Android 简化扫描识别流程的通用基础库JAVA源码
本身并不提供具体的分析识别功能,只是将相机预览、扫描分析等过程进行抽象分离,从而简化扫描识别功能的实现,作为基础库,然后实现具体的识别业务,便可快速实现各种扫描识别相关功能。

引入Gradle:
  • 在Project的 build.gradle 或 setting.gradle 中添加远程仓库
    repositories {    //...    mavenCentral()}
  • 在Module的 build.gradle 里面添加引入依赖项
    implementation 'com.github.jenly1314:camera-scan:1.2.0'
使用快速实现扫描识别主要有以下几种方式:
1、通过继承 BaseCameraScanActivity 或者 BaseCameraScanFragment 或其子类,可快速实现扫描识别。 (适用于大多场景,自定义布局时需覆写 getLayoutId 方法)
2、在你项目的Activity或者Fragment中实例化一个 BaseCameraScan。(适用于想在扫描界面写交互逻辑,又因为项目 架构或其它原因,无法直接或间接继承 BaseCameraScanActivity 或 BaseCameraScanFragment 时使用)
3、继承 CameraScan 自己实现一个,可参照默认实现类 BaseCameraScan,其他步骤同方式2。(高级用法,谨慎使用)

主要是相机相关的配置;如:摄像头的前置后置、相机预览相关、图像分析相关等配置。
CameraConfig中提供的可配置项:CameraSelector.Builder、Preview.Builder、ImageAnalysis.Builder;
你可以直接库中内置实现的相机配置: CameraConfig 、AspectRatioCameraConfig 和 ResolutionCameraConfig。
这里简单说下各自的特点:
  • CameraConfig:CameraX默认的相机配置。
  • AdaptiveCameraConfig:自适应相机配置:主要是根据纵横比和设备屏幕的分辨率找到与相机之间合适的相机配置(v1.1.0新增)
  • AspectRatioCameraConfig:根据纵横比配置相机,使输出分析的图像尽可能的接近屏幕的比例
  • ResolutionCameraConfig:根据尺寸配置相机的目标图像大小,使输出分析的图像的分辨率尽可能的接近屏幕尺寸
你也可以自定义或覆写 CameraConfig 中的 options 方法,根据需要定制配置。
这里特别温馨提示:默认配置在未配置相机的目标分析图像大小时,会优先使用:横屏:640 * 480 竖屏:480 * 640;
根据这个图像质量顺便说下默认配置的优缺点:
  • 优点:因为图像质量不高,所以在低配置的设备上使用也能hold住,这样就能尽可能的适应各种设备;
  • 缺点:正是由于图像质量不高,从而可能会对检测识别率略有影响,比如在某些机型上体验欠佳。
  • 结论:在适配、性能与体验之间得有所取舍,找到平衡点。
基于上面的配置优缺点特性,CameraScan内部默认会通过 CameraConfigFactory 来获取适合当前设备的的相机配置:CameraConfig;如果内部默认配置不满足你的需求,你也可以根据具体需求去设置CameraScan的CameraConfig;
如:通过CameraConfig设置前置摄像头
方式一: 通过工厂类创建CameraConfig(推荐)
// 通过工厂类创建适合当前设备的CameraConfigCameraConfig cameraConfig = CameraConfigFactory.createDefaultCameraConfig(this, CameraSelector.LENS_FACING_FRONT);getCameraScan().setCameraConfig(cameraConfig);

方式二: 通过对象创建CameraConfig
// 此处的CameraConfig可以是CameraConfig的任意子类(其它CameraConfig相关配置修改方式与设置前置摄像头类似)CameraConfig cameraConfig = new CameraConfig() {    @NonNull    @Override    public CameraSelector options(@NonNull CameraSelector.Builder builder) {        builder.requireLensFacing(CameraSelector.LENS_FACING_FRONT);        return super.options(builder);    }};getCameraScan().setCameraConfig(cameraConfig);

需要注意的是:cameraScan.setCameraConfig(cameraConfig) 一般是在相机启动预览之前调用的,如果是在相机启动预览之后修改了CameraConfig的配置,则需重新调用cameraScan.startCamera()后,CameraConfig相关配置才会生效。
关于 Analyzer
Analyzer 为定义的分析器接口;主要用于分析相机预览的帧数据,从而得到具体的结果。一般实现某种扫描识别功能时,你只需自定义并实现一个 Analyzer 对应的功能即可。
关于 BaseCameraScanActivity 和 BaseCameraScanFragment
BaseCameraScanActivity 和 BaseCameraScanFragment 作为扫描预览界面的基类,主要目的是便于快速实现扫描识别。
扫描预览界面内部持有 CameraScan,并处理了 CameraScan 的初始化(如:相机权限、相机预览、生命周期等细节)
CameraScan配置示例
CameraScan 里面包含部分支持链式调用的方法,即调用返回是 CameraScan 本身的一些配置建议在调用 startCamera() 方法之前调用。
如果是通过继承 BaseCameraScanActivity 或者 BaseCameraScanFragment 或其子类实现的相机扫描,可以在 initCameraScan() 方法中根据需要修改CameraScan相关配置。
示例:
// 根据需要修改CameraScan相关配置cameraScan.setPlayBeep(true)//设置是否播放音效,默认为false    .setVibrate(true)//设置是否震动,默认为false    .setCameraConfig(CameraConfigFactory.createDefaultCameraConfig(this, CameraSelector.LENS_FACING_BACK))//设置相机配置信息    .setNeedTouchZoom(true)//支持多指触摸捏合缩放,默认为true    .setDarkLightLux(45f)//设置光线足够暗的阈值(单位:lux),需要通过{@link #bindFlashlightView(View)}绑定手电筒才有效    .setBrightLightLux(100f)//设置光线足够明亮的阈值(单位:lux),需要通过{@link #bindFlashlightView(View)}绑定手电筒才有效    .bindFlashlightView(ivFlashlight)//绑定手电筒,绑定后可根据光线传感器,动态显示或隐藏手电筒按钮    .setOnScanResultCallback(this)//设置扫描结果回调,需要自己处理或者需要连扫时,可设置回调,自己去处理相关逻辑    .setAnalyzeImage(true);//设置是否分析图片,默认为true。如果设置为false,相当于关闭了扫描识别功能

启动相机预览
// 启动预览(如果是通过直接或间接继承BaseCameraScanActivity或BaseCameraScanFragment实现的则无需调用startCamera)getCameraScan().startCamera();

控制闪光灯
// 设置闪光灯(手电筒)是否开启,需在startCamera之后调用才有效getCameraScan().enableTorch(torch);

设置分析器
// 设置分析器cameraScan.setAnalyzer(analyzer);

如果是通过直接或间接继承 BaseCameraScanActivity 来实现的,可直接覆写 createAnalyzer 方法返回具体的分析器即可。
  • 看到这里,你对 CameraScan 相关配置应该有了基本的了解,CameraScan 作为一个简化扫描识别流程的通用基础库,将通用的预览分析流程,进行尽可能的抽象分离,然后实现公共部分;将具体分析功能进行抽象;基于 CameraScan 你只需实现一个Analyzer,并根据需要进行CameraScan相关配置,就可以快速实现具体的扫描检测功能。
介绍完 CameraScan 相关配置后,下面就来说下界面和布局部分;
界面示例
通过继承 BaseCameraScanActivity 可快速实现具体的扫描功能;( BaseCameraScanFragment 与之类似)
示例:
// 此处的泛型*表示分析得到的具体结果class CameraScanActivity : BaseCameraScanActivity<*>() {    /**     * 初始化CameraScan     */    override fun initCameraScan(cameraScan: CameraScan<*>) {        super.initCameraScan(cameraScan)        // TODO 根据需要初始化CameraScan相关配置        cameraScan.setPlayBeep(true)    }    /**     * 布局ID;通过覆写此方法可以自定义布局     *     * @return 布局ID     */    override fun getLayoutId(): Int {        return super.getLayoutId()    }    override fun onScanResultCallback(result: AnalyzeResult<*>) {        // TODO 扫描结果回调;分析后得到的结果    }    override fun createAnalyzer(): Analyzer<*>? {        // TODO 创建分析器;由具体的分析器去实现分析检测功能        return null    }}

一般在 ZXingLiteMLKitWeChatQRCode 对应的库中都有提供 BaseCameraScanActivity 的子类,可快速实现具体的分析识别功能。(比如:MLKit中的条码扫描有:BarcodeCameraScanActivity
布局示例
PreviewView 用来预览,布局内至少要保证有 PreviewView (必须的);如果是继承 BaseCameraScanActivity 或 BaseCameraScanFragment 或其子类实现的相机扫描;快速实现扫描功能; 需自定义布局时,通过覆写getLayoutId方法即可;预览控件ID可覆写getPreviewViewId方法自定义;
ivFlashlight 是布局内置的手电筒(非必须的),如果是继承 BaseCameraScanActivity 或 BaseCameraScanFragment,其内部已默认处理了手电筒点击开关事件;控件id可覆写getFlashlightId方法自定义,默认为 ivFlashlight。返回0表示无需内置手电筒。您也可以自己去定义
更多CameraScan相关用法可查看 BaseCameraScanActivity 源码或参见下面的使用示例。
BaseCameraScanActivity和BaseCameraScanFragment使用的默认布局:
<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"    android:layout_width="match_parent"    android:layout_height="match_parent">    <androidx.camera.view.PreviewView        android:id="@+id/previewView"        android:layout_width="match_parent"        android:layout_height="match_parent" />    <!-- 只需保证有布局内有PreviewView即可,然后你可根据需要添加的控件 -->    <ImageView        android:id="@+id/ivFlashlight"        android:layout_width="wrap_content"        android:layout_height="wrap_content"        android:layout_gravity="center"        android:layout_marginTop="@dimen/camera_scan_flashlight_margin_top"        android:contentDescription="@null"        android:src="@drawable/camera_scan_flashlight_selector" /></FrameLayout>

自定义布局示例:(通过覆写getLayoutId方法)
<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"    android:layout_width="match_parent"    android:layout_height="match_parent">    <androidx.camera.view.PreviewView        android:id="@+id/previewView"        android:layout_width="match_parent"        android:layout_height="match_parent" />    <!-- 只需保证有布局内有PreviewView即可,然后你可根据需要添加的控件 -->    <com.king.view.viewfinderview.ViewfinderView        android:id="@+id/viewfinderView"        android:layout_width="match_parent"        android:layout_height="match_parent" />    <ImageView        android:id="@+id/ivFlashlight"        android:layout_width="wrap_content"        android:layout_height="wrap_content"        android:layout_gravity="center"        android:layout_marginTop="@dimen/camera_scan_flashlight_margin_top"        android:contentDescription="@null"        android:src="@drawable/camera_scan_flashlight_selector" /></FrameLayout>

相关推荐MLKit 一个强大易用的工具包。通过ML Kit您可以很轻松的实现文字识别、条码识别、图像标记、人脸检测、对象检测等功能。WeChatQRCode 基于OpenCV开源的微信二维码引擎移植的扫码识别库。ZXingLite 基于zxing实现的扫码库,优化扫码和生成二维码/条形码功能。ViewfinderView ViewfinderView一个取景视图:主要用于渲染扫描相关的动画效果。

游客,本帖隐藏的内容需要积分高于 2 才可浏览,您当前积分为 0

提取码下载:
文件名称:提取码下载.txt 
下载次数:2  文件大小:16 Bytes  售价:16金钱 [记录]
下载权限: 不限 [购买VIP]   [充值]   [在线充值]   【VIP会员6折;永久VIP4折】
安全检测,请放心下载





相关帖子

扫码关注微信公众号,及时获取最新资源信息!下载附件优惠VIP会员5折;永久VIP免费
您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

免责声明:
1、本站提供的所有资源仅供参考学习使用,版权归原著所有,禁止下载本站资源参与商业和非法行为,请在24小时之内自行删除!
2、本站所有内容均由互联网收集整理、网友上传,并且以计算机技术研究交流为目的,仅供大家参考、学习,请勿任何商业目的与商业用途。
3、若您需要商业运营或用于其他商业活动,请您购买正版授权并合法使用。
4、论坛的所有内容都不保证其准确性,完整性,有效性,由于源码具有复制性,一经售出,概不退换。阅读本站内容因误导等因素而造成的损失本站不承担连带责任。
5、用户使用本网站必须遵守适用的法律法规,对于用户违法使用本站非法运营而引起的一切责任,由用户自行承担
6、本站所有资源来自互联网转载,版权归原著所有,用户访问和使用本站的条件是必须接受本站“免责声明”,如果不遵守,请勿访问或使用本网站
7、本站使用者因为违反本声明的规定而触犯中华人民共和国法律的,一切后果自己负责,本站不承担任何责任。
8、凡以任何方式登陆本网站或直接、间接使用本网站资料者,视为自愿接受本网站声明的约束。
9、本站以《2013 中华人民共和国计算机软件保护条例》第二章 “软件著作权” 第十七条为原则:为了学习和研究软件内含的设计思想和原理,通过安装、显示、传输或者存储软件等方式使用软件的,可以不经软件著作权人许可,不向其支付报酬。若有学员需要商用本站资源,请务必联系版权方购买正版授权!
10、本网站如无意中侵犯了某个企业或个人的知识产权,请来信【站长信箱312337667@qq.com】告之,本站将立即删除。
郑重声明:
本站所有资源仅供用户本地电脑学习源代码的内含设计思想和原理,禁止任何其他用途!
本站所有资源、教程来自互联网转载,仅供学习交流,不得商业运营资源,不确保资源完整性,图片和资源仅供参考,不提供任何技术服务。
本站资源仅供本地编辑研究学习参考,禁止未经资源商正版授权参与任何商业行为,违法行为!如需商业请购买各资源商正版授权
本站仅收集资源,提供用户自学研究使用,本站不存在私自接受协助用户架设游戏或资源,非法运营资源行为。
 
在线客服
点击这里给我发消息 点击这里给我发消息 点击这里给我发消息
售前咨询热线
312337667

微信扫一扫,私享最新原创实用干货

QQ|免责声明|小黑屋|依星资源网 ( 鲁ICP备2021043233号-3 )|网站地图

GMT+8, 2024-12-13 11:36

Powered by Net188.com X3.4

邮箱:312337667@qq.com 客服QQ:312337667(工作时间:9:00~21:00)

快速回复 返回顶部 返回列表