浏览指南与章节
NFC Utils 指南
交通卡与 FeliCa
读取受支持卡片提供的卡内余额,查看其 FeliCa 系统,或使用读取预设。可用数据取决于卡片和发卡方。
读取受支持的余额
- 读取卡片,然后打开「工具」。应用会选定对应型号的交通卡工具页。
- 打开「余额」,查看可读取的卡内余额。
- 出示卡片后,用「再次读取」刷新余额。
| 卡片 | 值 |
|---|---|
| 八达通 | 港元。可读的负值余额显示为负数。 |
| 深圳通 | 受支持卡片中可读取的人民币余额。 |
| 日本 IC 卡 / Suica 系列 | 提供公开服务的受支持卡片上的日元金额。 |
| 八达通与深圳通 | 两个系统和服务都可读时,分别显示各自的卡内余额。 |
| 澳门通 | 以澳门币显示可消费余额,已扣除发卡方预留的 10 澳门币。 |
服务被拒绝或不可用并不意味着余额为零。应用报告它能读到的信息。
澳门通是澳门的储值卡,可用于巴士、轻轨、商店和餐厅。它不是 FeliCa 卡。NFC Utils 从卡片的公开文件中读取其电子钱包余额以及有效期的起始日和截止日,可使用手机天线,也可通过受支持的 USB 或蓝牙读卡器,无需密钥或账户。发卡方在卡片售出前会向电子钱包预留 10 澳门币,因此一次车资可以让余额降到零以下。应用会扣除这笔预留金额并显示可消费余额,与澳门通 App 显示的数字相同;「完整扫描」则在名为「发卡方预留金额」的独立一行中列出这笔金额。不提供行程记录、充值、卡面印刷的卡号和持卡人身份。

查看系统
一张 FeliCa 卡可以提供多个系统。「系统」显示返回的系统代码及其详情。「卡片详情」显示可用的卡片识别信息。「读取」标签页上的「完整扫描」提供更全面的读取结果。
每个系统都可以返回自己的 IDm,即后续命令使用的标识符。应用轮询所选系统并使用该标识符,八达通与深圳通双系统卡也是如此。
其他 FeliCa 卡的工具页提供「系统」、「卡片详情」和「原始命令」。不包含通用余额解码器。当卡片提供带可写属性块的 NDEF 系统(12FC)时,「写入」和「擦除」使用 Type 3 NDEF。「编辑存储块」在未加密的服务上读取或写入一个 16 字节的块,并进行回读。需要认证的服务无法读取或写入。

使用 FeliCa 读取预设
「原始命令」提供「轮询」、「请求系统代码」、「请求电子钱包服务」和「读取电子钱包公开数据」。选择系统和命令。应用在使用当前系统的 IDm 之前会重新轮询。电子钱包服务预设仅适用于八达通、深圳通和日本交通 IC 卡。
自定义帧包含 FeliCa 长度字节。无效的长度或过期的寻址标识符会被拒绝,但格式正确的自定义命令仍可能更改卡片。原始命令指南说明了帧格式。
选择读卡器
使用手机的 NFC 天线,或兼容的 USB 或 ACS 蓝牙读卡器。iPad 和 Mac 需要外置读卡器。应用在 Apple 和 Android 平台上支持通过 USB 和蓝牙读取八达通。
若已连接的读卡器检测不到 FeliCa 卡,请检查「轮询的卡片类型」。Apple 通过蓝牙更改受支持的 ACS 轮询设置,Android 还可以使用 USB 设置通道。请参阅读卡器轮询。
已知所连接的读卡器关闭了 FeliCa 轮询时,交通卡工具会在工具列表上方显示该提示,其中带有「读卡器设置」链接。


了解限制
这些工具读取受支持的公开信息。它们不充值、不转移余额、不更改电子钱包、不读取行程记录,也不获取受发卡方保护的持卡人身份。兼容的 FeliCa 芯片仍可能拒绝某项服务。
其他卡片即使支持 NXP 原厂签名验证,也不能据此认证交通卡电子钱包或发卡方账户。显示的余额是卡片上存储的可读值。