Feature: add androidReaderModeFlags option to pollTag

CHANGELOG.md

@@ -1,3 +1,12 @@
+## Unreleased
+
+### Added
+* New `androidReaderModeFlags` parameter for `poll()` method to customize Android Reader Mode behavior
+  * Allows passing flags like `FLAG_READER_SKIP_NDEF_CHECK` (0x80) for faster tag detection (~500ms improvement)
+  * Supports `FLAG_READER_NO_PLATFORM_SOUNDS` (0x100) to disable system beeps for custom feedback
+  * Flags are combined with technology flags using bitwise OR
+  * Fully backward compatible - optional parameter defaults to null
+
 ## 0.0.1
 
 * Initial release

README.md

@@ -72,3 +72,26 @@ We use error codes with similar meaning as HTTP status code. Brief explanation a
 ### Operation Mode
 
 We provide two operation modes: polling (default) and event streaming. Both can give the same `NFCTag` object. Please see [example](example/example.md) for more details.
+
+### Performance Optimization (Android)
+
+For Android applications, you can optimize NFC tag detection performance using the `androidReaderModeFlags` parameter:
+
+```dart
+// Skip automatic NDEF discovery for ~500ms faster detection
+// and disable platform sounds for custom feedback
+const flags = 0x80 | 0x100; // FLAG_READER_SKIP_NDEF_CHECK | FLAG_READER_NO_PLATFORM_SOUNDS
+
+final tag = await FlutterNfcKit.poll(
+  androidReaderModeFlags: flags,
+);
+```
+
+Common flags from [`NfcAdapter`](https://developer.android.com/reference/android/nfc/NfcAdapter#enableReaderMode(android.app.Activity,%20android.nfc.NfcAdapter.ReaderCallback,%20int,%20android.os.Bundle)):
+- `0x80` - `FLAG_READER_SKIP_NDEF_CHECK`: Skip automatic NDEF discovery, improving detection speed by ~500ms
+- `0x100` - `FLAG_READER_NO_PLATFORM_SOUNDS`: Disable system beep/vibration for custom audio/haptic feedback
+
+These flags are particularly useful for applications that:
+- Need fast tag detection (e.g., access control, fast payments)
+- Implement custom user feedback instead of system sounds
+- Use custom NDEF reading logic instead of automatic discovery

android/src/main/kotlin/im/nfc/flutter_nfc_kit/FlutterNfcKitPlugin.kt

@@ -329,8 +329,9 @@ class FlutterNfcKitPlugin : FlutterPlugin, MethodCallHandler, ActivityAware {
                 val timeout = call.argument<Int>("timeout")!!
                 // technology and option bits are set in Dart code
                 val technologies = call.argument<Int>("technologies")!!
+                val readerModeFlags = call.argument<Int>("readerModeFlags")
                 runOnNfcThread(result, "Poll") {
-                    pollTag(nfcAdapter, result, timeout, technologies)
+                    pollTag(nfcAdapter, result, timeout, technologies, readerModeFlags)
                 }
             }
 
@@ -583,7 +584,7 @@ class FlutterNfcKitPlugin : FlutterPlugin, MethodCallHandler, ActivityAware {
 
     override fun onDetachedFromActivityForConfigChanges() {}
 
-    private fun pollTag(nfcAdapter: NfcAdapter, result: Result, timeout: Int, technologies: Int) {
+    private fun pollTag(nfcAdapter: NfcAdapter, result: Result, timeout: Int, technologies: Int, readerModeFlags: Int?) {
 
         pollingTimeoutTask = Timer().schedule(timeout.toLong()) {
             try {
@@ -604,7 +605,14 @@ class FlutterNfcKitPlugin : FlutterPlugin, MethodCallHandler, ActivityAware {
             result.success(jsonResult)
         }
 
-        nfcAdapter.enableReaderMode(activity.get(), pollHandler, technologies, null)
+        // Build final flags: combine technology flags with optional reader mode flags
+        val finalFlags = if (readerModeFlags != null) {
+            technologies or readerModeFlags
+        } else {
+            technologies
+        }
+
+        nfcAdapter.enableReaderMode(activity.get(), pollHandler, finalFlags, null)
     }
 
     private class MethodResultWrapper(result: Result) : Result {

lib/flutter_nfc_kit.dart

@@ -325,10 +325,34 @@ class FlutterNfcKit {
   ///
   /// Note: Sometimes NDEF check [leads to error](https://github.com/nfcim/flutter_nfc_kit/issues/11), and disabling it might help.
   /// If disabled, you will not be able to use any NDEF-related methods in the current session.
+  ///
+  /// **Android Reader Mode Flags** ([androidReaderModeFlags]):
+  ///
+  /// Optional flags to customize Android's NFC Reader Mode behavior. These are combined
+  /// with the technology flags using bitwise OR. Common flags from `android.nfc.NfcAdapter`:
+  ///
+  /// - `0x80` (`FLAG_READER_SKIP_NDEF_CHECK`) - Skip automatic NDEF discovery, improving
+  ///   tag detection speed by ~500ms. Use this for faster polling when you don't need
+  ///   automatic NDEF parsing.
+  ///
+  /// - `0x100` (`FLAG_READER_NO_PLATFORM_SOUNDS`) - Disable system beep/vibration when
+  ///   tags are detected. Useful when implementing custom audio/haptic feedback.
+  ///
+  /// Example for fast tag detection with custom feedback:
+  /// ```dart
+  /// const flags = 0x80 | 0x100; // SKIP_NDEF_CHECK | NO_PLATFORM_SOUNDS
+  /// final tag = await FlutterNfcKit.poll(
+  ///   androidReaderModeFlags: flags,
+  /// );
+  /// ```
+  ///
+  /// See [Android NfcAdapter documentation](https://developer.android.com/reference/android/nfc/NfcAdapter#enableReaderMode(android.app.Activity,%20android.nfc.NfcAdapter.ReaderCallback,%20int,%20android.os.Bundle))
+  /// for all available flags.
   static Future<NFCTag> poll({
     Duration? timeout,
     bool androidPlatformSound = true,
     bool androidCheckNDEF = true,
+    int? androidReaderModeFlags,
     String iosAlertMessage = "Hold your iPhone near the card",
     String iosMultipleTagMessage =
         "More than one tags are detected, please leave only one tag and try again.",
@@ -354,6 +378,7 @@ class FlutterNfcKit {
       'iosMultipleTagMessage': iosMultipleTagMessage,
       'technologies': technologies,
       'probeWebUSBMagic': probeWebUSBMagic,
+      'readerModeFlags': androidReaderModeFlags,
     });
     return NFCTag.fromJson(jsonDecode(data));
   }
@@ -529,4 +554,5 @@ class FlutterNfcKit {
   static Future<Uint8List> readSector(int index) async {
     return await _channel.invokeMethod('readSector', {'index': index});
   }
+
 }