更新记录

1.0.3（2024-05-12）

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

1.0.2（2024-04-18）

新增iOS插件版本

1.0.1（2024-04-17）

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

平台兼容性

uni-app

uni-app x

概述

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>

2. 配置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及更高版本