NFC 只读演示 - 扫描并显示 NDEF 记录

NDEF（NFC Data Exchange Format，NFC 数据交换格式）是 NFC 论坛定义的标准化数据格式，用于在 NFC 设备之间交换数据。一个 NDEF 消息可以包含一条或多条 NDEF 记录，每条记录包含一个类型标识和实际数据负载。常见的记录类型包括：文本记录（TEXT）、URI 记录（URL链接）、智能海报（Smart Poster，可包含标题、链接、图标等）、MIME 类型记录（可嵌入任意二进制数据）等。NDEF 的标准化确保了不同厂商的 NFC 设备能够互相理解标签内容。

目前 Web NFC API 主要在 Google Chrome for Android 89+ 版本中得到支持。需要满足以下条件：① 使用 Android 设备并安装了 Chrome 浏览器；② 设备硬件支持 NFC；③ 网站通过 HTTPS 安全连接访问（或 localhost 本地开发环境）；④ 用户在浏览器弹窗中授予 NFC 权限。

不支持的环境：iOS（Safari 及 Chrome iOS 均不支持，因为 Apple 未开放 NFC 给 Web）、桌面端 Chrome/Edge/Firefox/Safari。在不支持的环境中，本工具提供演示模式供您体验。

市面上常见的 NFC 标签芯片包括：

• NTAG213 / NTAG215 / NTAG216（NXP 出品，最通用，存储容量从 144 字节到 888 字节不等，广泛用于门禁卡、商品标签、智能海报等）
• MIFARE Classic 1K/4K（NXP 出品，经典芯片，但部分版本不完全兼容 NDEF 标准格式）
• MIFARE Ultralight（低成本，常用于门票、一次性标签）
• DESFire（支持高级加密，用于支付和门禁系统）

所有这些标签都工作在 13.56 MHz 频率，读取距离通常在 1-4 厘米 以内。对于 NDEF 读取，NTAG 系列和 MIFARE Ultralight 兼容性最好。

如果扫描失败，请检查以下几点：

1. 标签位置：手机 NFC 天线通常位于背部摄像头附近或机身中部，请将标签紧贴该区域缓慢移动尝试。
2. 手机壳遮挡：厚重的手机壳（尤其是金属壳或含有磁吸支架的壳）可能屏蔽 NFC 信号，建议取下后重试。
3. NFC 功能未开启：请确保手机系统设置中 NFC 开关已打开。
4. 标签格式不兼容：部分标签（如未格式化的 MIFARE Classic）不包含有效的 NDEF 数据，需要使用写入工具先格式化。
5. 标签已损坏：尝试用另一部手机或专用读卡器测试标签是否正常工作。

NDEF 文本记录（TEXT RTD）的数据结构如下：

• 字节 0（状态字节）：Bit 7 表示编码方式（0=UTF-8，1=UTF-16）；Bits 5-0 表示语言代码的长度（通常为 2，如 "en"、"zh"）。
• 后续 N 字节：语言代码（如 en、zh-CN），长度由状态字节的低 6 位决定。
• 剩余字节：实际的文本内容，使用状态字节指定的编码方式。

例如，一个包含 "Hello" 的英文文本记录，其原始数据开头为：0x02（UTF-8，语言代码长度2）+ en + Hello 的 UTF-8 字节。

智能海报（Smart Poster RTD）是一种复合 NDEF 记录，内部嵌套多条子记录，用于描述一个完整的交互场景。常见子记录包括：

• URI 记录（必需）：海报指向的目标链接。
• 标题记录（可选，可多条）：不同语言的标题文本，如 "公司官网"。
• 图标记录（可选）：MIME 类型为 image/png 或 image/jpeg 的缩略图。
• 操作记录（可选）：建议的操作，如 "执行"、"保存"、"编辑"。
• 大小记录（可选）：目标资源的大小（字节数）。
• 类型记录（可选）：目标资源的 MIME 类型。

智能海报广泛应用于广告牌、产品标签等场景，用户扫描后可直接获取富媒体信息。

Web NFC API 设计了多层安全机制：

• HTTPS 强制：仅在安全上下文（HTTPS 或 localhost）下可用，防止中间人攻击。
• 用户手势要求：扫描操作必须由用户主动触发（如点击按钮），网页不能静默启动 NFC 扫描。
• 页面可见性：当页面被隐藏或切换到后台时，NFC 扫描自动暂停，防止后台偷读。
• 权限提示：浏览器会弹出明确的权限请求，用户可随时在浏览器设置中撤销 NFC 权限。
• 只读模式限制：本工具仅使用读取功能，不会修改或写入任何标签数据。

NDEF URI 记录使用一个字节的前缀代码来压缩常见 URI 前缀，节省标签存储空间。常用前缀代码：

代码	前缀
0x00	（无前缀，完整URI）
0x01	http://www.
0x02	https://www.
0x03	http://
0x04	https://
0x05	tel:
0x06	mailto:

例如，前缀代码 0x04 + 后缀 example.com = 完整 URI https://example.com。