Add: isAvailable (i.e hardware), isEnabled, openAndroidSettings for NFC

README.md

@@ -23,9 +23,15 @@ Note: This plugin depends on `NFCTagReaderSession` (requires iOS 13.0 or later)
 **Handling Session**
 
 ```dart
-// Check availability
+// Check hardware availability
 bool isAvailable = await NfcManager.instance.isAvailable();
 
+// Check if enabled on device
+bool isEnabled = await NfcManager.instance.isEnabled()
+
+// Open NFC Settings in Android
+await NfcManager.instance.openAndroidNFCSettings();
+
 // Start Session
 NfcManager.instance.startSession(
   onDiscovered: (NfcTag tag) async {

android/src/main/kotlin/io/flutter/plugins/nfcmanager/NfcManagerPlugin.kt

@@ -14,6 +14,8 @@ import android.nfc.tech.NfcF
 import android.nfc.tech.NfcV
 import android.nfc.tech.TagTechnology
 import android.os.Build
+import android.content.Intent
+import android.provider.Settings
 
 import io.flutter.embedding.engine.plugins.FlutterPlugin
 import io.flutter.embedding.engine.plugins.activity.ActivityAware
@@ -63,6 +65,8 @@ class NfcManagerPlugin: FlutterPlugin, MethodCallHandler, ActivityAware {
   override fun onMethodCall(call: MethodCall, result: Result) {
     when (call.method) {
       "Nfc#isAvailable" -> handleNfcIsAvailable(call, result)
+      "Nfc#isEnabled" -> handleNfcIsEnabled(call, result)
+      "Nfc#openSettings" -> handleNfcOpenSettings(call, result)
       "Nfc#startSession" -> handleNfcStartSession(call, result)
       "Nfc#stopSession" -> handleNfcStopSession(call, result)
       "Nfc#disposeTag" -> handleNfcDisposeTag(call, result)
@@ -93,9 +97,20 @@ class NfcManagerPlugin: FlutterPlugin, MethodCallHandler, ActivityAware {
   }
 
   private fun handleNfcIsAvailable(call: MethodCall, result: Result) {
+    result.success(adapter != null)
+  }
+
+  private fun handleNfcIsEnabled(call: MethodCall, result: Result) {
     result.success(adapter?.isEnabled == true)
   }
 
+  private fun handleNfcOpenSettings(call: MethodCall, result: Result) {
+    val intent = Intent(Settings.ACTION_NFC_SETTINGS)
+    this.activity?.startActivity(intent)
+    result.success(null)
+  }
+
+
   private fun handleNfcStartSession(call: MethodCall, result: Result) {
     if (Build.VERSION.SDK_INT < Build.VERSION_CODES.KITKAT) {
       result.error("unavailable", "Requires API level 19.", null)

example/pubspec.lock

@@ -113,7 +113,7 @@ packages:
       path: ".."
       relative: true
     source: path
-    version: "3.3.0"
+    version: "3.4.0"
   path:
     dependency: transitive
     description:

lib/src/nfc_manager/nfc_manager.dart

@@ -1,4 +1,5 @@
 import 'package:flutter/services.dart';
+import 'dart:io' show Platform;
 
 import '../channel.dart';
 import '../translator.dart';
@@ -25,11 +26,30 @@ class NfcManager {
   // _onError
   NfcErrorCallback? _onError;
 
-  /// Checks whether the NFC features are available.
+  /// Checks whether the NFC features are available. (i.e hardware)
   Future<bool> isAvailable() async {
     return channel.invokeMethod('Nfc#isAvailable').then((value) => value!);
   }
 
+  /// Checks whether the NFC features are enabled in Android
+  Future<bool> isEnabled() async {
+    if (Platform.isAndroid) {
+      return channel.invokeMethod('Nfc#isEnabled').then((value) => value!);
+    } else {
+      throw Exception('This method is only available on Android');
+      //NFC is always enabled in iOS
+    }
+  }
+
+  /// Open the NFC settings page in Android
+  Future<void> openAndroidNFCSettings() async {
+    if (Platform.isAndroid) {
+      channel.invokeMethod('Nfc#openSettings');
+    } else {
+      throw Exception('This method is only available on Android');
+    }
+  }
+
   /// Start the session and register callbacks for tag discovery.
   ///
   /// This uses the NFCTagReaderSession (on iOS) or NfcAdapter#enableReaderMode (on Android).
@@ -41,7 +61,7 @@ class NfcManager {
   ///
   /// (iOS only) `alertMessage` is used to display the message on the popup shown when the session is started.
   ///
-  /// (iOS only) `invalidateAfterFirstRead` is used to specify whether the session should be invalidated 
+  /// (iOS only) `invalidateAfterFirstRead` is used to specify whether the session should be invalidated
   /// after the first tag is discovered. Default is true.
   ///
   /// (iOS only) `onError` is called when the session is stopped for some reason after the session has started.