パッケージ、リポジトリ、アプリカテゴリを検索

パッケージ詳細v1.0.1

qr_code_scanner

Flutter内に埋め込めるQRコードスキャナー。Androidではzxing、iOSではMTBBarcodeスキャナーを使用しています。

30日間ダウンロード
21.3万
いいね数
2150
Pub ポイント
60

パッケージをインストール

flutter pub add qr_code_scanner

パッケージ概要

公開情報に基づく選定ガイドです。参考としてご利用ください。

Flutterパッケージで、モバイルアプリケーション内でのQRコードスキャンを可能にし、AndroidにはZXing、iOSにはMTBBarcodeScannerというネイティブスキャンライブラリを利用しています。リアルタイムのQRコード検出に対応するシンプルで埋め込み可能なカメラビューを提供します。最小限のセットアップでシームレスに統合できるように設計されており、QRコードによる迅速なデータ取得が必要なアプリに最適です。フロントカメラとバックカメラの両方に対応し、カスタマイズ可能なオーバーレイインジケーターも提供しています。さまざまな照明条件やデバイスタイプでも効率的に動作します。

用途

  • 店舗内製品情報の照会
  • デジタルチケットまたは搭乗券の検証
  • QRコードを用いたユーザー認証
  • デバイス間の非接触データ共有
  • 小売アプリにおける在庫管理

主な機能

  • Android および iOS でのネイティブスキャンパフォーマンス
  • Flutterウィジェットとの簡単な統合
  • 複数のカメラ向きのサポート
  • カスタマイズ可能なスキャンオーバーレイとフィードバック
  • リアルタイムQRコード検出
  • 軽量で高速な初期化

適している対象

  • QRコードスキャン機能が必要なモバイルアプリ
  • 小売およびイベント管理アプリ
  • 認証およびログインシステム
  • 接触なしデータ交換を必要とするアプリ
  • クロスプラットフォームのバーコード対応を求める開発者

注意事項

  • 実行時にカメラの権限が必要です
  • 古いデバイスではパフォーマンスが異なる場合があります
  • QRコードのスキャンに限定(他のバーコードは対象外)
  • UIの一貫性を保つために追加のスタイリングが必要になる場合があります
  • 失敗したスキャンに対する組み込みのエラー処理なし

元の README

関連するソースリポジトリの README 原文のスナップショットです。最新の内容はリポジトリをご覧ください。

Project in Maintenance Mode Only

Since the underlying frameworks of this package, zxing for android and MTBBarcodescanner for iOS are both not longer maintaned, this plugin is no longer up to date and in maintenance mode only. Only bug fixes and minor enhancements will be considered.

I am developing a new plugin mobile_scanner that uses the latest version of MLKit for detecting barcodes and QR codes. On Android it also uses the latest version of CameraX, and on iOS the native AVFoundation for best camera performance.

QR Code Scanner

pub package Join the chat GH Actions

A QR code scanner that works on both iOS and Android by natively embedding the platform view within Flutter. The integration with Flutter is seamless, much better than jumping into a native Activity or a ViewController to perform the scan.

Screenshots

Android

iOS

Get Scanned QR Code

When a QR code is recognized, the text identified will be set in 'result' of type Barcode, which contains the output text as property 'code' of type String and scanned code type as property 'format' which is an enum BarcodeFormat, defined in the library.

class _QRViewExampleState extends State<QRViewExample> {
  final GlobalKey qrKey = GlobalKey(debugLabel: 'QR');
  Barcode? result;
  QRViewController? controller;

  // In order to get hot reload to work we need to pause the camera if the platform
  // is android, or resume the camera if the platform is iOS.
  @override
  void reassemble() {
    super.reassemble();
    if (Platform.isAndroid) {
      controller!.pauseCamera();
    } else if (Platform.isIOS) {
      controller!.resumeCamera();
    }
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: Column(
        children: <Widget>[
          Expanded(
            flex: 5,
            child: QRView(
              key: qrKey,
              onQRViewCreated: _onQRViewCreated,
            ),
          ),
          Expanded(
            flex: 1,
            child: Center(
              child: (result != null)
                  ? Text(
                      'Barcode Type: ${describeEnum(result!.format)}   Data: ${result!.code}')
                  : Text('Scan a code'),
            ),
          )
        ],
      ),
    );
  }

  void _onQRViewCreated(QRViewController controller) {
    this.controller = controller;
    controller.scannedDataStream.listen((scanData) {
      setState(() {
        result = scanData;
      });
    });
  }

  @override
  void dispose() {
    controller?.dispose();
    super.dispose();
  }
}

Android Integration

In order to use this plugin, please update the Gradle, Kotlin and Kotlin Gradle Plugin:

In android/build.gradle change ext.kotlin_version = '1.3.50' to ext.kotlin_version = '1.5.10'

In android/build.gradle change classpath 'com.android.tools.build:gradle:3.5.0' to classpath 'com.android.tools.build:gradle:4.2.0'

In android/gradle/wrapper/gradle-wrapper.properties change distributionUrl=https\://services.gradle.org/distributions/gradle-5.6.2-all.zip to distributionUrl=https\://services.gradle.org/distributions/gradle-6.9-all.zip

In android/app/build.gradle change defaultConfig{ ... minSdkVersion 16 } to defaultConfig{ ... minSdkVersion 20 }

Warning

If you are using Flutter Beta or Dev channel (1.25 or 1.26) you can get the following error:

java.lang.AbstractMethodError: abstract method "void io.flutter.plugin.platform.PlatformView.onFlutterViewAttached(android.view.View)"

This is a bug in Flutter which is being tracked here: https://github.com/flutter/flutter/issues/72185

There is a workaround by adding android.enableDexingArtifactTransform=false to your gradle.properties file.

iOS Integration

In order to use this plugin, add the following to your Info.plist file:

<key>io.flutter.embedded_views_preview</key>
<true/>
<key>NSCameraUsageDescription</key>
<string>This app needs camera access to scan QR codes</string>

Web Integration

Add this to web/index.html:

<script src="https://cdn.jsdelivr.net/npm/jsqr@1.3.1/dist/jsQR.min.js"></script>

Please note: on web, only QR codes are supported. Other barcodes and 2D codes cannot be scanned.

Web support is in very early stage. Features such as flash, pause or resume are not implemented. Moreover, the camera preview does not respect the surrounding constraints. This is not at last due to Flutter's early state of platform views on web.

Flip Camera (Back/Front)

The default camera is the back camera.

await controller.flipCamera();

Flash (Off/On)

By default, flash is OFF.

await controller.toggleFlash();

Resume/Pause

Pause camera stream and scanner.

await controller.pauseCamera();

Resume camera stream and scanner.

await controller.resumeCamera();

SDK

Requires at least SDK 20. Requires at least iOS 8.

TODOs

  • iOS Native embedding is written to match what is supported in the framework as of the date of publication of this package. It needs to be improved as the framework support improves.
  • In future, options will be provided for default states.
  • Finally, I welcome PR's to make it better :), thanks

Credits

  • Android: https://github.com/zxing/zxing
  • iOS: https://github.com/mikebuss/MTBBarcodeScanner
  • Special Thanks To: LeonDevLifeLog for his contributions towards improving this package.

カテゴリー

依存関係

依存関係一覧 1 件

  • js^0.6.3

ソースリポジトリ

このパッケージを使用しているプロジェクト