taro-bluetooth-print 1.0.1 → 1.0.4

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2023 Your Name
+Copyright (c) 2025 Agions
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -29,6 +29,22 @@
 - [贡献指南](#贡献指南)
 - [许可证](#许可证)
 
+## 🔄 最近更新
+
+### v1.0.4 (2024-03-13)
+
+#### 修复
+- 修复了多个TypeScript类型错误和接口不匹配的问题
+- 合并了重复的`writeDataInChunks`方法实现，优化了代码结构
+- 修复了`adapter.write`方法的参数调用不匹配问题
+- 修复了只读属性访问和修改的问题
+- 优化了代码中的重复定义，提高了代码质量
+
+#### 改进
+- 增强了蓝牙数据传输的稳定性
+- 优化了内存使用和缓冲区管理
+- 完善了错误处理和恢复机制
+
 ## ✨ 特性
 
 - 🌐 **多平台支持**：微信小程序、H5、React Native、鸿蒙OS
@@ -493,7 +509,7 @@ await printer.printer.cut();
 
 ```bash
 # 克隆仓库
-git clone https://github.com/Agions/taro-bluetooth-print.git
+git clone https://github.com/agons/taro-bluetooth-print.git
 
 # 安装依赖
 cd taro-bluetooth-print

package/dist/bluetooth/index.d.ts

@@ -1,21 +1,151 @@
-import { BluetoothDevice } from './adapter';
+/**
+ * @file Bluetooth Manager
+ * @description 蓝牙管理模块，提供蓝牙设备发现、连接、数据传输等功能
+ *
+ * @update 更新日志
+ *
+ * ## 2025-03-13
+ * ### 新增功能
+ * - 增加性能优化配置系统
+ *   - 可配置缓冲池大小和策略
+ *   - 支持自定义性能参数
+ *   - 提供性能监控和统计
+ * - 增强缓存管理
+ *   - 设备信息智能缓存
+ *   - 缓冲区对象池
+ *   - 自适应缓存优化
+ * - 改进数据传输
+ *   - 智能分片策略
+ *   - 缓冲区复用机制
+ *   - 批量写入优化
+ *
+ * ### 性能优化
+ * - 内存管理优化
+ *   - 引入垃圾回收机制
+ *   - 内存使用监控
+ *   - 资源自动释放
+ * - 传输性能优化
+ *   - 动态调整传输参数
+ *   - 性能数据分析
+ *   - 自动优化策略
+ *
+ * ### 监控与诊断
+ * - 增强性能监控
+ *   - 详细性能指标统计
+ *   - 稳定性评分系统
+ *   - 错误模式分析
+ * - 改进诊断工具
+ *   - 内存使用分析
+ *   - 性能瓶颈检测
+ *   - 自动优化建议
+ *
+ * @version 2.0.0
+ * @author Your Name
+ * @copyright 2025
+ */
+import { BluetoothDevice, ConnectOptions, DiscoveryOptions } from '../types';
+import type { TransmissionStats, FlowControlParams, BatchWriteOptions, BatchWriteResult, DeviceHealthInfo } from '../types';
+interface ExtendedBatchWriteOptions extends BatchWriteOptions {
+    batchSize?: number;
+    parallel?: boolean;
+    maxParallel?: number;
+    commandDelay?: number;
+    highPriority?: boolean;
+}
+/**
+ * 蓝牙管理器类
+ * 负责蓝牙设备的扫描、连接和通信
+ */
 export declare class BluetoothManager {
     private adapter;
     private isInitialized;
-    private connectedDeviceId;
     private discoveryStarted;
-    private discoveredDevices;
+    private connectedDeviceId;
     private serviceUUID;
     private characteristicUUID;
+    private commandQueue;
+    private isProcessingQueue;
+    private discoveredDevices;
+    private transmissionStats;
+    private performanceConfig;
+    private autoReconnect;
+    private reconnectTimer;
+    private reconnectAttempts;
+    private maxReconnectAttempts;
+    private reconnectDelay;
+    private currentRecoveryDelay;
+    private recoveryTimer;
+    private lastConnectedDevice;
+    private batteryCheckInterval;
+    private flowControl;
+    private connectionHistory;
+    private connectionQualityInterval;
+    private readonly QUALITY_CHECK_INTERVAL;
+    private qualityCheckInterval;
+    private readonly RSSI_WARNING_THRESHOLD;
+    private readonly QUALITY_WARNING_THRESHOLD;
+    private recoveryAttempts;
+    private readonly MAX_RECOVERY_ATTEMPTS;
+    private readonly RECOVERY_DELAY;
+    private lastKnownState;
+    private connectionStartTime;
+    private flowControlAdjustments;
+    private lastFlowControlAdjustment;
+    private lastReconnectTime;
+    private queuePaused;
+    private queueProcessTimer;
+    private readonly QUEUE_PROCESS_INTERVAL;
+    private readonly QUEUE_MAX_SIZE;
+    private readonly DEFAULT_COMMAND_PRIORITY;
+    private readonly HIGH_PRIORITY;
+    private readonly LOW_PRIORITY;
+    private loadConnectionHistory;
+    private saveConnectionHistory;
+    private updateConnectionHistory;
+    /**
+     * 创建蓝牙管理器实例
+     */
     constructor();
+    /**
+     * 设置连接状态监听
+     * 用于检测意外断开并自动重连
+     */
+    private setupConnectionStateListener;
+    /**
+     * 安排自动重连
+     */
+    private scheduleReconnect;
+    /**
+     * 重置重连状态
+     */
+    private resetReconnectState;
+    /**
+     * 启用自动重连
+     * @param enable 是否启用
+     * @param maxAttempts 最大尝试次数
+     * @param delay 初始延迟（毫秒）
+     */
+    setAutoReconnect(enable: boolean, maxAttempts?: number, delay?: number): void;
     /**
      * 初始化蓝牙模块
      */
     init(): Promise<boolean>;
     /**
      * 开始搜索蓝牙设备
+     * @param options 搜索选项
      */
-    startDiscovery(): Promise<boolean>;
+    startDiscovery(options?: DiscoveryOptions): Promise<boolean>;
+    /**
+     * 判断设备是否应该被过滤掉
+     * @param device 设备信息
+     * @param options 搜索选项
+     */
+    private shouldFilterDevice;
+    /**
+     * 处理设备名称
+     * 有些设备名称是乱码或空，尝试修复或使用替代名称
+     */
+    private processDeviceName;
     /**
      * 停止搜索蓝牙设备
      */
@@ -26,9 +156,10 @@ export declare class BluetoothManager {
     getDiscoveredDevices(): Promise<BluetoothDevice[]>;
     /**
      * 连接蓝牙设备
-     * @param deviceId 蓝牙设备ID
+     * @param deviceId 设备ID
+     * @param options 连接选项
      */
-    connect(deviceId: string): Promise<boolean>;
+    connect(deviceId: string, options?: ConnectOptions): Promise<boolean>;
     /**
      * 断开蓝牙连接
      */
@@ -38,8 +169,509 @@ export declare class BluetoothManager {
      * @param data 要写入的数据
      */
     writeData(data: ArrayBuffer): Promise<boolean>;
+    /**
+     * 分块写入数据
+     * @param data 要写入的数据
+     * @param chunkSize 每块大小
+     * @param delayMs 每块之间的延迟时间(ms)
+     * @returns 是否全部写入成功
+     */
+    writeDataInChunks(data: ArrayBuffer, chunkSize?: number, delayMs?: number): Promise<boolean>;
+    /**
+     * 批量写入多个命令
+     * @param commands 命令数组
+     * @param options 选项
+     */
+    writeBatch(commands: ArrayBuffer[], options?: BatchWriteOptions): Promise<BatchWriteResult>;
+    /**
+     * 重置传输统计数据
+     */
+    private resetTransmissionStats;
+    /**
+     * 获取传输统计信息
+     */
+    getTransmissionStats(): TransmissionStats;
+    /**
+     * 智能调整传输参数
+     * 根据传输质量和速度优化分片大小和延迟
+     */
+    private adjustTransmissionParams;
+    /**
+     * 手动设置流量控制参数
+     */
+    setFlowControlParams(params: Partial<FlowControlParams>): void;
+    /**
+     * 获取当前流量控制参数
+     */
+    getFlowControlParams(): FlowControlParams;
+    /**
+     * 检查是否已连接
+     */
+    isConnected(): boolean;
+    /**
+     * 获取已连接的设备ID
+     */
+    getConnectedDeviceId(): string | null;
+    /**
+     * 获取适配器初始化状态
+     */
+    getInitStatus(): boolean;
+    /**
+     * 设置服务和特征值UUID
+     * @param serviceUUID 服务UUID
+     * @param characteristicUUID 特征值UUID
+     */
+    setServiceUUIDs(serviceUUID: string, characteristicUUID: string): void;
     /**
      * 销毁蓝牙模块
      */
     destroy(): Promise<boolean>;
+    /**
+     * 获取设备信息
+     * @param deviceId 设备ID（默认为当前连接的设备）
+     */
+    getDeviceInfo(deviceId?: string): Promise<BluetoothDevice | null>;
+    /**
+     * 获取设备电量信息
+     * @param deviceId 设备ID（默认为当前连接的设备）
+     */
+    getBatteryLevel(deviceId?: string): Promise<number | null>;
+    /**
+     * 设置低电量警告阈值并开始监控
+     * @param threshold 电量阈值百分比（0-100）
+     * @param interval 检查间隔（毫秒）
+     */
+    startBatteryMonitoring(threshold?: number, interval?: number): void;
+    /**
+     * 停止电量监控
+     */
+    stopBatteryMonitoring(): void;
+    /**
+     * 诊断蓝牙连接状态
+     * 用于排查和解决常见问题
+     */
+    diagnoseConnection(): Promise<DeviceHealthInfo>;
+    /**
+     * 尝试优化连接状态
+     * 自动执行一些修复和优化操作
+     */
+    private tryOptimizeConnection;
+    /**
+     * 设置连接保活
+     * 定期发送探测命令保持连接活跃
+     * @param enable 是否启用
+     * @param interval 间隔时间(毫秒)
+     */
+    private keepAliveInterval;
+    setKeepAlive(enable: boolean, interval?: number): void;
+    /**
+     * 清理连接相关资源
+     * 在组件卸载或页面关闭时调用
+     */
+    cleanup(): void;
+    /**
+     * 获取收藏的设备列表
+     */
+    getFavoriteDevices(): BluetoothDevice[];
+    /**
+     * 设置设备收藏状态
+     * @param deviceId 设备ID
+     * @param favorite 是否收藏
+     */
+    setDeviceFavorite(deviceId: string, favorite: boolean): boolean;
+    /**
+     * 获取最近连接的设备列表
+     * @param limit 最大数量
+     */
+    getRecentDevices(limit?: number): BluetoothDevice[];
+    /**
+     * 清除设备历史记录
+     * @param deviceId 指定设备ID，不指定则清除所有
+     */
+    clearDeviceHistory(deviceId?: string): void;
+    /**
+     * 启动连接质量监控
+     */
+    startQualityMonitoring(): void;
+    /**
+     * 停止连接质量监控
+     */
+    stopQualityMonitoring(): void;
+    /**
+     * 保存当前状态
+     */
+    private saveCurrentState;
+    /**
+     * 恢复之前的状态
+     */
+    private restoreState;
+    /**
+     * 智能恢复连接
+     */
+    private attemptRecovery;
+    /**
+     * 安排恢复尝试
+     */
+    private scheduleRecovery;
+    /**
+     * 重置恢复状态
+     */
+    private resetRecoveryState;
+    /**
+     * 获取设备性能报告
+     */
+    getPerformanceReport(): Promise<{
+        device: {
+            id: string | null;
+            name?: string;
+            signalStrength?: number;
+            batteryLevel?: number;
+        };
+        connection: {
+            uptime: number;
+            reconnections: number;
+            lastReconnectTime?: number;
+            quality: number;
+        };
+        transmission: {
+            totalBytesSent: number;
+            averageSpeed: number;
+            successRate: number;
+            errorRate: number;
+            retryCount: number;
+        };
+        flowControl: {
+            current: FlowControlParams;
+            adjustments: number;
+            lastAdjustmentTime?: number;
+        };
+    }>;
+    /**
+     * 获取连接运行时间（毫秒）
+     */
+    private getConnectionUptime;
+    /**
+     * 分析并优化传输性能
+     */
+    private analyzeAndOptimizePerformance;
+    /**
+     * 诊断并修复常见问题
+     */
+    diagnoseAndRepair(): Promise<{
+        status: 'healthy' | 'warning' | 'error';
+        issues: string[];
+        repairs: string[];
+        success: boolean;
+    }>;
+    /**
+     * 添加命令到队列
+     * @param command 命令数据
+     * @param options 队列选项
+     */
+    queueCommand(command: ArrayBuffer, options?: {
+        priority?: number;
+        maxRetries?: number;
+        useChunks?: boolean;
+        description?: string;
+    }): Promise<boolean>;
+    /**
+     * 启动队列处理
+     */
+    private startQueueProcessing;
+    /**
+     * 处理命令队列
+     */
+    private processQueue;
+    /**
+     * 按优先级排序队列
+     */
+    private sortQueue;
+    /**
+     * 暂停队列处理
+     */
+    pauseCommandQueue(): void;
+    /**
+     * 恢复队列处理
+     */
+    resumeCommandQueue(): void;
+    /**
+     * 清空命令队列
+     * @param rejectRemaining 是否拒绝剩余命令
+     */
+    clearCommandQueue(rejectRemaining?: boolean): number;
+    /**
+     * 获取队列状态
+     */
+    getQueueStatus(): {
+        queueLength: number;
+        isPaused: boolean;
+        isProcessing: boolean;
+        highPriorityCount: number;
+        normalPriorityCount: number;
+        lowPriorityCount: number;
+    };
+    writeCommands(commands: ArrayBuffer[], options?: ExtendedBatchWriteOptions): Promise<BatchWriteResult>;
+    private powerSavingEnabled;
+    private powerSavingMode;
+    private inactivityTimer;
+    private readonly DEFAULT_INACTIVITY_TIMEOUT;
+    private inactivityTimeout;
+    private lastActivityTime;
+    private batteryCheckIntervalMs;
+    /**
+     * 设置电源管理模式
+     * @param enabled 是否启用节能模式
+     * @param mode 节能模式类型
+     * @param inactivityTimeout 不活动超时时间（毫秒）
+     */
+    setPowerManagement(enabled: boolean, mode?: 'auto' | 'aggressive' | 'balanced' | 'performance', inactivityTimeout?: number): void;
+    /**
+     * 更新活动状态，重置不活动计时器
+     */
+    private resetActivityTimer;
+    /**
+     * 处理不活动状态
+     */
+    private handleInactivity;
+    /**
+     * 根据电池电量自动调整电源模式
+     */
+    private detectBatteryAndAdjustPowerMode;
+    /**
+     * 应用指定的电源模式
+     * @param mode 电源模式
+     */
+    private applyPowerMode;
+    /**
+     * 调整电池检查间隔
+     */
+    private adjustBatteryCheckInterval;
+    private debugMode;
+    private debugLogEnabled;
+    private debugEvents;
+    private readonly MAX_DEBUG_EVENTS;
+    /**
+     * 启用调试模式
+     * @param enabled 是否启用
+     * @param logToConsole 是否将调试信息记录到控制台
+     */
+    setDebugMode(enabled: boolean, logToConsole?: boolean): void;
+    /**
+     * 记录调试事件
+     * @param type 事件类型
+     * @param data 事件数据
+     */
+    private logDebugEvent;
+    /**
+     * 获取调试事件日志
+     * @param limit 最大返回数量，0表示全部
+     */
+    getDebugEvents(limit?: number): {
+        type: string;
+        data: any;
+        timestamp: number;
+    }[];
+    /**
+     * 清除调试事件日志
+     */
+    clearDebugEvents(): void;
+    /**
+     * 导出诊断报告
+     * @returns 包含详细诊断信息的对象
+     */
+    exportDiagnosticReport(): Promise<{
+        timestamp: number;
+        device: any;
+        adapter: any;
+        connection: any;
+        performance: any;
+        errors: any[];
+        events: any[];
+        config: any;
+    }>;
+    /**
+     * 自动检测和解决常见问题
+     * @returns 自动修复结果
+     */
+    autoTroubleshoot(): Promise<{
+        issues: string[];
+        fixes: string[];
+        success: boolean;
+        remainingIssues: string[];
+    }>;
+    /**
+     * 模拟蓝牙环境，用于在没有真实设备的情况下进行测试
+     * @param mockOptions 模拟选项
+     */
+    enableMockEnvironment(mockOptions?: {
+        simulateConnection?: boolean;
+        simulateDelay?: number;
+        simulateErrors?: boolean;
+        errorRate?: number;
+    }): void;
+    /**
+     * 获取连接活动日志
+     * 用于分析连接行为和调试问题
+     * @param maxEntries 最大条目数
+     */
+    getConnectionActivityLog(maxEntries?: number): any[];
+    private bufferPool;
+    private deviceInfoCache;
+    private connectionStateCache;
+    private statsAggregator;
+    private performanceMonitorInterval;
+    /**
+     * 初始化性能优化系统
+     */
+    private initPerformanceOptimizations;
+    /**
+     * 初始化缓冲区池
+     */
+    private initBufferPool;
+    /**
+     * 从缓冲区池获取缓冲区
+     * @param size 需要的缓冲区大小
+     */
+    private getBufferFromPool;
+    /**
+     * 将缓冲区归还池
+     * @param buffer 要归还的缓冲区
+     */
+    private returnBufferToPool;
+    /**
+     * 启动性能监控
+     */
+    private startPerformanceMonitoring;
+    /**
+     * 分析性能指标并进行自动优化
+     */
+    private analyzePerformanceMetrics;
+    /**
+     * 计算稳定性分数
+     */
+    private calculateStabilityScore;
+    /**
+     * 获取最常见的错误类型
+     */
+    private getMostCommonError;
+    /**
+     * 裁剪性能统计数据
+     */
+    private trimPerformanceStats;
+    /**
+     * 计算数组平均值
+     */
+    private calculateAverage;
+    /**
+     * 计算标准差
+     */
+    private calculateStdDev;
+    /**
+     * 启动垃圾回收计时器
+     */
+    private startGarbageCollector;
+    /**
+     * 执行垃圾回收
+     */
+    private performGarbageCollection;
+    /**
+     * 获取缓存的设备信息
+     */
+    private getCachedDeviceInfo;
+    /**
+     * 更新设备信息缓存
+     */
+    private updateDeviceInfoCache;
+    /**
+     * 记录操作耗时
+     */
+    private recordOperationTime;
+    /**
+     * 记录错误
+     */
+    private recordError;
+    /**
+     * 记录成功操作
+     */
+    private recordSuccess;
+    /**
+     * 设置性能配置参数
+     * @param config 性能配置
+     */
+    setPerformanceConfig(config: Partial<typeof this.performanceConfig>): void;
+    /**
+     * 获取当前性能配置
+     */
+    getPerformanceConfig(): typeof this.performanceConfig;
+    /**
+     * 获取性能统计信息
+     */
+    getPerformanceStats(): {
+        operations: {
+            write: {
+                count: number;
+                avgTime: number;
+                stdDev: number;
+            };
+            read: {
+                count: number;
+                avgTime: number;
+                stdDev: number;
+            };
+            connect: {
+                count: number;
+                avgTime: number;
+                stdDev: number;
+            };
+            discover: {
+                count: number;
+                avgTime: number;
+                stdDev: number;
+            };
+        };
+        memoryUsage: {
+            bufferPoolSize: number;
+            deviceCacheSize: number;
+            eventHistorySize: number;
+        };
+        stability: {
+            score: number;
+            consecutiveErrors: number;
+            errorDistribution: Record<string, number>;
+        };
+    };
+    /**
+     * 预热缓存，提前加载常用数据到缓存
+     * 在应用启动时或需要准备大量操作前调用，可提高后续操作速度
+     */
+    preloadCache(): Promise<void>;
+    /**
+     * 清理缓存，释放内存
+     * @param type 指定要清理的缓存类型，默认全部
+     */
+    clearCache(type?: 'device' | 'buffer' | 'stats' | 'all'): void;
+    /**
+     * 优化缓存大小，根据当前情况调整缓存配置
+     */
+    optimizeCache(): void;
+    /**
+     * 找出最常用的缓冲区大小
+     */
+    private findMostUsedBufferSizes;
+    /**
+     * 获取当前蓝牙内存使用情况
+     */
+    getMemoryUsage(): {
+        bufferPools: {
+            size: number;
+            count: number;
+            memoryUsage: number;
+        }[];
+        totalBufferMemory: number;
+        cacheMemory: number;
+        totalMemoryUsage: number;
+    };
+    private updateTransmissionStats;
+    private mergeEventHistory;
 }
+export {};