androidNfc

来自于:开发者立即使用

概述

androidNfc模块封装了安卓的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|false
}

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及更高版本