FLUTTER ECOSYSTEM

RafaelBarbosatec/qr_code_dart_scan

Dart 디코더를 사용하여 iOS 및 Android에서 모두 작동하는 QR 코드 스캐너입니다.

qr_code_dart_scan 프로젝트 이미지
Stars
21
Forks
26
최근 푸시(UTC)
2026. 8. 10.
프로젝트 상태
활성
Rafael Almeida Barbosa GitHub avatar
GITHUB User

Rafael Almeida Barbosa ↗

Mobile Developer(Android/Flutter) In love with solutions that fit in the palm of the hand

São Paulo/São Paulo Brasil
언어DartRubySwiftKotlinObjective-C

기술 주제

이 저장소가 배포한 패키지

사용 중인 의존성

의존성 목록 9 개

원본 README

아래는 영문 원문 스냅샷입니다. 최신 내용은 GitHub에서 확인하세요.

README 펼치기 / 접기

pub package

QRCodeDartScan

A QR code scanner that works on both iOS and Android using dart decoder.

Scanning normal Qr code Scanning invert Qr code
https://raw.githubusercontent.com/RafaelBarbosatec/qr_code_dart_scan/main/img/normal.jpg https://raw.githubusercontent.com/RafaelBarbosatec/qr_code_dart_scan/main/img/inverted.jpg

APK DEMO

Features

  • Camera scan preview in a widget
  • Scan QRCode
  • Scan inverted QRCode

Supported platforms

This package is limited per camera pluggin support.

Platform Scan live Scan take picture
Android :white_check_mark: :white_check_mark:
IOS :white_check_mark: :white_check_mark:
WEB :white_check_mark:
Windows
MacOS
Linux

Supported Formats

  • QR_CODE
  • AZTEC
  • DATA_MATRIX
  • PDF_417
  • CODE_39
  • CODE_93
  • CODE_128
  • EAN_8
  • EAN_13
  • ITF

Installation

First, add qr_code_dart_scan as a dependency in your pubspec.yaml file.

iOS

iOS 10.0 of higher is needed to use the camera plugin. If compiling for any version lower than 10.0 make sure to check the iOS version before using the camera plugin. For example, using the device_info plugin.

Add two rows to the ios/Runner/Info.plist:

  • one with the key Privacy - Camera Usage Description and a usage description.
  • and one with the key Privacy - Microphone Usage Description and a usage description.

Or in text format add the key:

<key>NSCameraUsageDescription</key>
<string>Can I use the camera please?</string>
<key>NSMicrophoneUsageDescription</key>
<string>Can I use the mic please?</string>
Android

Change the minimum Android sdk version to 21 (or higher) in your android/app/build.gradle file.

minSdkVersion 21

It's important to note that the MediaRecorder class is not working properly on emulators, as stated in the documentation: https://developer.android.com/reference/android/media/MediaRecorder. Specifically, when recording a video with sound enabled and trying to play it back, the duration won't be correct and you will only see the first frame.

dependency_overrides:
  camera_android_camerax: 0.6.14
Using

    return Scaffold(
      body: QRCodeDartScanView(
        onCameraError: (String error) {
          debugPrint('Error: $error');
        },
        // cropRect: CropRect(left: 0, top: 0, width: 100, height: 100), // You can crop the image to improve accuracy by specifying a rectangle region. ( default = null)
        // imageDecodeOrientation: ImageDecodeOrientation.original, // you can force how the image orientation will be decoded (default = original)
        typeScan: TypeScan.live, // if TypeScan.takePicture will try decode when click to take a picture(default TypeScan.live)
        // intervalScan: const Duration(seconds:1)
        // onResultInterceptor: (old,new){
        //  do any rule to controll onCapture.
        // }
        // takePictureButtonBuilder: (context,controller,isLoading){ // if typeScan == TypeScan.takePicture you can customize the button.
        //    if(loading) return CircularProgressIndicator();
        //    return ElevatedButton(
        //       onPressed:controller.takePictureAndDecode,
        //       child:Text('Take a picture'),
        //    );
        // }
        // resolutionPreset: = QrCodeDartScanResolutionPreset.high,
        // formats: [ // You can restrict specific formats.
        //  BarcodeFormat.qrCode,
        //  BarcodeFormat.aztec,
        //  BarcodeFormat.dataMatrix,
        //  BarcodeFormat.pdf417,
        //  BarcodeFormat.code39,
        //  BarcodeFormat.code93,
        //  BarcodeFormat.code128,
        //  BarcodeFormat.ean8,
        //  BarcodeFormat.ean13,
        // ],
        // croppingStrategy: CroppingStrategy.cropCenterSquare(
        //   squareSizeFactor: 0.7,
        // ),
        onCapture: (ScanResult result) {
          // do anything with result
          // result.text      -> String
          // result.format    -> BarcodeFormat
          // result.corners   -> List<Point<double>>, in camera preview
          //                     coordinates. Use `result.corners.toOffsets`
          //                     to paint them.
          // result.rawBytes  -> Uint8List?
          // result.timestamp -> DateTime
        },
      ),
    );
    

ATTENTION

Always use this package in portrait mode.

There is a bug in the camera plugin that sometimes the image is rotated 90 degrees, to avoid this problem, you can use the imageDecodeOrientation parameter to force the image to be decoded in the correct orientation.

For example, if you are reading an ITF code, you can force the image to be decoded in landscape orientation.

imageDecodeOrientation: ImageDecodeOrientation.landscape,

if you want to force the image to be decoded in portrait orientation, you can use the following code:

imageDecodeOrientation: ImageDecodeOrientation.portrait,
Camera performance

The decoder process is done in dart code. So, in flutter debug mode, you will not have a good performance. But in release mode, the performance is very better.