androidNfc

立即使用

nfcGetId nfcRead nfcWrite

论坛示例

为帮助用户更好更快的使用模块,论坛维护了一个示例,示例中包含示例代码供您参考。

概述

nfc模块封装了安卓的NFC功能,使用此模块可实现安卓设备对NFC标签读取卡号和对支持NDEF文本格式的NFC标签进行文本数据的读写(支持android5.0及以上版本)。暂仅支持 android 平台。

nfcGetId

得到NFC标签卡号

nfcGetId(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON 对象

内部字段:

  1. {
  2. status: //布尔型;true|false
  3. cardId: //得到NFC标签的卡号(将android的byte数据类型转为16进制字符串)
  4. }

err:

  • 类型:JSON 对象

内部字段:

  1. {
  2. msg: //返回错误信息
  3. }

示例代码

  1. var androidNfc= api.require('androidNfc');
  2. androidNfc.nfcGetId(function( ret, err ){
  3. if (ret.status) {
  4. console.log(JSON.stringify(ret));
  5. alert(JSON.stringify("读取的卡号:" + ret.cardId));
  6. } else {
  7. console.log(JSON.stringify(err));
  8. alert(JSON.stringify("错误信息:" + err.msg));
  9. }
  10. });

补充说明

得到的卡号是将android的byte类型转换为16进制字符串类型返回

可用性

Android系统

可提供的1.0.0及更高版本

nfcRead

读取NFC标签文本数据

nfcRead(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON 对象

内部字段:

  1. {
  2. status: //布尔型;true|false
  3. readResult: //得到NFC标签NDEF文本格式数据
  4. }

err:

  • 类型:JSON 对象

内部字段:

  1. {
  2. msg: //返回错误信息
  3. }

示例代码

  1. var androidNfc= api.require('androidNfc');
  2. androidNfc.nfcRead(function( ret, err ){
  3. if (ret.status) {
  4. console.log(JSON.stringify(ret));
  5. alert(JSON.stringify("读取的结果:" + ret.readResult));
  6. } else {
  7. console.log(JSON.stringify(err));
  8. alert(JSON.stringify("错误信息:" + err.msg));
  9. }
  10. });

补充说明

得到的是NFC标签NDEF文本格式的数据

可用性

Android系统

可提供的1.0.0及更高版本

nfcWrite

写入NFC标签文本数据

nfcWrite({params}, callback(ret, err))

params

appParam:

  • 类型:字符串
  • 描述:(必填项)要写入NFC标签NDEF文本格式的字符串内容。

callback(ret, err)

ret:

  • 类型:JSON 对象

内部字段:

  1. {
  2. status: //成功返回true
  3. }

err:

  • 类型:JSON 对象

内部字段:

  1. {
  2. msg: //返回错误信息
  3. }

示例代码

  1. var androidNfc= api.require('androidNfc');
  2. var param = {appParam: "Hello Taony"};
  3. if (ret.status) {
  4. console.log(JSON.stringify(ret));
  5. alert(JSON.stringify("写入的结果:" + ret.status));
  6. } else {
  7. console.log(JSON.stringify(err));
  8. alert(JSON.stringify("错误信息:" + err.msg));
  9. }

补充说明

将字符串写入到NFC标签,返回写入结果

可用性

Android系统

可提供的1.0.0及更高版本