• uniapp使用nfc功能及详解

    公司使用uniapp在android手机端要增加一个nfc识别的功能。在此记录一下实现的过程。

     

    资料查找

    我的代码逻辑主要来源于找到的这篇文章：

    uniapp-安卓NFC读取 - 我要找到我的全世界 - 博客园

     文章内附有代码，为防止文章失效代码消失，在这篇文章里面也记录一下。

    1. var NfcAdapter;
    2. var NdefRecord;
    3. var NdefMessage;
    4. var _getCardNo;
    5.  
    6. export default {
    7.     initNFC() {
    8.         if (uni.getSystemInfoSync().platform == 'android') {
    9.             listenNFCStatus()
    10.         }
    11.     },
    12.     readNFC(callback) {
    13.         if (uni.getSystemInfoSync().platform == 'android') {
    14.             readData(callback);
    15.         }
    16.     },
    17.     closeNFC() {
    18.         if (uni.getSystemInfoSync().platform == 'android') {
    19.             closeReadAndWrite();
    20.         }
    21.     }
    22. }
    23.  
    24. function listenNFCStatus() {
    25.     try {
    26.         var main = plus.android.runtimeMainActivity();
    27.         var Intent = plus.android.importClass('android.content.Intent');
    28.         var Activity = plus.android.importClass('android.app.Activity');
    29.         var PendingIntent = plus.android.importClass('android.app.PendingIntent');
    30.         var IntentFilter = plus.android.importClass('android.content.IntentFilter');
    31.         NfcAdapter = plus.android.importClass('android.nfc.NfcAdapter');
    32.         var nfcAdapter = NfcAdapter.getDefaultAdapter(main);
    33.  
    34.         if (nfcAdapter == null) {
    35.             uni.showToast({
    36.                 title: '设备不支持NFC！',
    37.                 icon: 'none'
    38.             })
    39.             return;
    40.         }
    41.          
    42.         if (!nfcAdapter.isEnabled()) {
    43.             uni.showToast({
    44.                 title: '请在系统设置中先启用NFC功能！',
    45.                 icon: 'none'
    46.             });
    47.             return;
    48.         }
    49.  
    50.         var intent = new Intent(main, main.getClass());
    51.         intent.addFlags(Intent.FLAG_ACTIVITY_SINGLE_TOP);
    52.         var pendingIntent = PendingIntent.getActivity(main, 0, intent, 0);
    53.         var ndef = new IntentFilter("android.nfc.action.TECH_DISCOVERED");
    54.         ndef.addDataType("*/*");
    55.         var intentFiltersArray = [ndef];
    56.         var techListsArray = [
    57.             ["android.nfc.tech.IsoDep"],
    58.             ["android.nfc.tech.NfcA"],
    59.             ["android.nfc.tech.NfcB"],
    60.             ["android.nfc.tech.NfcF"],
    61.             ["android.nfc.tech.Nfcf"],
    62.             ["android.nfc.tech.NfcV"],
    63.             ["android.nfc.tech.NdefFormatable"],
    64.             ["android.nfc.tech.MifareClassic"],
    65.             ["android.nfc.tech.MifareUltralight"]
    66.         ];
    67.         plus.globalEvent.addEventListener("newintent",
    68.             function() {
    69.                 setTimeout(handle_nfc_data1, 1000);
    70.             }, false);
    71.         plus.globalEvent.addEventListener("pause", function(e) {
    72.             if (nfcAdapter) {
    73.                 nfcAdapter.disableForegroundDispatch(main);
    74.             }
    75.         }, false);
    76.         plus.globalEvent.addEventListener("resume", function(e) {
    77.             if (nfcAdapter) {
    78.                 //console.log('resume'); 
    79.                 nfcAdapter.enableForegroundDispatch(main, pendingIntent, intentFiltersArray, techListsArray);
    80.             }
    81.         }, false);
    82.         nfcAdapter.enableForegroundDispatch(main, pendingIntent, intentFiltersArray, techListsArray);
    83.     } catch (e) {
    84.         console.error(e);
    85.     }
    86. }
    87.  
    88. function handle_nfc_data1() {
    89.     NdefRecord = plus.android.importClass("android.nfc.NdefRecord");
    90.     NdefMessage = plus.android.importClass("android.nfc.NdefMessage");
    91.     var main = plus.android.runtimeMainActivity();
    92.     var intent = main.getIntent();
    93.     //console.log("action type:" + intent.getAction()); 
    94.     if ("android.nfc.action.TECH_DISCOVERED" == intent.getAction()) {
    95.         if (readyWriteData) {
    96.             //__write(intent);
    97.             readyWriteData = false;
    98.         } else if (readyRead) {
    99.             __read(intent);
    100.             readyRead = false;
    101.         }
    102.     }
    103. }
    104.  
    105. function showToast(msg) {
    106.     plus.nativeUI.toast(msg);
    107. }
    108.  
    109. // function __write(intent) {
    110. //  try {
    111. //      waiting.setTitle('请勿移开标签\n正在写入...');
    112. //      var text = document.getElementById('text').value;
    113. //      console.log("text=" + text);
    114. //      var textBytes = plus.android.invoke(text, "getBytes");
    115. //      var textRecord = new NdefRecord(NdefRecord.TNF_MIME_MEDIA,
    116. //          plus.android.invoke("text/plain", "getBytes"), plus.android.invoke("", "getBytes"), textBytes);
    117. //      var message = new NdefMessage([textRecord]);
    118. //      var Ndef = plus.android.importClass('android.nfc.tech.Ndef');
    119. //      var NdefFormatable = plus.android.importClass('android.nfc.tech.NdefFormatable');
    120. //      var tag = intent.getParcelableExtra(NfcAdapter.EXTRA_TAG);
    121. //      var ndef = Ndef.get(tag);
    122. //      if (ndef != null) {
    123. //          var size = message.toByteArray().length;
    124. //          console.log("size=" + size);
    125. //          ndef.connect();
    126. //          if (!ndef.isWritable()) {
    127. //              showToast("tag不允许写入");
    128. //              waiting.close();
    129. //              return;
    130. //          }
    131. //          if (ndef.getMaxSize() < size) {
    132. //              showToast("文件大小超出容量");
    133. //              waiting.close();
    134. //              return;
    135. //          }
    136.  
    137. //          ndef.writeNdefMessage(message);
    138. //          waiting.close();
    139. //          showToast("写入数据成功.");
    140. //          return;
    141. //      } else {
    142. //          var format = NdefFormatable.get(tag);
    143. //          if (format != null) {
    144. //              try {
    145. //                  format.connect();
    146. //                  format.format(message);
    147. //                  showToast("格式化tag并且写入message");
    148. //                  waiting.close();
    149. //                  return;
    150. //              } catch (e) {
    151. //                  showToast("格式化tag失败.");
    152. //                  waiting.close();
    153. //                  return;
    154. //              }
    155. //          } else {
    156. //              showToast("Tag不支持NDEF");
    157. //              waiting.close();
    158. //              return;
    159. //          }
    160. //      }
    161. //  } catch (e) {
    162. //      console.log("error=" + e);
    163. //      waiting.close();
    164. //      alert('写入失败');
    165. //  }
    166.  
    167. // }
    168.  
    169. function __read(intent) {
    170.     try {
    171.         var content = "";
    172.         waiting.setTitle('请勿移开标签\n正在读取数据...');
    173.         var tag = plus.android.importClass("android.nfc.Tag");
    174.         tag = intent.getParcelableExtra(NfcAdapter.EXTRA_TAG);
    175.         var bytesId = intent.getByteArrayExtra(NfcAdapter.EXTRA_ID);
    176.         waiting.close();
    177.         var tagid = bytesToHexString(tag.getId())
    178.         if (typeof _getCardNo === 'function') {
    179.             _getCardNo(tagid);
    180.         }
    181.     } catch (e) {
    182.         uni.showToast({
    183.             title: e,
    184.             icon: 'none'
    185.         });
    186.     }
    187. }
    188.  
    189. function bytesToHexString(inarray) {
    190.     var i, j, x;
    191.     var hex = ["0", "1", "2", "3", "4", "5", "6", "7", "8", "9", "A",
    192.         "B", "C", "D", "E", "F"
    193.     ];
    194.     var out = "";
    195.     for (j = 0; j < inarray.length; ++j) {
    196.         x = parseInt(inarray[j]) & 0xff;
    197.         i = (x >> 4) & 0x0f;
    198.         out += hex[i];
    199.         i = x & 0x0f;
    200.         out += hex[i];
    201.     }
    202.     return out;
    203. }
    204.  
    205. function reverseTwo(str) {
    206.  
    207.     var str1 = "";
    208.     for (var i = 1; i <= str.length; i++) {
    209.         str1 += str[i - 1];
    210.         if (i % 2 == 0) {
    211.             if (i == str.length) {
    212.                 break;
    213.             }
    214.             str1 += ":";
    215.         }
    216.     }
    217.     var str2 = "";
    218.     for (var i = str1.split(":").length - 1; i >= 0; i--) {
    219.         str2 += str1.split(":")[i];
    220.     }
    221.     return str2;
    222. }
    223.  
    224. if (uni.getSystemInfoSync().platform == 'android') {
    225.     //plus.globalEvent.addEventListener('plusready', listenNFCStatus, false);
    226. }
    227.  
    228. var waiting;
    229. var readyWriteData = false;
    230. var readyRead = false;
    231.  
    232. function writeData() {
    233.     var textEle = plus.globalEvent.getElementById('text');
    234.     if (!textEle.value) {
    235.         uni.showToast({
    236.             title: '请输入要写入的内容！',
    237.             icon: 'none'
    238.         });
    239.         return;
    240.     }
    241.     readyWriteData = true;
    242.     waiting = plus.nativeUI.showWaiting("请将NFC标签靠近！");
    243. }
    244.  
    245. function readData(getCardNo) {
    246.     readyRead = true;
    247.     _getCardNo = getCardNo
    248.     waiting = plus.nativeUI.showWaiting("请将NFC标签靠近！", {
    249.         modal: false
    250.     });
    251. }
    252.  
    253. function closeReadAndWrite() {
    254.     readyWriteData = false;
    255.     readyRead = false;
    256.  
    257.     if (waiting) {
    258.         waiting.close();
    259.     }
    260. }

    代码内部是存在着写入功能的，被注释掉了，单单使用读取功能。

    读取到的NFC类型有比较多种，这是我找到的比较好的一篇解释，大部分文章都有提到的4种类型。

    搞懂Nfc刷卡看这篇就够了 - 知乎

    文章里面附带了NFC相关的android官方文档，因为解析代码逻辑需要用到，我就把官网的链接也贴在下面。

    NFC 基础知识  |  Android 开发者  |  Android Developers  

    NfcAdapter  |  Android Developers

    代码使用：

     第一步：新建一个js文件，复制代码进去。

    第二步：在涉及到使用nfc识别的页面，引入这个js文件。主要三个方法：初始化，关闭识别，识别成功回调方法

    onload里面执行初始化initNFC，在离开页面的时候closeNFC（博主本人放在unload），点击某个按钮BUTTON的时候开始识别readNFC。

    开启识别的时候会一直等待识别，建议添加一个setTimeout定时器，在固定时间调用closeNFC关闭识别，点击BUTTON的时候先清除再调用，识别成功的回调方法里面也要清理这个定时器。

    代码逻辑个人理解：

    uniapp需要在manifest.json中开启手机的NFC识别权限。

    代码中也添加了判断手机是否开启了NFC识别，NFC的识别功能是调用了手机自身的一个intent,然后跳转回来。

     NfcAdapter适配器里面包含了许多的识别到的信息，这些信息都是要经过序列化才能使用的，如果不确定该调用哪个序列化方法，或者想知道还有哪些方法，可以去官方文档 里面找。

    代码中就有使用到这两个值。

     从启动开始讲起，调用手机自身的nfc识别，就意味着当前的intent跳转到另外一个intent，读取到数据之后就跳转回来。

    1.         var main = plus.android.runtimeMainActivity();
    2.         var Intent = plus.android.importClass('android.content.Intent');
    3.         var Activity = plus.android.importClass('android.app.Activity');
    4.         var PendingIntent = plus.android.importClass('android.app.PendingIntent');
    5.         var IntentFilter = plus.android.importClass('android.content.IntentFilter');
    6.         NfcAdapter = plus.android.importClass('android.nfc.NfcAdapter');
    7.         var nfcAdapter = NfcAdapter.getDefaultAdapter(main);
    8.  
    9.  
    10.  
    11. 。。。。。。。。。。。。。。。。。。。。。。。。。。。。。
    12.  
    13.  
    14.         var intent = new Intent(main, main.getClass());
    15.         intent.addFlags(Intent.FLAG_ACTIVITY_SINGLE_TOP);
    16.         var pendingIntent = PendingIntent.getActivity(main, 0, intent, 0);
    17.         var ndef = new IntentFilter("android.nfc.action.TECH_DISCOVERED");
    18.         ndef.addDataType("*/*");
    19.         var intentFiltersArray = [ndef];
    20.         var techListsArray = [
    21.             ["android.nfc.tech.IsoDep"],
    22.             ["android.nfc.tech.NfcA"],
    23.             ["android.nfc.tech.NfcB"],
    24.             ["android.nfc.tech.NfcF"],
    25.             ["android.nfc.tech.Nfcf"],
    26.             ["android.nfc.tech.NfcV"],
    27.             ["android.nfc.tech.NdefFormatable"],
    28.             ["android.nfc.tech.MifareClassic"],
    29.             ["android.nfc.tech.MifareUltralight"]
    30.         ];
    31.         nfcAdapter.enableForegroundDispatch(main, pendingIntent, intentFiltersArray, techListsArray);

    这些就是一些跳转的设置，下半部分设置了跳转的启动方式为Intent.FLAG_ACTIVITY_SINGLE_TOP，并且设置了intent过滤器。

    下一步就是监听这些跳转，并处理放回的数据。于是在代码中可以看到下面的这些监听方法。

    1.         plus.globalEvent.addEventListener("newintent",
    2.             function() {
    3.                 setTimeout(handle_nfc_data1, 1000);
    4.             }, false);
    5.         plus.globalEvent.addEventListener("pause", function(e) {
    6.             if (nfcAdapter) {
    7.                 nfcAdapter.disableForegroundDispatch(main);
    8.             }
    9.         }, false);
    10.         plus.globalEvent.addEventListener("resume", function(e) {
    11.             if (nfcAdapter) {
    12.                 //console.log('resume'); 
    13.                 nfcAdapter.enableForegroundDispatch(main, pendingIntent, intentFiltersArray, techListsArray);
    14.             }
    15.         }, false);

    主要是“newintent"的监听，里面实现了主要的逻辑。

    手机识别到nfc跳转回到应用的时候，intent会携带返回的信息。进行判断是否是"android.nfc.action.TECH_DISCOVERED"。意味着识别到了信息。

    __read方法就是主要的处理信息的内容了，也是最重要的。

    intent.getParcelableExtra(NfcAdapter.EXTRA_TAG);将数据进行序列化。应用与应用直接传递数据，都要进行序列化和反序列化处理的。

    bytesToHexString将数据转换。

    上面内容是读取NFC标签卡的TAG标签ID值，如果是要读取NFC写入的MESSAGE信息。使用下面的方法进行替换。

    1. function __read(intent) {
    2.     try {
    3.         var content = "";
    4. 		waiting.setTitle('正在读取数据...');
    5. 		var tag = intent.getParcelableExtra(NfcAdapter.EXTRA_TAG);
    6. 		var messages = intent.getParcelableArrayExtra(NfcAdapter.EXTRA_NDEF_MESSAGES);
    7. 		console.log(messages)
    8. 		for (var i = 0; i < messages.length; i++) {
    9. 		  var message = messages[i];
    10. 		  if (message != null) {
    11. 			var records =  message.getRecords();
    12. 			
    13. 			// Loop through all NDEF records in the current NDEF message
    14. 			for (var j = 0; j < records.length; j++) {
    15. 			  var recordType = String(records[j].getType());
    16. 			  var payload = String(records[j].getPayload());
    17. 			  
    18. 			  // Decode payload to readable text
    19. 			  payload = decodeURIComponent(escape(payload));
    20. 			  // TPIM00010141
    21. 			  // Print out result
    22. 			  console.log("Record type: " + recordType);
    23. 			  // String.fromCharCode(parseInt(payload[i]))
    24. 			  // var Realpayload = payload.split(',').map(strItem => String.fromCharCode(parseInt(strItem))).join('')
    25. 			  let textEncoding = (payload[0] & 0x80) === 0 ? "UTF-8" : "UTF-16";
    26. 			  let languageCodeLength = payload[0] & 0x3F;
    27. 			  let textStartIndex = 1 + languageCodeLength;
    28. 			  let text = payload.split(',').slice(textStartIndex).map(strItem => String.fromCharCode(parseInt(strItem))).join('')
    29. 			  content = text
    30. 			}
    31. 		  }
    32. 		}
    33. 		waiting.close();
    34. 		var tagid = String(content)
    35.         if (typeof _getCardNo === 'function') {
    36.             _getCardNo(tagid);
    37.         }
    38.     } catch (e) {
    39. 		console.log(e)
    40.         uni.showToast({
    41.             title: e,
    42.             icon: 'none'
    43.         });
    44.     }
    45. }

    NFC的EXTRA_NDEF_MESSAGES有一个写入规则，payload中的真实数据，要从第三个字符开始读取。

    除了写入的内容外，前面两个的字符包含了内容的编码格式，每个字符的长度这些信息。

  • 相关阅读:
    【自然语言处理】利用python创建简单的聊天系统
    MyBatis 映射文件（Mapper XML）：配置与使用
    UNITY与安卓⭐二、AndroidStudio中关于通讯的使用教学
    Java 第二阶段提升编程能力【常用类】
    【洛谷 P5730】【深基5.例10】显示屏 题解（数组+循环）
    浅谈etcd服务注册与发现
    了解前端知识
    全网最牛自动化测试框架系列之pytest(6)-Fixture(固件)
    vue3 globalData 的使用方法
    数字藏品和ICP
  • 原文地址：https://blog.csdn.net/GhostPaints/article/details/127967951