被遗忘的黑科技？揭秘浏览器中神秘的 FMRadio API 事件！

原创于 2025-11-07 09:00:00 发布 · 331 阅读

2 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

标签

#科技 #javascript #前端

前端专栏收录该内容

234 篇文章

订阅专栏

警告：本文内容可能引发“原来还能这样？”的惊叹，也可能让你陷入“这玩意儿居然存在？”的沉思。

你有没有想过，你的网页不仅能播放音乐、控制摄像头，甚至——还能调频收听本地广播电台？

听起来像是科幻小说？但事实上，在某些特定平台和浏览器环境下，Web 开发者确实曾短暂拥有过一种名为 FMRadio API 的能力，它允许网页直接与设备的 FM 收音机硬件交互。

今天，我们就来揭开这个几乎被遗忘在 Web 标准角落里的“幽灵 API”——FMRadio API 及其相关事件，看看它到底是什么、为何昙花一现，以及它背后的技术逻辑是否仍有借鉴意义。

什么是 FMRadio API？

FMRadio API 并不是 W3C 或 WHATWG 官方标准的一部分，而是由 Mozilla 在 Firefox OS（现已停止维护）时代提出的一个实验性 Web API。它的目标非常明确：让 Web 应用能够访问设备内置的 FM 收音机功能，实现诸如：

打开/关闭 FM 收音机
调频到指定频率（如 98.5 MHz）
扫描可用频道
获取当前信号强度
监听频率变化、状态切换等事件

这一切都通过 JavaScript 接口暴露给开发者，使得一个简单的 HTML 页面就能变成一台“网络收音机”。

📌 注意：该 API 从未进入主流浏览器（如 Chrome、Safari、Edge），仅在 Firefox OS 的特定版本中可用，且随着 Firefox OS 项目于 2016 年终止，该 API 也基本退出了历史舞台。

FMRadio API 的核心事件有哪些？

虽然文档稀少，但从 Mozilla 当年的源码和开发者文档中可以梳理出几个关键事件（events）：

1. `enabled` 事件

当 FM 收音机成功开启时触发。

navigator.mozFMRadio.addEventListener('enabled', () => {
  console.log('FM 收音机已启用！');
});

2. `disabled` 事件

当 FM 收音机被关闭时触发。

navigator.mozFMRadio.addEventListener('disabled', () => {
  console.log('FM 收音机已关闭。');
});

3. `frequencychange` 事件

当前调频频率发生变化时触发（例如用户手动调台或自动扫描）。

navigator.mozFMRadio.addEventListener('frequencychange', (event) => {
  console.log('当前频率：', event.frequency, 'MHz');
});

4. `seekcomplete` 事件

当执行“自动搜台”（seek）操作完成后触发，通常会返回找到的下一个有效频率。

navigator.mozFMRadio.addEventListener('seekcomplete', (event) => {
  if (event.frequency) {
    console.log('找到新频道：', event.frequency);
  } else {
    console.log('未找到有效频道');
  }
});

5. `antennachange` 事件（部分设备支持）

当检测到天线插入或拔出时触发（因为多数 FM 收音机依赖耳机线作为天线）。

navigator.mozFMRadio.addEventListener('antennachange', (event) => {
  console.log('天线状态：', event.connected ? '已连接' : '未连接');
});

如何使用 FMRadio API？（历史代码示例）

以下是一个典型的使用流程（仅适用于当年的 Firefox OS 设备）：

// 检查是否支持
if ('mozFMRadio' in navigator) {
  const fm = navigator.mozFMRadio;

  // 开启 FM 收音机（需用户授权）
  fm.enable(98.5).then(() => {
    console.log('成功开启 FM，频率：98.5 MHz');
  }).catch(err => {
    console.error('开启失败：', err);
  });

  // 监听频率变化
  fm.addEventListener('frequencychange', e => {
    document.getElementById('current-freq').textContent = e.frequency;
  });

  // 向上搜台
  document.getElementById('seek-up').onclick = () => {
    fm.seekUp();
  };
} else {
  alert('当前环境不支持 FM 收音机 API！');
}