iOS NFC刷卡功能如何实现？iOS NFC开发全攻略

近场通信（NFC）技术为iOS应用带来了与物理世界互动的全新维度，它允许设备在几厘米范围内安全地交换数据、读取标签或模拟卡片，对于iOS开发者而言，掌握Core NFC框架是解锁门禁控制、信息交互、支付集成、资产追踪等丰富场景的关键。要在iOS应用中实现NFC功能，核心在于熟练运用Apple提供的Core NFC框架，通过配置正确的权限、处理NFC会话生命周期、解析或构建符合NDEF（NFC Data Exchange Format）标准的数据负载，并遵循苹果严格的隐私与后台限制策略。

加载中

苹果手机怎么添加NFC门禁卡？手机代替门禁卡教程

一分钟家事研究所

12.8万304180

原视频地址

核心功能与技术限制

• 读取NFC标签 (NFC Tag Reading)：这是Core NFC最基本也是最广泛使用的功能，应用可以读取嵌入在物品（如海报、产品包装、名片、工牌）中的被动NFC标签（NDEF格式），读取通常在应用处于前台且用户明确触发（如点击按钮）时进行。
• 读取NFC数据交换格式 (NDEF)：Core NFC主要专注于读取和解析符合NDEF标准的数据，NDEF消息由一个或多个NDEF记录组成，每个记录包含：
  • 类型名称格式 (TNF)：标识记录类型的分类（如NFC论坛定义的类型、外部类型、绝对URI、MIME类型等）。
  • 类型 (Type)：描述记录内容的更具体标识符（T 是文本记录，U 是URI记录，sp 是智能海报记录）。
  • 有效载荷 (Payload)：记录携带的实际数据（如URL字符串、文本内容、自定义二进制数据）。
• 写入NFC标签 (NFC Tag Writing – 部分支持)：从iOS 13开始，Core NFC支持写入可写的NFC标签（NDEF格式），开发者可以将自定义的NDEF消息写入到标签中，这需要标签本身是可写的（例如NTAG213, 215, 216等），且应用在前台由用户触发。
• 技术限制：
  • 设备要求：需要配备NFC读/写器的iPhone（iPhone 7及更新机型），iPhone 7/7 Plus仅支持读取（不支持写入）。
  • 后台限制：iOS严格限制NFC在后台的使用，应用在前台运行时才能发起NFC会话。唯一的例外是“后台标签读取”：如果应用注册了特定的NDEF记录类型（如URL、文本、通用控制记录），当用户将iPhone靠近包含该类型记录的标签时，系统会短暂唤醒应用（即使应用在后台或设备锁屏状态）并传递记录内容，这常用于快速启动应用特定功能。
  • 会话时长限制：单个NFC会话有超时限制（通常60秒左右），超时后需要用户重新触发。
  • 卡模拟限制：Core NFC 不支持将iPhone模拟为NFC标签或智能卡（如门禁卡、公交卡），此功能由Apple的Core NFC + Wallet框架（用于Apple Pay、交通卡）或CarKey等特定API实现，对第三方开发者开放极其有限（通常需要MFi认证或特定合作伙伴关系）。

开发环境准备

1. Xcode：使用最新稳定版本。
2. 设备：配备NFC读/写器的iPhone (iPhone 7或更新机型，写操作需iPhone XS/XR或更新且iOS 13+)，模拟器不支持NFC测试。
3. 添加Capability：
   • 在Xcode中打开你的项目。
   • 选择你的应用Target。
   • 转到 Signing & Capabilities 标签页。
   • 点击 + Capability。
   • 搜索并添加 Near Field Communication Tag Reading，这会自动在项目配置和 Entitlements 文件中添加必要的权限。
4. 配置Info.plist：
   • 必须提供使用NFC的原因描述,否则应用会被拒绝或在运行时崩溃。
   • 添加键 NFCReaderUsageDescription (或 Privacy - NFC Scan Usage Description)，值为字符串（“扫描NFC标签以获取产品信息”或“读取工牌进行身份验证”）。
   • 对于后台标签读取，还需额外配置：
     • 添加键 com.apple.developer.nfc.readersession.iso7816.select-identifiers (Array类型)。
     • 在这个数组中添加你的应用希望系统在后台唤醒它时能处理的NDEF记录类型对应的应用ID（Application IDs），你需要注册你希望处理的特定URI协议方案（如 myapp://）、MIME类型或NFC论坛外部记录类型（需反向域名格式，如 com.example.mytype），这告诉系统：“当检测到包含这种记录的标签时，请唤醒我的应用来处理”。

实战场景：NFC标签读取

1. 导入框架：

   import CoreNFC

2. 检查设备支持：

   

   guard NFCNDEFReaderSession.readingAvailable else {
       // 设备不支持NFC或系统版本过低
       showAlert("此设备不支持NFC标签读取功能。")
       return
   }

3. 创建并启动NDEF读取会话：

   class NFCReaderViewController: UIViewController, NFCNDEFReaderSessionDelegate {
       var nfcSession: NFCNDEFReaderSession?
       @IBAction func startScanning(_ sender: UIButton) {
           // 创建一个新的NDEF读取会话，指定委托和是否在检测到标签后暂停（true会暂停，false会连续读取）
           nfcSession = NFCNDEFReaderSession(delegate: self, queue: nil, invalidateAfterFirstRead: true)
           nfcSession?.alertMessage = "将iPhone靠近NFC标签..." // 会话期间显示的提示信息
           nfcSession?.begin() // 开始会话，系统会显示扫描界面
       }
       // MARK: - NFCNDEFReaderSessionDelegate
       // 会话因错误或用户取消而失效时调用
       func readerSession(_ session: NFCNDEFReaderSession, didInvalidateWithError error: Error) {
           // 处理错误（如session超时、用户取消、设备不支持、权限问题）
           DispatchQueue.main.async {
               if let nfcError = error as? NFCReaderError {
                   switch nfcError.code {
                   case .readerSessionInvalidationErrorUserCanceled:
                       // 用户主动取消
                       break
                   default:
                       self.showAlert("NFC会话出错: (nfcError.localizedDescription)")
                   }
               }
           }
           self.nfcSession = nil // 释放会话
       }
       // 成功检测到NDEF标签并读取到消息时调用
       func readerSession(_ session: NFCNDEFReaderSession, didDetectNDEFs messages: [NFCNDEFMessage]) {
           // 一个标签可能包含多条NDEF记录（messages数组可能有多个元素，但通常一个标签对应一个message）
           for message in messages {
               for record in message.records {
                   // 解析每条NDEF记录
                   self.processNDEFRecord(record)
               }
           }
           // 如果invalidateAfterFirstRead=true，会话会自动结束，否则需要手动session.invalidate()
       }
       // 处理单条NDEF记录的核心方法
       private func processNDEFRecord(_ record: NFCNDEFRecord) {
           DispatchQueue.main.async {
               switch record.typeNameFormat {
               case .nfcWellKnown:
                   // 处理NFC论坛预定义类型
                   if let typeString = String(data: record.type, encoding: .ascii) {
                       switch typeString {
                       case "T": // 文本记录
                           self.handleTextRecord(record.payload)
                       case "U": // URI记录
                           self.handleURIRecord(record.payload)
                       case "Sp": // 智能海报记录 (通常包含URL和文本/标题)
                           // 智能海报记录本身是一个NDEF消息，需要递归解析
                           if let spMessage = try? NFCNDEFMessage(data: record.payload) {
                               for spRecord in spMessage.records {
                                   self.processNDEFRecord(spRecord) // 递归解析内部记录
                               }
                           }
                       default:
                           print("未知的Well Known类型: (typeString)")
                       }
                   }
               case .absoluteURI:
                   // 绝对URI记录（整个payload就是URI字符串）
                   if let uriString = String(data: record.payload, encoding: .utf8) {
                       self.handleAbsoluteURI(uriString)
                   }
               case .media:
                   // MIME类型记录 (record.type 包含MIME类型字符串)
                   if let mimeType = String(data: record.type, encoding: .utf8),
                      let payloadData = record.payload {
                       self.handleMediaRecord(mimeType: mimeType, data: payloadData)
                   }
               case .nfcExternal:
                   // NFC论坛外部记录类型 (自定义类型，通常以反向域名格式定义在record.type中)
                   if let externalType = String(data: record.type, encoding: .utf8),
                      let payloadData = record.payload {
                       self.handleExternalRecord(type: externalType, data: payloadData)
                   }
               case .empty, .unchanged, .unknown, .reserved:
                   // 通常忽略或简单记录
                   print("未处理或未知的记录类型格式: (record.typeNameFormat)")
               @unknown default:
                   break
               }
           }
       }
       // 示例：解析文本记录 (Payload结构: [状态字节(包含语言编码长度)][ISO/IANA语言码][实际文本])
       private func handleTextRecord(_ payload: Data) {
           guard payload.count > 1 else { return }
           let statusByte = payload[0]
           let languageCodeLength = Int(statusByte & 0x3F) // 低6位表示语言码长度
           guard payload.count > languageCodeLength else { return }
           if let languageCode = String(data: payload.subdata(in: 1..<(1 + languageCodeLength)), encoding: .utf8),
              let text = String(data: payload.subdata(in: (1 + languageCodeLength)..<payload.count), encoding: .utf8) {
               print("文本 ((languageCode)): (text)")
               // 更新UI显示文本
           }
       }
       // 示例：解析URI记录 (Payload结构: [URI标识码][URI字符串])
       private func handleURIRecord(_ payload: Data) {
           guard !payload.isEmpty else { return }
           let uriIdentifier = payload[0]
           let uriSuffix = String(data: payload.subdata(in: 1..<payload.count), encoding: .utf8) ?? ""
           var fullURI: String
           // 根据NFC论坛URI标识码表解析前缀
           switch uriIdentifier {
           case 0x00: fullURI = uriSuffix // 无前缀
           case 0x01: fullURI = "http://www.(uriSuffix)"
           case 0x02: fullURI = "https://www.(uriSuffix)"
           case 0x03: fullURI = "http://(uriSuffix)"
           case 0x04: fullURI = "https://(uriSuffix)"
           case 0x05: fullURI = "tel:(uriSuffix)"
           case 0x06: fullURI = "mailto:(uriSuffix)"
           case 0x07: fullURI = "ftp://anonymous:anonymous@(uriSuffix)"
           case 0x08: fullURI = "ftp://ftp.(uriSuffix)"
           case 0x09: fullURI = "ftps://(uriSuffix)"
               // ... 其他标识码参考NFC论坛规范
           default:
               // 0x0A - 0x1F 保留，0x20 - 0xFF 为自定义URI协议，通常直接拼接
               if uriIdentifier >= 0x20 {
                   if let prefix = String(data: Data([uriIdentifier]), encoding: .ascii) {
                       fullURI = prefix + uriSuffix
                   } else {
                       fullURI = uriSuffix
                   }
               } else {
                   fullURI = uriSuffix
               }
           }
           print("URI: (fullURI)")
           // 处理URI（如打开网页、拨打电话、发邮件等）
       }
       // ... 其他记录类型的处理方法（handleMediaRecord, handleExternalRecord等）类似
   }

进阶应用：NFC数据写入

1. 前提：确保设备支持（iPhone XS/XR或更新，iOS 13+），标签是可写的NDEF标签。

2. 创建NDEF消息：

   // 创建一个包含一条文本记录的NDEF消息
   func createTextNDEFMessage(text: String, languageCode: String = "en") -> NFCNDEFMessage? {
       // 1. 创建文本记录负载: [状态字节][语言码][文本]
       let statusByte: UInt8 = UInt8(languageCode.count) // 假设只用了低6位，UTF-8编码
       var payload = Data([statusByte])
       payload.append(contentsOf: languageCode.utf8)
       payload.append(contentsOf: text.utf8)
       // 2. 创建文本记录 (TNF=.nfcWellKnown, Type="T")
       guard let textRecord = NFCNDEFPayload(
           format: .nfcWellKnown,
           type: "T".data(using: .ascii)!, // "T" for Text
           identifier: Data(), // 标识符通常为空
           payload: payload
       ) else {
           print("创建文本记录失败")
           return nil
       }
       // 3. 将记录放入消息
       return NFCNDEFMessage(records: [textRecord])
   }
   // 创建一个包含一条URI记录的NDEF消息 (使用https://)
   func createURINDEFMessage(urlString: String) -> NFCNDEFMessage? {
       // 1. 处理URI前缀标识码 (这里简化，假设是完整的https://开头)
       var uriPayload = Data()
       let prefixCode: UInt8 = 0x04 // 代表 "https://"
       uriPayload.append(prefixCode)
       uriPayload.append(contentsOf: urlString.dropFirst(8).utf8) // 移除"https://" (8字符)
       // 2. 创建URI记录 (TNF=.nfcWellKnown, Type="U")
       guard let uriRecord = NFCNDEFPayload(
           format: .nfcWellKnown,
           type: "U".data(using: .ascii)!, // "U" for URI
           identifier: Data(),
           payload: uriPayload
       ) else {
           print("创建URI记录失败")
           return nil
       }
       return NFCNDEFMessage(records: [uriRecord])
   }

3. 创建并启动NDEF写入会话：

   

   class NFCWriterViewController: UIViewController, NFCNDEFReaderSessionDelegate {
       var nfcSession: NFCNDEFReaderSession?
       var messageToWrite: NFCNDEFMessage? // 要写入的NDEF消息
       @IBAction func startWriting(_ sender: UIButton) {
           guard let message = createTextNDEFMessage(text: "你好，NFC世界！") else { // 或 createURINDEFMessage
               showAlert("创建要写入的消息失败")
               return
           }
           messageToWrite = message
           // 创建支持写入的会话
           nfcSession = NFCNDEFReaderSession(delegate: self, queue: nil, invalidateAfterFirstRead: false) // 设置为false以便写入
           nfcSession?.alertMessage = "将iPhone靠近可写的NFC标签进行写入..."
           nfcSession?.begin()
       }
       // MARK: - NFCNDEFReaderSessionDelegate (didInvalidateWithError同上)
       // 检测到标签（可能是读也可能是写）
       func readerSession(_ session: NFCNDEFReaderSession, didDetectNDEFs messages: [NFCNDEFMessage]) {
           // 写入操作通常不需要处理读取到的消息，除非你想先读取再覆盖
           session.alertMessage = "检测到标签，准备写入..."
       }
       // 检测到标签（更通用的方法，iOS 11后推荐）
       func readerSession(_ session: NFCNDEFReaderSession, didDetect tags: [NFCNDEFTag]) {
           guard let tag = tags.first else { // 通常处理检测到的第一个标签
               session.invalidate(errorMessage: "未检测到有效标签或检测到多个标签。")
               return
           }
           session.connect(to: tag) { [weak self] (error: Error?) in
               guard error == nil else {
                   session.invalidate(errorMessage: "连接标签失败: (error!.localizedDescription)")
                   return
               }
               // 1. 查询标签容量和可写性
               tag.queryNDEFStatus { (status: NFCNDEFStatus, capacity: Int, error: Error?) in
                   guard error == nil else {
                       session.invalidate(errorMessage: "查询标签状态失败")
                       return
                   }
                   guard status == .readWrite || status == .readWriteMBR else {
                       session.invalidate(errorMessage: "标签不可写或状态不支持写入 ((status))")
                       return
                   }
                   guard let message = self?.messageToWrite,
                         message.length <= capacity else {
                       session.invalidate(errorMessage: "要写入的消息 ((messageToWrite?.length ?? 0) 字节) 超出标签容量 ((capacity) 字节)")
                       return
                   }
                   // 2. 执行写入操作
                   tag.writeNDEF(message) { (error: Error?) in
                       if let error = error {
                           session.invalidate(errorMessage: "写入失败: (error.localizedDescription)")
                       } else {
                           session.alertMessage = "写入成功！"
                           session.invalidate() // 手动结束会话
                       }
                   }
               }
           }
       }
   }

行业应用与创新思考

• 零售与营销：产品包装上的NFC标签，扫描获取详细信息、防伪验证、促销链接、视频展示。
• 智能家居/物联网：轻触NFC标签配置Wi-Fi设备（如智能灯泡、插座）、触发场景（如“晚安模式”）。
• 身份认证与门禁：读取员工卡/学生证信息进行身份验证（需后端配合），简化签到流程。
• 物流与资产管理：追踪货物位置、读取资产标签信息进行盘点和维护记录。
• 文化展览与旅游：博物馆展品旁的标签提供多语言解说、视频资料；景点导览地图。
• 创意交互：艺术装置、互动海报、游戏道具。

专业建议与避坑指南

1. 用户体验至上：明确告知用户何时需要靠近标签，提供清晰的扫描提示和反馈（成功/失败），避免让用户“盲扫”。
2. 优雅处理错误：全面处理各种可能的错误情况（设备不支持、无权限、标签不支持、读写失败、超时、用户取消），给予友好的错误提示。
3. 后台读取精确定义：仔细规划你的“后台标签读取”策略，只注册真正需要唤醒应用的特定记录类型，避免滥用导致用户困扰或电池消耗，后台读取传递的数据量有限，设计轻量级的启动逻辑。
4. 安全与隐私：
   • 绝不在NDEF标签中存储敏感信息（密码、个人身份信息），使用标签作为“钥匙”去安全地获取后端数据。
   • 对读取到的外部数据（尤其是URL）进行严格验证和清理，防止注入攻击。
   • 清晰告知用户应用如何使用NFC数据。
5. 优化写入流程：写入操作比读取更易出错（标签位置移动、标签不可写、容量不足），确保用户界面有明确的写入状态指示和错误恢复机制。
6. 兼容性与测试：在不同型号的iPhone和不同类型的NFC标签上进行充分测试，注意旧机型（iPhone 7）的功能限制。
7. 探索自定义格式：在NDEF标准框架内（尤其是使用nfcExternal或media类型），可以定义应用专属的数据结构进行更复杂的交互。

掌握iOS NFC开发，意味着你能够为你的应用构建无缝连接数字与物理世界的桥梁，从简单的信息获取到复杂的交互流程，Core NFC框架提供了稳定而强大的基础，关键在于理解其运作机制、遵循平台规范、注重用户体验，并充分发挥创造力去解决实际问题。

你的NFC应用构想是什么？你打算利用它来解决哪个具体的场景痛点？或者你在开发过程中遇到了哪些独特的挑战？欢迎在评论区分享你的想法和经验！