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

qr_code_scanner_plus のカバー
パッケージ詳細v2.4.1

qr_code_scanner_plus

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

AndroidiOSWeb
30日間ダウンロード
9.9万
いいね数
131
Pub ポイント
160

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

flutter pub add qr_code_scanner_plus

パッケージ概要

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

Flutterパッケージで、AndroidのzxingおよびiOSのAVFoundationを活用して、アプリにQRコードスキャン機能を埋め込みます。Android、iOS、Webプラットフォーム間でリアルタイムスキャンをサポートし、スムーズな統合を実現します。複雑なセットアップなしで信頼性とパフォーマンスの高いQRスキャンを求める開発者向けです。このパッケージはvespr.xyzによってメンテナンスされており、pub.devから入手可能です。

用途

  • アプリ内での支払い用QRコードスキャン
  • QRコードを用いたユーザー認証
  • 製品情報の取得
  • イベントチケットの検証
  • デバイス間のデータ共有
  • 在庫管理

主な機能

  • Android および iOS でのネイティブパフォーマンス
  • クロスプラットフォーム対応(Android、iOS、Web)
  • Flutterウィジェットとの簡単な統合
  • リアルタイムスキャン機能
  • 軽量かつ効率的
  • オープンソースで公開リポジトリ

適している対象

  • モバイルアプリ開発者
  • 決済およびフィンテックアプリケーション
  • イベントおよびチケットプラットフォーム
  • 小売および在庫システム
  • 安全なデータ交換を必要とするアプリ

注意事項

  • Webサポートではカメラアクセスが制限される場合があります
  • モバイルでのカメラ権限が必要です
  • パフォーマンスはデバイスのハードウェアに依存します
  • Webデプロイメント用に追加の構成が必要になる場合があります
  • スキャンインターフェースのカスタマイズが限られている

元の README

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

pub package

⚠️ If you are starting a new project, or your project requires new features or long-term stability, use an actively maintained alternative such as mobile_scanner.


⚠️ Maintenance-only fork (no new features)

This package is a maintenance-only fork of the original qr_code_scanner package.

Its sole purpose is to keep existing projects compiling and running on newer versions of Flutter, the Android Gradle Plugin, and related tooling after the upstream package became unmaintained. It exists to allow existing users to postpone migration, not to provide an actively developed QR scanning solution.

New feature PRs will be rejected.
This includes (but is not limited to):

  • New functionality
  • Feature extensions
  • API changes or expansions
  • Behavior changes beyond minimal fixes required for compatibility

If you need additional functionality, this package is not the right choice.


Scope and limitations

  • I maintain only the Flutter-facing code in this repository.
  • The underlying native scanning is handled by:
    • Android: zxing
    • iOS: Native AVFoundation (Swift Package Manager and CocoaPods supported)

The original qr_code_scanner package used MTBBarcodeScanner on iOS, which has been archived and unmaintained since 2021. This fork replaced it with a native AVFoundation implementation to enable Swift Package Manager support and remove the only third-party iOS dependency.

The Android native library (zxing) is outdated and unmaintained. There are known issues and limitations in that native package that will not be fixed here.

As a result:

  • Native-level bugs should be expected.
  • This package is not a good foundation for adding or extending features.
  • Only minimal fixes required to keep the package usable on current Flutter toolchains will be considered.

Projects that require new functionality, reliability, or long-term maintenance of both Flutter and native code should migrate to a fully maintained alternative such as mobile_scanner.


QR Code Scanner Plus

A QR code scanner for iOS, Android, and Web that embeds platform views in Flutter.

This description is retained for historical context only and does not imply ongoing feature development.


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;
      });
    });
  }
}

Android Integration

In order to use this plugin, please make sure to add the Camera permissions in android/app/src/main/AndroidManifest.xml

    <uses-permission android:name="android.permission.CAMERA" />

iOS Integration

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

<key>NSCameraUsageDescription</key>
<string>This app needs camera access to scan QR codes</string>
UIScene lifecycle

The iOS plugin supports both the UIScene lifecycle and the legacy application lifecycle. No plugin-specific SceneDelegate or camera lifecycle changes are required.

The host app must still adopt UIScene; updating this package alone does not migrate your app. Follow Flutter's UIScene migration guide to configure UIApplicationSceneManifest in Info.plist and register plugins in didInitializeImplicitFlutterEngine using engineBridge.pluginRegistry. The example AppDelegate and example Info.plist already use this setup.

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();

Credits

  • Android: https://github.com/zxing/zxing
  • Original qr_code_scanner contributors

カテゴリー

依存関係

依存関係一覧 1 件

ソースリポジトリ

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