更新记录

1.0.3(2024-05-12)

修复iOS判断是否支持NFC功能接口逻辑

1.0.2(2024-04-18)

新增iOS插件版本

1.0.1(2024-04-17)

优化Android识别页面标题展示效果。

查看更多

平台兼容性

Vue2 Vue3
App 快应用 微信小程序 支付宝小程序 百度小程序 字节小程序 QQ小程序
HBuilderX 3.6.8,Android:5.0,iOS:11,HarmonyNext:不确定 × × × × × ×
钉钉小程序 快手小程序 飞书小程序 京东小程序
× × × ×
H5-Safari Android Browser 微信浏览器(Android) QQ浏览器(Android) Chrome IE Edge Firefox PC-Safari
× × × × × × × × ×

概述

XF-nfcUTS封装在安卓下对NFC下的NDEF文本数据读写和iOS下对NFC下的NDEF文本数据读取。

iOS配置

  1. 证书需要匹配 com.apple.developer.nfc.readersession.formats 权限。
<key>com.apple.developer.nfc.readersession.formats</key>
<array>
    <string>TAG</string>
    <string>NDEF</string>
</array>
  1. 配置Privacy - NFC Scan Usage Description权限。

插件接口

readingAvailable

判断设备是否支持NFC(iOS请在初始化之前进行验证)

uni-app项目中(nvue)调用示例:

import { readingAvailable } from "@/uni_modules/XF-nfcUTS"

readingAvailable();

uni-app x项目(uvue)中调用示例:

import { readingAvailable } from "@/uni_modules/XF-nfcUTS";

readingAvailable();

可用性

iOS、Android系统

可提供的1.0.0及更高版本

setConfig

配置读写标签界面UI元素(不执行本接口则选用模块默认UI布局方案)

uni-app项目中(nvue)调用示例:

import { setConfig } from "@/uni_modules/XF-nfcUTS"

setConfig({
  complete: (res) => {
        console.log(res)
  }
});

uni-app x项目(uvue)中调用示例:

import { setConfig } from "@/uni_modules/XF-nfcUTS";
import { ConfigOptions } from "@/uni_modules/XF-nfcUTS/utssdk/interface.uts";

let options = {
  complete: (res : any) => {
    console.log(res)
  }
} as ConfigOptions;
setConfig(options);

可用性

iOS、Android系统

可提供的1.0.0及更高版本

writeText

写入数据

uni-app项目中(nvue)调用示例:

import { writeText } from "@/uni_modules/XF-nfcUTS"

writeText({
  complete: (res) => {
        console.log(res)
  }
});

uni-app x项目(uvue)中调用示例:

import { writeText } from "@/uni_modules/XF-nfcUTS";
import { WriteOptions } from "@/uni_modules/XF-nfcUTS/utssdk/interface.uts";

let options = {
  complete: (res : any) => {
    console.log(res)
  }
} as WriteOptions;
writeText(options);

可用性

iOS、Android系统

可提供的1.0.0及更高版本

readText

读取数据

uni-app项目中(nvue)调用示例:

import { readText } from "@/uni_modules/XF-nfcUTS"

readText({
  complete: (res) => {
        console.log(res)
  }
});

uni-app x项目(uvue)中调用示例:

import { readText } from "@/uni_modules/XF-nfcUTS";
import { ReadOptions } from "@/uni_modules/XF-nfcUTS/utssdk/interface.uts";

let options = {
  complete: (res : any) => {
    console.log(res)
  }
} as ReadOptions;
readText(options);

可用性

iOS、Android系统

可提供的1.0.0及更高版本

隐私、权限声明

1. 本插件需要申请的系统权限列表:

android.permission.NFC Privacy - NFC Scan Usage Description

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问