androidNfc

立即使用

nfcGetId nfcRead nfcWrite

论坛示例

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

概述

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

nfcGetId

得到NFC标签卡号

nfcGetId(callback(ret, err))

callback(ret, err)

ret：

  • 类型：JSON 对象

内部字段：

{
    status:    //布尔型；true|false
    cardId:    //得到NFC标签的卡号（将android的byte数据类型转为16进制字符串）
}

err：

  • 类型：JSON 对象

内部字段：

{
    msg:    //返回错误信息
}

示例代码

var androidNfc= api.require('androidNfc');
androidNfc.nfcGetId(function( ret, err ){
    if (ret.status) {
        console.log(JSON.stringify(ret));
        alert(JSON.stringify("读取的卡号：" + ret.cardId));
    } else {
        console.log(JSON.stringify(err));
        alert(JSON.stringify("错误信息：" + err.msg));
    }
});

补充说明

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

可用性

Android系统

可提供的1.0.0及更高版本

nfcRead

读取NFC标签文本数据

nfcRead(callback(ret, err))

callback(ret, err)

ret：

  • 类型：JSON 对象

内部字段：

{
    status:    //布尔型；true|false
    readResult:    //得到NFC标签NDEF文本格式数据
}

err：

  • 类型：JSON 对象

内部字段：

{
    msg:    //返回错误信息
}

示例代码

var androidNfc= api.require('androidNfc');
androidNfc.nfcRead(function( ret, err ){
    if (ret.status) {
        console.log(JSON.stringify(ret));
        alert(JSON.stringify("读取的结果：" + ret.readResult));
    } else {
        console.log(JSON.stringify(err));
        alert(JSON.stringify("错误信息：" + err.msg));
    }
});

补充说明

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

可用性

Android系统

可提供的1.0.0及更高版本

nfcWrite

写入NFC标签文本数据

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

params

appParam：

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

callback(ret, err)

ret：

  • 类型：JSON 对象

内部字段：

{
    status:    //成功返回true
}

err：

  • 类型：JSON 对象

内部字段：

{
    msg:    //返回错误信息
}

示例代码

var androidNfc= api.require('androidNfc');
var param = {appParam: "Hello Taony"};
    if (ret.status) {
        console.log(JSON.stringify(ret));
        alert(JSON.stringify("写入的结果：" + ret.status));
    } else {
        console.log(JSON.stringify(err));
        alert(JSON.stringify("错误信息：" + err.msg));
    }

补充说明

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

可用性

Android系统

可提供的1.0.0及更高版本