Ba-ScanView 是一款毫秒级扫码插件，采用component组件模式，可直接在uniapp界面直接引用，高宽可随意设置

原创于 2025-12-08 17:36:51 发布 · 1k 阅读

19 ·

CC 4.0 BY-SA版权

文章标签：

#uni-app #android #ios #微信小程序 #小程序

更新记录

1.8（2025-12-04）

支持旋转摄像头显示角度：0, 90, 180, 270

1.7（2025-07-08）

支持直接识别本地图片（传地址）

1.6（2024-05-10）

支持手动缩放摄像头（zoomTo）

平台兼容性

Android	Android CPU类型	iOS
适用版本区间：5.0 - 16.0	armeabi-v7a：支持，arm64-v8a：支持，x86：支持	×

原生插件通用使用流程：

购买插件，选择该插件绑定的项目。
在HBuilderX里找到项目，在manifest的app原生插件配置中勾选模块，如需要填写参数则参考插件作者的文档添加。
根据插件作者的提供的文档开发代码，在代码中引用插件，调用插件功能。
打包自定义基座，选择插件，得到自定义基座，然后运行时选择自定义基座，进行log输出测试。
开发完毕后正式云打包

付费原生插件目前不支持离线打包。
Android 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/android
iOS 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/ios

注意事项：使用HBuilderX2.7.14以下版本，如果同一插件且同一appid下购买并绑定了多个包名，提交云打包界面提示包名绑定不一致时，需要在HBuilderX项目中manifest.json->“App原生插件配置”->”云端插件“列表中删除该插件重新选择

扫码原生插件 - 组件版（毫秒级、连续扫码、多码）Ba-ScanView

简介

Ba-ScanView 是一款毫秒级扫码插件，采用component组件模式，可直接在uniapp界面直接引用，高宽可随意设置。

component组件模式，可直接在uniapp界面直接引用，高宽可随意设置
支持连续扫码，可设置时间间隔
支持多码选择
支持设置扫码格式
支持打开、关闭闪光灯
支持相册图片识别
支持直接识别本地图片（传地址）
同时支持vue2和vue3
支持关闭和打开扫描
支持多码直接返回
支持前置、后置摄像头
新增支持拍照版本

注意：原生组件，请使用nvue

支持定制，有建议和需要，请联系QQ：2579546054

也可关注博客，实时更新最新插件：

uniapp 常用原生插件大全

扫码原生插件 - 新版（支持连续扫码模式；支持设置格式；可任意自定义界面）Ba-Scanner

扫码原生插件 - 基础版（毫秒级、支持多码）Ba-Scanner-G

扫码原生插件 - 组件版（毫秒级、连续扫码、多码、相册）Ba-ScanView

扫码原生插件 - 组件版（毫秒级、连续扫码、多码、相册、新增支持拍照）Ba-ScanView2

扫码原生插件 - （最经典zxing版本）Ba-Scanner-Zxing

使用方法（示例）

在 template 中直接引用

        <Ba-ScanViewS ref="scanViewS" style="height: 200;width: 100%;" :load="loadData" @onScan="onScan">
        </Ba-ScanViewS>

在 script 中调用

    export default {
        data() {
            return {
                loadData: {//配置
                    scanTimeSpace: 1000,//时间间隔
                    //isDirScanMulti: true,//是否直接返回多码，默认fasle（弹窗多码标识，用户自己选择）
                    //rpCancelBtnText: 'cancel',
                    isShowToast: true
                }
            }
        },
        onLoad() {
            let that = this;
            //监听扫码结果（vue2和vue3都支持）
            var globalEvent = uni.requireNativePlugin('globalEvent');
            globalEvent.addEventListener('baScanViewEvent', function(e) {
                console.log('baScanViewEvent' + JSON.stringify(e));
            });
        },
        methods: {
            onScan(e) {//扫码监听（仅支持vue2，vue3请使用globalEvent方式）
                console.log("onScan：" + e.detail.result);
                console.log("onScan：" + e.detail.results);//多个
            },
            openScanLight() {//打开闪光灯
                this.$refs.scanViewS.openScanLight();
            },
            closeScanLight() {//关闭闪光灯
                this.$refs.scanViewS.closeScanLight();
            },
            isLightOn() {//是否打开闪光灯
                this.$refs.scanViewS.isLightOn(res => {
                    uni.showToast({
                        title: 'isLightOn：' + res.isLightOn,
                        icon: 'none'
                    })
                });
            },
            openAlbumPage() {//相册识别
                this.$refs.scanViewS.openAlbumPage();
            },
            openScan() { //打开扫描
                this.$refs.scanViewS.openScan();
            },
            closeScan() { //关闭扫描
                this.$refs.scanViewS.closeScan();
            },
            isScanOpen() { //是否打开扫描
                this.$refs.scanViewS.isScanOpen(res => {
                    uni.showToast({
                        title: 'isScanOpen：' + res.isScanOpen,
                        icon: 'none'
                    })
                });
            },
            onImgReg() {//直接识别本地图片（传地址）
                let path = "";
                _this.$refs.scanViewS.onImgReg({
                        path: path
                    },
                    res => {
                        uni.showToast({
                            title: JSON.stringify(res),
                            icon: 'none'
                        })
                    });
            },
        }
    }

默认界面

load 配置参数

属性名	类型	默认值	说明
isShowVibrate	Boolean	true	扫描完成震动
isShowBeep	Boolean	false	扫描完成声音
scanTimeSpace	int	1000	连续扫描时间间隔，单位毫秒，默认 1000
isShowToast	Boolean	true	扫码成功是否 toast 提示，默认 true
barcodeFormats	Array		设置扫码格式，支持多个，默认所有。如：["QR Code", "Code 128"]
scanColor	String	#FF0000	扫描线的颜色
isDirScanMulti	Boolean	false	是否直接返回多码，默认false（弹窗多码标识，用户自己选择）
rpCancelBtnText	String	取消	取消按钮文本
isFacingFront	Boolean	false	是否是前置摄像头，默认false
cameraRotation	number		摄像头默认旋转角度：0, 90, 180, 270

支持的扫码格式 barcodeFormats 参数

线性格式：Codabar、Code 39、Code 93、Code 128、EAN-8、EAN-13、IFF、UPC-A、UPC-E
2D 格式：Aztec、Data Matrix、PDF417、QR Code（二维码）

接口说明

方法名	说明
openScanLight	打开闪光灯
closeScanLight	关闭闪光灯
isLightOn	是否打开闪光灯
openAlbumPage	相册识别
openScan	打开扫描
closeScan	关闭扫描
isScanOpen	是否打开扫描
zoomTo	缩放摄像头：（参数ratio为缩放比例：1.0表示无缩放，大于1.0表示放大，小于1.0表示缩小）
onImgReg	直接识别本地图片地址

系列插件

图片选择插件 Ba-MediaPicker （文档）

图片编辑插件 Ba-ImageEditor （文档）

文件选择插件 Ba-FilePicker （文档）

应用消息通知插件（多种样式，新增支持常驻通知模式） Ba-Notify（文档）

自定义通知（耳机电量）插件 Ba-NotifyEarphone（文档）

应用未读角标插件 Ba-Shortcut-Badge （文档）

应用开机自启插件 Ba-Autoboot（文档）

扫码原生插件（毫秒级、支持多码）Ba-Scanner-G（文档）

扫码原生插件 - 新（可任意自定义界面版本；支持连续扫码；支持设置扫码格式）Ba-Scanner（文档）

动态修改状态栏、导航栏背景色、字体颜色插件 Ba-AppBar（文档）

原生sqlite本地数据库管理 Ba-Sqlite（文档）

安卓保活插件（采用多种主流技术） Ba-KeepAlive（文档）

安卓保活套装（通用、常驻通知、电池优化、自启管理、后台运行等）（文档）

安卓快捷方式（桌面长按app图标） Ba-Shortcut（文档）

自定义图片水印（任意位置） Ba-Watermark（文档）

最接近微信的图片压缩插件 Ba-ImageCompressor（文档）

视频压缩、视频剪辑插件 Ba-VideoCompressor（文档）

动态切换应用图标、名称（如新年、国庆等） Ba-ChangeIcon（文档）

原生Toast弹窗提示（穿透所有界面、穿透原生；自定义颜色、图标） Ba-Toast（文档）

图片涂鸦、画笔 Ba-ImagePaint（文档）

pdf阅读（手势缩放、显示页数） Ba-Pdf（文档）

声音提示、震动提示、语音播报 Ba-Beep（文档）

websocket原生服务（自动重连、心跳检测） Ba-Websocket（文档）

短信监听（验证码） Ba-Sms（文档）

智能安装（自动升级） Ba-SmartUpgrade（文档）

监听系统广播、自定义广播 Ba-Broadcast（文档）

监听通知栏消息（支持白名单、黑名单、过滤） Ba-NotifyListener（文档）

全局置灰、哀悼置灰（可动态、同时支持nvue、vue） Ba-Gray（文档）

获取设备唯一标识（OAID、AAID、IMEI等） Ba-IdCode（文档）

实时定位（系统、后台运行、支持息屏）插件 Ba-Location（文档）

实时定位（高德、后台运行、支持息屏、坐标转换、距离计算） Ba-LocationAMap（文档）

窗口小工具、桌面小部件、微件 Ba-AppWidget（文档）

窗口小工具、桌面小部件、微件（日历、时间） Ba-AwCalendarS（文档）

画中画悬浮窗（视频） Ba-VideoPip（文档）

悬浮窗（在其他应用上层显示） Ba-FloatWindow（文档）

悬浮窗（应用内、无需授权） Ba-FloatWindow2（文档）

悬浮窗（悬浮球、动态菜单、在其他应用上层显示） Ba-FloatBall（文档）

添加到“用其他应用打开”中，用于文件传递、分享等 Ba-ShareReceive（文档）

获取地图数据（高德、地理编码、反地理编码） Ba-AMapData（文档）

来电显示悬浮窗插件（支持锁屏） Ba-CallerID（文档）