更新记录

1.0.2（2025-07-11）

更新调用说明

1.0.1（2025-07-11）

更新赞赏图片

1.0.0（2025-07-11）

首次发布

平台兼容性

uni-app x

bsx-nfc-page 是实现Android 端读写M1的NFC能力的UTS API插件示例

版本

1.0.0（2025-07-11）

首次发布

重要

• 此插件是UTS API；支持Android NFC 能力
• 此插件只是示例，不要上线生产
• 此插件仅提供参考，具体业务可自行扩展开发
• 此插件提供源码作为学习交流

开发文档

UTS API插件

作者

aoaobaba 爱多玩~

介绍

bs-nfc-page 是uniapp x开发的UTS API插件；作者答应了群友实现nfc, 花了一天时间完成了此插件。插件代码仅作为开发示例，实现了Android端的NFC 能力，代码实现了读取或写入 M1卡信息。作者也是小白，没有android开发的经验，代码质量不好，请见谅。

相关知识作者也是一步步搜索了解，结合官方demo示例，自我思考学习的；也鼓励大家一起加油，别轻易放弃，享受解决问题过程中的快乐。

总结要点

1. uniapp-x 内部封装了几个固定的activity class, 参考 x的几个activity
2. 想要使用设备的nfc功能，需要activity的onNewIntent 回调，主要用于响应设备发出的NFC 信息。而官方的activity不提供该回调。故需要自定义activity实现。
3. 自定义activity 必需使用原生开发UI层，不能使用uvue。
4. 不同Activity之间的数据通信（这里指你新建的activity与官方的activity），可以使用intent再补充实现。

插件目录和文件详细介绍

uni_modules - bsx-nfc-page
uni_modules - bsx-nfc-page - utssdk
uni_modules - bsx-nfc-page - utssdk - android
uni_modules - bsx-nfc-page - utssdk - android - res
uni_modules - bsx-nfc-page - utssdk - android - res - layout - nfc_activity.xml
自定义Activity的UI布局组件（ai生成）
uni_modules - bsx-nfc-page - utssdk - android - res - xml - nfc_tech_filter.xml
nfc特定技术类型过滤，这里可以配置支持的NFC 类型（ai生成）
uni_modules - bsx-nfc-page - utssdk - android - AndroidManifest.xml
插件清单文件，包含权限、activity的配置
uni_modules - bsx-nfc-page - utssdk - android - bsxNfcActivity.kt
kotlin实现的自定义activity 类（代码完全使用ai生成，未作改动）
uni_modules - bsx-nfc-page - utssdk - android - index.uts
实现暴露的api 用于调起nfc页面（具体实现参考了官方的demo uts-nativepage）

调用

uvue页面中导入插件API, 调用唤起nfc页面即可

import { gotoBsxNfcActivity } from '@/uni_modules/bsx-nfc-page'

const gotoNfcPage = () => {
    const bool = gotoBsxNfcActivity()
    console.log('------', bool)
}

权限

参考插件清单

tips 觉得不错请我喝杯咖啡吧~ (●'◡'●)