如何利用JavaScript的Web NFC API进行近场通信?

Web NFC API目前处于实验阶段,仅在部分支持NFC的设备和Chromium浏览器中可用,需通过'NDEFReader' in window检测支持性;其主要功能包括使用NDEFReader.scan()扫描NFC标签、监听reading事件读取数据以及调用write()方法写入数据,但不支持设备间点对点通信;实际应用中需确保硬件支持、用户授权及标签可写,并在真实环境中充分测试。

目前,JavaScript 的 Web NFC API 仍处于实验阶段,支持有限,仅在部分浏览器和设备上可用。若你的目标环境满足条件,可以按以下方式尝试使用 Web NFC 实现近场通信。

了解 Web NFC API 的基本能力

Web NFC 允许网页读取和写入 NFC 标签,实现与物理世界交互,比如扫描门禁卡信息、读取产品标签或触发动作。它不支持设备间点对点通信(如安卓 Beam),主要面向标签读写。

关键功能包括:

  • NFCReader.scan():启动扫描,等待发现兼容的 NFC 标签
  • reading 事件:当读取到标签数据时触发
  • write():向 NFC 标签写入数据

检查浏览器与设备支持情况

Web NFC 目前仅在部分 Chromium 内核浏览器中实验性支持,例如 Chrome for Android(需开启 flag),且要求设备有 NFC 硬件并启用。

使用前先检测是否可用:

if ('NDEFReader' in window) {
  console.log('Web NFC 支持');
} else {
  console.log('当前环境不支持 Web NFC');
}

读取 NFC 标签数据

通过 NDEFReader 启动扫描,监听 reading 事件获取内容。NDEF(NFC Data Exchange Format)是标准的数据格式。

const ndef = new NDEFReader();
try {
  await ndef.scan();
  ndef.onreading = event => {
    console.log('接收到消息:', event.message);
    for (const record of event.message.records) {
      if (record.recordType === 'text') {
        const text = record.toText();
        console.log('文本内容:', text);
      }
    }
  };
} catch (error) {
  console.error('扫描失败:', error);
}

向 NFC 标签写入数据

确保标签可写后,使用 write() 方法传入 NDEF 记录。

try {
  await ndef.write({
    records: [
      { recordType: "text", data: "Hello NFC" }
    ]
  });
  console.log('写入成功');
} catch (error) {
  console.error('写入失败:', error);
}

注意:写入操作可能因标签只读或距离过远而失败。

基本上就这些。Web NFC 使用简单,但依赖系统权限和硬件支持,上线前务必充分测试真实环境。