Web Bluetooth 项目教程

2026-01-23 04:57:42作者：范垣楠Rhoda

1. 项目介绍

Web Bluetooth 是一个由 W3C Web Bluetooth 社区组开发的开源项目，旨在为 Web 应用提供蓝牙支持。该项目允许开发者通过 Web 浏览器与蓝牙设备进行交互，从而扩展了 Web 应用的功能范围。Web Bluetooth 项目的主要目标是提供一个标准化的 API，使得开发者能够轻松地在 Web 应用中集成蓝牙功能。

2. 项目快速启动

2.1 环境准备

在开始之前，请确保你的浏览器支持 Web Bluetooth API。目前，Chrome 和 Edge 等基于 Chromium 的浏览器对 Web Bluetooth 的支持较好。

2.2 基本代码示例

以下是一个简单的示例代码，展示了如何使用 Web Bluetooth API 连接并读取蓝牙设备的数据。

<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <title>Web Bluetooth 示例</title>
</head>
<body>
    <button id="connectButton">连接蓝牙设备</button>
    <p id="status"></p>

    <script>
        document.getElementById('connectButton').addEventListener('click', function() {
            navigator.bluetooth.requestDevice({ filters: [{ services: ['battery_service'] }] })
                .then(device => {
                    document.getElementById('status').innerText = '已连接到设备: ' + device.name;
                    return device.gatt.connect();
                })
                .then(server => server.getPrimaryService('battery_service'))
                .then(service => service.getCharacteristic('battery_level'))
                .then(characteristic => characteristic.readValue())
                .then(value => {
                    let batteryLevel = value.getUint8(0);
                    document.getElementById('status').innerText += '\n电池电量: ' + batteryLevel + '%';
                })
                .catch(error => {
                    document.getElementById('status').innerText = '错误: ' + error;
                });
        });
    </script>
</body>
</html>

2.3 运行代码

将上述代码保存为一个 HTML 文件，例如 index.html。
使用支持 Web Bluetooth 的浏览器打开该文件。
点击“连接蓝牙设备”按钮，选择你要连接的蓝牙设备。
如果连接成功，页面将显示设备的名称和电池电量。

3. 应用案例和最佳实践

3.1 智能家居控制

Web Bluetooth 可以用于开发智能家居控制应用。例如，通过 Web 应用控制家中的智能灯泡、温度传感器等设备。开发者可以使用 Web Bluetooth API 与这些设备进行通信，实现远程控制和监控。

3.2 健康与健身

在健康与健身领域，Web Bluetooth 可以用于连接心率监测器、运动手环等设备。通过 Web 应用，用户可以实时查看自己的健康数据，并进行分析和管理。

3.3 工业自动化

在工业自动化领域，Web Bluetooth 可以用于连接各种传感器和控制器。通过 Web 应用，工程师可以远程监控和控制生产线上的设备，提高生产效率和安全性。

4. 典型生态项目

4.1 Web Bluetooth Scanning

Web Bluetooth Scanning 是 Web Bluetooth 的一个扩展项目，支持主动扫描蓝牙设备。该项目允许开发者更灵活地发现周围的蓝牙设备，并与之交互。

4.2 Android BLE Peripheral App

Android BLE Peripheral App 是一个模拟 BLE 外设的应用程序，用于测试和实验 Web Bluetooth API。通过该应用，开发者可以模拟一个蓝牙设备，并测试 Web 应用与该设备的连接和通信。

4.3 Web Bluetooth Polyfill

Web Bluetooth Polyfill 是一个用于在旧版浏览器中实现 Web Bluetooth API 的 Polyfill 项目。通过该 Polyfill，开发者可以在不支持 Web Bluetooth 的浏览器中使用类似的功能。

通过本教程，你应该已经掌握了 Web Bluetooth 项目的基本使用方法，并了解了其在不同领域的应用案例。希望这些内容能帮助你更好地理解和使用 Web Bluetooth API。

web-bluetooth

Bluetooth support for the Web.

项目地址：https://gitcode.com/gh_mirrors/we/web-bluetooth

登录后查看全文