返回插件列表

[MNFC]

NFC标签检测插件。

注意事项

  1. iOS 只支持NDEF数据格式的NFC芯片;
  2. iOS 13以上的手机,才能获取到NFC标签的ID信息;
  3. iOS需要先在应用对应的描述文件中打开 NFC Tag Reading 功能。
  4. iOS需要配置NFC隐私权限。在隐私权限hook中添加详细的使用说明;
  5. nfc开关已开启的状态下,安卓调用startScan后,如果关闭NCF开关后再重新开启NFC开关,需要再次调用startScan才能正常读取数据

hook示例:

 // 获取info.plist配置文件对象:plistObj
  ......
  plistObj.NFCReaderUsageDescription = '如果不允许,将无法进行后续的业务操作';

目录

  1. 是否支持NFC
  2. 开始扫描
  3. 取消扫描

API

是否支持NFC

MNfc.isSupportNFC(callback);
参数 类型 必填 说明
callback function(res) 回调方法,res: true,支持nfc;false,不支持nfc
// 示例
MNfc.isSupportNFC(
      function (res) {
        console.log('isSupportNFC:' + res);
      }
    );

开始扫描

!!注意:上一次调用结束前再次发起新的调用,会先取消上一次的调用,再发起新的调用。

MNfc.startScan(callback);
参数 类型 必填 说明
callback Object 回调方法,请参照下方callback参数说明

callback参数说明

参数 类型 作用
onStart() Function 搜索开始回调
onScan(data) Function 扫描结果回调,例如:{"id":"041F74D2286780"}
onClose() Function 扫描被关闭
onError(err) Function 错误回调,err为详细错误信息,是一个json对象,例如: {"errCode":-1,"errMsg":"出错啦"}
// 示例
MNfc.startScan({
        "onStart":function() {
            console.log('onStart');
        },
        "onScan":function(data){
            console.log(data);
        },
        "onClose":function() {
            console.log('onClose');
        },
        "onError":function(err) {
            console.log("errCode:" + err.errCode + "errMsg:" + err.errMsg);
        }
    });

取消扫描

MNfc.cancelScan(success, error);
参数 类型 必填 说明
success() function 取消成功回调
error(err) function 错误回调,err为详细错误信息,是一个json对象,例如: {"errCode":-1,"errMsg":"出错啦"}
// 示例
MNfc.cancelScan(
  function () {
    console.log('success');
  },
  function (err) {
    console.log("errCode:" + err.errCode + "errMsg:" + err.errMsg);
  }
);