@fww_123/uni-ble-scanner 1.0.0

package/src/core/base-scanner.ts

@@ -0,0 +1,309 @@
+import {
+  BLEDevice,
+  ScanOptions,
+  ScanState,
+  ScanCallbacks,
+  IBLEScanner,
+  AdapterState,
+  BLEError,
+  Platform,
+  PlatformConfig,
+  DeviceFilter,
+} from '../types';
+import { Errors, handlePlatformError } from '../utils/errors';
+import { normalizeDeviceData } from '../utils/data-parser';
+
+/**
+ * 扫描器基类
+ */
+export abstract class BaseScanner implements IBLEScanner {
+  protected state: ScanState = ScanState.IDLE;
+  protected discoveredDevices: Map<string, BLEDevice> = new Map();
+  protected callbacks: ScanCallbacks = {};
+  protected options: ScanOptions = {};
+  protected platformConfig: PlatformConfig = {};
+  protected initialized = false;
+  protected timeoutId: number | null = null;
+  protected adapterStateListeners: ((state: AdapterState) => void)[] = [];
+
+  /**
+   * 获取当前平台
+   */
+  abstract getPlatform(): Platform;
+
+  /**
+   * 初始化蓝牙适配器
+   */
+  abstract init(): Promise<void>;
+
+  /**
+   * 平台特定的开始扫描实现
+   */
+  protected abstract startScanInternal(): Promise<void>;
+
+  /**
+   * 平台特定的停止扫描实现
+   */
+  protected abstract stopScanInternal(): Promise<void>;
+
+  /**
+   * 检查蓝牙权限
+   */
+  abstract checkPermissions(): Promise<boolean>;
+
+  /**
+   * 请求蓝牙权限
+   */
+  abstract requestPermissions(): Promise<boolean>;
+
+  /**
+   * 监听适配器状态变化
+   */
+  abstract onAdapterStateChange(callback: (state: AdapterState) => void): void;
+
+  /**
+   * 开始扫描
+   */
+  async startScan(options: ScanOptions = {}, callbacks: ScanCallbacks = {}): Promise<void> {
+    if (this.state === ScanState.SCANNING) {
+      throw Errors.alreadyScanning();
+    }
+
+    if (!this.initialized) {
+      throw Errors.notInitialized();
+    }
+
+    // 检查权限
+    const hasPermission = await this.checkPermissions();
+    if (!hasPermission) {
+      const granted = await this.requestPermissions();
+      if (!granted) {
+        throw Errors.permissionDenied();
+      }
+    }
+
+    this.options = { ...this.getDefaultOptions(), ...options };
+    this.callbacks = callbacks;
+
+    try {
+      this.setState(ScanState.SCANNING);
+      
+      // 清空之前的设备列表（如果不需要重复上报）
+      if (!this.options.allowDuplicates) {
+        this.clearDevices();
+      }
+
+      // 设置超时
+      if (this.options.timeout && this.options.timeout > 0) {
+        this.timeoutId = window.setTimeout(() => {
+          this.handleTimeout();
+        }, this.options.timeout);
+      }
+
+      await this.startScanInternal();
+      this.callbacks.onScanStart?.();
+    } catch (error) {
+      this.setState(ScanState.ERROR);
+      this.clearTimeout();
+      throw error;
+    }
+  }
+
+  /**
+   * 停止扫描
+   */
+  async stopScan(): Promise<void> {
+    if (this.state !== ScanState.SCANNING) {
+      return;
+    }
+
+    this.setState(ScanState.STOPPING);
+    this.clearTimeout();
+
+    try {
+      await this.stopScanInternal();
+      this.setState(ScanState.IDLE);
+      this.callbacks.onScanStop?.();
+    } catch (error) {
+      this.setState(ScanState.ERROR);
+      throw error;
+    }
+  }
+
+  /**
+   * 获取已发现的设备列表
+   */
+  getDiscoveredDevices(): BLEDevice[] {
+    return Array.from(this.discoveredDevices.values());
+  }
+
+  /**
+   * 清空设备列表
+   */
+  clearDevices(): void {
+    this.discoveredDevices.clear();
+  }
+
+  /**
+   * 获取当前扫描状态
+   */
+  getState(): ScanState {
+    return this.state;
+  }
+
+  /**
+   * 销毁扫描器
+   */
+  destroy(): void {
+    this.stopScan();
+    this.clearDevices();
+    this.clearTimeout();
+    this.callbacks = {};
+    this.adapterStateListeners = [];
+    this.initialized = false;
+  }
+
+  /**
+   * 处理发现的设备
+   */
+  protected handleDeviceFound(rawDevice: any): void {
+    try {
+      const device = normalizeDeviceData(rawDevice);
+
+      // 应用过滤器
+      if (!this.filterDevice(device)) {
+        return;
+      }
+
+      // 检查是否已存在
+      const existingDevice = this.discoveredDevices.get(device.deviceId);
+      if (existingDevice && !this.options.allowDuplicates) {
+        // 更新 RSSI
+        existingDevice.RSSI = device.RSSI;
+        return;
+      }
+
+      // 保存设备
+      this.discoveredDevices.set(device.deviceId, device);
+
+      // 触发回调
+      this.callbacks.onDeviceFound?.(device);
+    } catch (error) {
+      console.error('处理设备数据失败:', error);
+    }
+  }
+
+  /**
+   * 过滤设备
+   */
+  protected filterDevice(device: BLEDevice): boolean {
+    // 按名称过滤
+    if (this.options.nameFilter) {
+      const deviceName = device.name || '';
+      const filters = Array.isArray(this.options.nameFilter)
+        ? this.options.nameFilter
+        : [this.options.nameFilter];
+      
+      const nameMatch = filters.some(filter => {
+        if (typeof filter === 'string') {
+          return deviceName.includes(filter);
+        }
+        return filter.test(deviceName);
+      });
+      
+      if (!nameMatch) return false;
+    }
+
+    // 按信号强度过滤
+    if (this.options.rssiThreshold !== undefined) {
+      if (device.RSSI < this.options.rssiThreshold) {
+        return false;
+      }
+    }
+
+    // 按服务UUID过滤
+    if (this.options.services && this.options.services.length > 0) {
+      if (!device.serviceUuids) return false;
+      
+      const hasMatchingService = this.options.services.some(service =>
+        device.serviceUuids!.some(uuid => 
+          uuid.toLowerCase().includes(service.toLowerCase())
+        )
+      );
+      
+      if (!hasMatchingService) return false;
+    }
+
+    // 按制造商数据过滤
+    if (this.options.manufacturerFilter !== undefined) {
+      if (!device.manufacturerData) return false;
+      
+      const filters = Array.isArray(this.options.manufacturerFilter)
+        ? this.options.manufacturerFilter
+        : [this.options.manufacturerFilter];
+      
+      const manufacturerIds = Object.keys(device.manufacturerData).map(id => 
+        parseInt(id, 16)
+      );
+      
+      const hasMatchingManufacturer = filters.some(filter =>
+        manufacturerIds.includes(filter)
+      );
+      
+      if (!hasMatchingManufacturer) return false;
+    }
+
+    return true;
+  }
+
+  /**
+   * 处理超时
+   */
+  protected handleTimeout(): void {
+    this.stopScan();
+    this.callbacks.onTimeout?.();
+  }
+
+  /**
+   * 处理错误
+   */
+  protected handleError(error: any): void {
+    const bleError = handlePlatformError(error, this.getPlatform());
+    this.setState(ScanState.ERROR);
+    this.callbacks.onError?.(bleError);
+  }
+
+  /**
+   * 设置状态
+   */
+  protected setState(state: ScanState): void {
+    this.state = state;
+  }
+
+  /**
+   * 清除超时定时器
+   */
+  protected clearTimeout(): void {
+    if (this.timeoutId !== null) {
+      window.clearTimeout(this.timeoutId);
+      this.timeoutId = null;
+    }
+  }
+
+  /**
+   * 获取默认选项
+   */
+  protected getDefaultOptions(): ScanOptions {
+    return {
+      timeout: 10000,
+      allowDuplicates: false,
+    };
+  }
+
+  /**
+   * 触发适配器状态变化
+   */
+  protected emitAdapterStateChange(state: AdapterState): void {
+    this.adapterStateListeners.forEach(listener => listener(state));
+  }
+}

package/src/factory.ts

@@ -0,0 +1,116 @@
+import { IBLEScanner, Platform, PlatformConfig } from './types';
+import { UniAppScanner } from './platforms/uniapp-scanner';
+import { AndroidNativeScanner } from './platforms/android-native';
+import { IOSNativeScanner } from './platforms/ios-native';
+import { HarmonyNativeScanner } from './platforms/harmony-native';
+import { getPlatform, isApp } from './utils/platform';
+
+/**
+ * 扫描器类型
+ */
+export type ScannerType = 'auto' | 'uniapp' | 'native';
+
+/**
+ * 创建扫描器的选项
+ */
+export interface CreateScannerOptions {
+  /** 扫描器类型 */
+  type?: ScannerType;
+  /** 平台特定配置 */
+  platformConfig?: PlatformConfig;
+}
+
+/**
+ * 创建蓝牙扫描器
+ * @param options 创建选项
+ * @returns 蓝牙扫描器实例
+ */
+export function createScanner(options: CreateScannerOptions = {}): IBLEScanner {
+  const { type = 'auto', platformConfig = {} } = options;
+  const platform = getPlatform();
+  const app = isApp();
+
+  // 根据类型和平台选择合适的扫描器
+  if (type === 'uniapp' || (type === 'auto' && !app)) {
+    // 使用 UniApp 标准 API
+    const scanner = new UniAppScanner();
+    Object.assign(scanner, { platformConfig });
+    return scanner;
+  }
+
+  if (type === 'native' || type === 'auto') {
+    // 使用原生 API
+    switch (platform) {
+      case Platform.ANDROID:
+        const androidScanner = new AndroidNativeScanner();
+        Object.assign(androidScanner, { platformConfig });
+        return androidScanner;
+      
+      case Platform.IOS:
+        const iosScanner = new IOSNativeScanner();
+        Object.assign(iosScanner, { platformConfig });
+        return iosScanner;
+      
+      case Platform.HARMONY:
+        const harmonyScanner = new HarmonyNativeScanner();
+        Object.assign(harmonyScanner, { platformConfig });
+        return harmonyScanner;
+      
+      default:
+        // 未知平台使用 UniApp API
+        const defaultScanner = new UniAppScanner();
+        Object.assign(defaultScanner, { platformConfig });
+        return defaultScanner;
+    }
+  }
+
+  // 默认使用 UniApp API
+  const defaultScanner = new UniAppScanner();
+  Object.assign(defaultScanner, { platformConfig });
+  return defaultScanner;
+}
+
+/**
+ * 创建 UniApp 扫描器
+ * 使用 UniApp 标准蓝牙 API，兼容所有平台
+ */
+export function createUniAppScanner(platformConfig?: PlatformConfig): IBLEScanner {
+  return createScanner({ type: 'uniapp', platformConfig });
+}
+
+/**
+ * 创建原生扫描器
+ * 使用平台原生 API，功能更强大但需要特定条件
+ */
+export function createNativeScanner(platformConfig?: PlatformConfig): IBLEScanner {
+  return createScanner({ type: 'native', platformConfig });
+}
+
+/**
+ * 获取当前平台
+ */
+export { getPlatform, Platform };
+
+/**
+ * 检查当前环境是否支持蓝牙
+ */
+export function isBluetoothSupported(): boolean {
+  // #ifdef APP-PLUS
+  return true;
+  // #endif
+  
+  // #ifdef H5
+  return typeof navigator !== 'undefined' && 'bluetooth' in navigator;
+  // #endif
+  
+  // #ifdef MP
+  return true;
+  // #endif
+  
+  return false;
+}
+
+/**
+ * 检查当前环境是否是 APP
+ */
+export { isApp };

package/src/index.ts

@@ -0,0 +1,54 @@
+// 导出类型
+export type {
+  BLEDevice,
+  ScanOptions,
+  ScanCallbacks,
+  AdapterState,
+  BLEError,
+  IBLEScanner,
+  PlatformConfig,
+  DeviceFilter,
+  CreateScannerOptions,
+} from './types';
+
+// 导出枚举
+export { ScanState, Platform } from './types';
+
+// 导出工厂函数
+export {
+  createScanner,
+  createUniAppScanner,
+  createNativeScanner,
+  getPlatform,
+  isBluetoothSupported,
+  isApp,
+} from './factory';
+
+// 导出错误处理
+export { ErrorCodes, createError, Errors } from './utils/errors';
+
+// 导出数据解析工具
+export {
+  parseAdvertisementData,
+  base64ToArrayBuffer,
+  arrayBufferToBase64,
+  formatUUID,
+  matchUUID,
+} from './utils/data-parser';
+
+// 导出权限工具
+export { checkPermissions, requestPermissions } from './utils/permissions';
+
+// 导出平台工具
+export { isPlatform, getPlatformName } from './utils/platform';
+
+// 导出扫描器类（供高级使用）
+export { BaseScanner } from './core/base-scanner';
+export { UniAppScanner } from './platforms/uniapp-scanner';
+export { AndroidNativeScanner } from './platforms/android-native';
+export { IOSNativeScanner } from './platforms/ios-native';
+export { HarmonyNativeScanner } from './platforms/harmony-native';
+
+// 默认导出
+import { createScanner } from './factory';
+export default createScanner;