SuperAPI AI 工具集

core-nfc

通用与其它

查看项目

更新于 10-16 05:52

技能介绍

用途:在 iPhone 上使用 CoreNFC 读写 NFC 标签,支持 NDEF 标签读取会话、ISO 7816/15693/FeliCa/MIFARE 原生标签通信以及后台标签读取。

配置与权限:在 Xcode 中启用 Near Field Communication Tag Reading 能力;在 Info.plist 添加 NFCReaderUsageDescription;将 entitlement com.apple.developer.nfc.readersession.formats 设为 ["TAG"](不要使用旧版 NDEF)。ISO 7816 标签需在 com.apple.developer.nfc.readersession.iso7816.select-identifiers 添加应用标识符;FeliCa 标签需在 com.apple.developer.nfc.readersession.felica.systemcodes 指定精确系统码(不支持通配符)。展示 NFC 界面前应检查 NFCNDEFReaderSession.readingAvailable。

主要能力:使用 NFCNDEFReaderSession 读取 NDEF 标签;使用 NFCTagReaderSession 连接标签并写入 NDEF 消息;通过 NFCNDEFPayload 构造 URI、文本等标准化载荷并组合为 NFCNDEFMessage;支持的 iPhone 在亮屏时持续扫描含 URL 载荷的 NDEF 标签,可通过 Universal Link 直接打开应用,用 SwiftUI .onOpenURL 或 UIKit scene(_:openURLContexts:) 处理。

常见错误:使用旧版 NDEF entitlement 值;成功后未调用 session.invalidate() 导致系统 NFC 提示一直显示;未检查可用性就调用 NFC API;忽略 60 秒会话超时(需处理 readerSessionInvalidationErrorSessionTimeout);向只读标签写入前未用 ndefTag.queryNDEFStatus 确认 .readWrite 状态。

限制:需具备 NFC 能力的真机,模拟器或不支持硬件会报错;会话有超时限制;写入前必须校验标签状态。扩展模式见 references/nfc-patterns.md。