一个 Flutter 插件,可在 Android 和 iOS 设备上实现条形码和二维码扫描。它提供了一个简单的接口,可将基于相机的扫描功能集成到应用程序中,支持包括二维码在内的多种条形码格式。该插件利用原生相机 API 实现可靠性能和实时扫描。非常适合需要从条形码或二维码快速捕获数据的应用程序,例如库存系统、票务或产品查询工具。
适合场景
库存管理
票务扫描
产品信息查询
通过二维码进行用户身份验证
移动支付
主要特点
实时条形码扫描
支持二维码和多种条形码类型
跨平台(Android 和 iOS)
简单 API 集成
基于摄像头的扫描,自动对焦
适合对象
零售应用
事件票务系统
物流与仓储
移动支付平台
快速数据输入界面
使用建议
需要相机权限
可能需要后台执行处理
性能因设备硬件而异
扫描UI的自定义选项有限
依赖原生相机访问的稳定性
原始 README
以下为关联源码仓库的 README 原文快照,最新内容请访问源码仓库。
flutter_barcode_scanner
A plugin for Flutter apps that adds barcode scanning support on both Android and iOS.
Try example
Just clone or download the repository, open the project in Android Studio/ VS Code, open pubspec.yaml and click on Packages get.
Connect device and hit run.
To run on iPhone you need to run from Xcode first time and just make pod install in example/ios then run from Xcode.
Getting Started
Follow the steps for Android and iOS
PLEASE FOLLOW iOS STEPS CAREFULLY
Android
:zap: Don't worry, you don't need to do anything.
iOS - Requires Swift support
Deployment target : 12
1. Fresh start:
Create a new flutter project. Please check for Include swift support for iOS code.
After creating new flutter project open /ios project in Xcode and set minimum deployment target to 12
and set Swift version to 5.
After setting up the deployment target and swift version, close the Xcode then run pod install in /ios in flutter project.
You have done with basic configuration now proceed to section How to use.
2. Adding to existing flutter app:
If your existing ios code is Swift then you just need to do following.
Set minimum deployment target to 12 and set Swift version to 5.
Close the Xcode and run pod install in /ios in flutter project.
Now proceed to section How to use.
If your existing ios code is Objective-C then you need to do following.
Create a new flutter project with same name at different location (Don't forget to check Include swift support for iOS code while creating)
Just copy newly created /ios folder from project and replace with existing /ios.
Open ios project in Xcode and set minimum deployment target to 12 and set Swift version to 5.
Run pod install in /ios
Note: If you did any changes in ios part before, you might need to make these configuration again
How to use ?
To use on iOS, you will need to add the camera usage description.
To do that open the Xcode and add camera usage description in Info.plist.
COLOR_CODE is hex-color which is the color of line in barcode overlay you can pass color of your choice,
CANCEL_BUTTON_TEXT is a text of cancel button on screen you can pass text of your choice and language,
isShowFlashIcon is bool value used to show or hide the flash icon,
scanMode is a enum in which user can pass any of { QR, BARCODE, DEFAULT }, if nothing is passed it will consider a default value which will be QR.
It shows the graphics overlay like for barcode and QR.
NOTE: Currently, scanMode is just to show the graphics overlay for barcode and QR. Any of this mode selected will scan both QR and barcode.
Continuous scan
If you need to scan barcodes continuously without closing camera use FlutterBarcodeScanner.getBarcodeStreamReceiver
params will be same like FlutterBarcodeScanner.scanBarcode
e.g.
FlutterBarcodeScanner.getBarcodeStreamReceiver("#ff6666", "Cancel", false, ScanMode.DEFAULT)
.listen((barcode) {
/// barcode to be used
});
Contribution:
would :heart: to see any contribution, give :star: if you like