Angular Web Bluetooth 模块指南

1. 项目介绍

Angular Web Bluetooth 是一个专为 Angular 设计的组件库，弥补了在 Angular 应用中集成 Web Bluetooth API 的空白。Web Bluetooth 允许网页应用直接与附近的蓝牙低功耗（BLE）设备进行通信，而本项目则通过一个易用的模块化接口简化了这一过程。它由 Wassim CHEGHAM 开发并维护，采用 MIT 许可证发布。

2. 快速启动

安装依赖

首先，确保您的 Angular 项目已准备好，并通过以下命令安装 @manekinekko/angular-web-bluetooth 及其类型定义：

npm install -S @manekinekko/angular-web-bluetooth @types/web-bluetooth

集成到 Angular 应用

接着，在您的主模块（通常是 app.module.ts）中导入 WebBluetoothModule 并配置它：

import { NgModule } from '@angular/core';
import { WebBluetoothModule } from '@manekinekko/angular-web-bluetooth';

@NgModule({
  imports: [
    WebBluetoothModule.forRoot({
      enableTracing: true, // 或 false，以控制是否在浏览器控制台输出日志
    }),
  ],
})
export class AppModule {}

使用示例

在服务或组件中注入 BluetoothCore 来访问蓝牙功能：

import { Injectable } from '@angular/core';
import { BluetoothCore } from '@manekinekko/angular-web-bluetooth';

@Injectable({ providedIn: 'root' })
export class YourService {
  constructor(private readonly ble: BluetoothCore) {}

  async connectToDevice() {
    const device = await this.ble.getDevice$().toPromise();
    // 连接逻辑继续...
  }
}

3. 应用案例和最佳实践

电池水平服务

创建一个服务来管理设备的电池水平，这展示了如何利用 streamValues$, getValue$ 和其他方法持续监控 BLE 设备状态：

import { Injectable } from '@angular/core';
import { BluetoothCore } from '@manekinekko/angular-web-bluetooth';
import { map } from 'rxjs/operators';

@Injectable({ providedIn: 'root' })
export class BatteryLevelService {
  constructor(private readonly ble: BluetoothCore) {}

  async getBatteryLevel() {
    try {
      return await this.ble.value$({
        service: 'battery_service',
        characteristic: 'battery_level',
      }).toPromise();
    } catch (error) {
      console.error('Error getting battery level:', error);
    }
  }

  // 更多逻辑...
}

最佳实践：错误处理与资源清理

确保在连接结束时断开设备，并妥善处理异常情况，防止资源泄露。

async disconnectIfConnected(device) {
  if (device && device.gatt.connected) {
    await this.ble.disconnectDevice(device);
  }
}

4. 典型生态项目

Angular Web Bluetooth 虽是专精于 Angular 环境下的 BLE 解决方案，但它的生态并不局限于特定的应用场景。开发者可以将其融入智能家居、健康追踪、物联网(IoT)设备的监控与控制等广泛领域，实现从简单的数据读取到复杂远程操作的各种应用。

结合 Angular 强大的框架特性，如响应式表单和路由，开发人员能够构建出既美观又功能丰富的Web应用，无缝对接各种支持BLE的硬件设备，开启现代Web应用与物理世界交互的新篇章。

---

以上便是对 Angular Web Bluetooth 的简要入门和应用指导，开始探索吧，让您的 Angular 应用能够灵活地与周边蓝牙设备对话！