@fww_123/uni-ble-scanner 1.0.0 → 1.0.1

package/dist/factory.d.ts

@@ -3,7 +3,7 @@ import { getPlatform, isApp } from './utils/platform';
 /**
  * 扫描器类型
  */
-export type ScannerType = 'auto' | 'uniapp' | 'native';
+export type ScannerType = 'auto' | 'uniapp' | 'native' | 'web';
 /**
  * 创建扫描器的选项
  */
@@ -19,6 +19,11 @@ export interface CreateScannerOptions {
  * @returns 蓝牙扫描器实例
  */
 export declare function createScanner(options?: CreateScannerOptions): IBLEScanner;
+/**
+ * 创建 Web 扫描器
+ * 使用 Web Bluetooth API，适用于浏览器环境
+ */
+export declare function createWebScanner(platformConfig?: PlatformConfig): IBLEScanner;
 /**
  * 创建 UniApp 扫描器
  * 使用 UniApp 标准蓝牙 API，兼容所有平台

package/dist/factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAKhE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEtD;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,YAAY;IACZ,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,aAAa;IACb,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,oBAAyB,GAAG,WAAW,CA2C7E;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,cAAc,CAAC,EAAE,cAAc,GAAG,WAAW,CAEhF;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,cAAc,CAAC,EAAE,cAAc,GAAG,WAAW,CAEhF;AAED;;GAEG;AACH,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC;AAEjC;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAc9C;AAED;;GAEG;AACH,OAAO,EAAE,KAAK,EAAE,CAAC"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAMhE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEtD;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,KAAK,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,YAAY;IACZ,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,aAAa;IACb,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,oBAAyB,GAAG,WAAW,CAqD7E;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,cAAc,CAAC,EAAE,cAAc,GAAG,WAAW,CAE7E;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,cAAc,CAAC,EAAE,cAAc,GAAG,WAAW,CAEhF;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,cAAc,CAAC,EAAE,cAAc,GAAG,WAAW,CAEhF;AAED;;GAEG;AACH,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC;AAEjC;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAc9C;AAED;;GAEG;AACH,OAAO,EAAE,KAAK,EAAE,CAAC"}

package/dist/index.d.ts

@@ -10,6 +10,7 @@ export { UniAppScanner } from './platforms/uniapp-scanner';
 export { AndroidNativeScanner } from './platforms/android-native';
 export { IOSNativeScanner } from './platforms/ios-native';
 export { HarmonyNativeScanner } from './platforms/harmony-native';
+export { WebScanner, isWebBluetoothSupported } from './platforms/web-scanner';
 import { createScanner } from './factory';
 export default createScanner;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,SAAS,EACT,WAAW,EACX,aAAa,EACb,YAAY,EACZ,QAAQ,EACR,WAAW,EACX,cAAc,EACd,YAAY,EACZ,oBAAoB,GACrB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAG9C,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EACnB,WAAW,EACX,oBAAoB,EACpB,KAAK,GACN,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAGjE,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,EACnB,UAAU,EACV,SAAS,GACV,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAG3E,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAG/D,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAGlE,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,eAAe,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,SAAS,EACT,WAAW,EACX,aAAa,EACb,YAAY,EACZ,QAAQ,EACR,WAAW,EACX,cAAc,EACd,YAAY,EACZ,oBAAoB,GACrB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAG9C,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EACnB,WAAW,EACX,oBAAoB,EACpB,KAAK,GACN,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAGjE,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,EACnB,UAAU,EACV,SAAS,GACV,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAG3E,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAG/D,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,UAAU,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAG9E,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,eAAe,aAAa,CAAC"}

package/dist/index.esm.js

@@ -1721,6 +1721,174 @@ class HarmonyNativeScanner extends BaseScanner {
     }
 }
 
+/**
+ * Web 浏览器蓝牙扫描器
+ * 使用 Web Bluetooth API
+ */
+class WebScanner extends BaseScanner {
+    constructor() {
+        super(...arguments);
+        this.device = null;
+        this.server = null;
+    }
+    getPlatform() {
+        return Platform.UNKNOWN;
+    }
+    init() {
+        return __awaiter(this, void 0, void 0, function* () {
+            return new Promise((resolve, reject) => {
+                // 检查浏览器是否支持 Web Bluetooth
+                if (!navigator.bluetooth) {
+                    reject(createError(ErrorCodes.UNSUPPORTED_PLATFORM, '当前浏览器不支持 Web Bluetooth API，请使用 Chrome、Edge 或 Opera'));
+                    return;
+                }
+                this.initialized = true;
+                resolve();
+            });
+        });
+    }
+    startScanInternal() {
+        return __awaiter(this, void 0, void 0, function* () {
+            return new Promise((resolve, reject) => __awaiter(this, void 0, void 0, function* () {
+                try {
+                    // Web Bluetooth 使用 requestDevice 而不是扫描
+                    // 这会弹出浏览器的选择设备对话框
+                    const options = {
+                        acceptAllDevices: true,
+                    };
+                    // 添加服务过滤
+                    if (this.options.services && this.options.services.length > 0) {
+                        options.filters = this.options.services.map(uuid => ({
+                            services: [uuid],
+                        }));
+                    }
+                    else {
+                        options.acceptAllDevices = true;
+                    }
+                    // 请求设备（浏览器会弹出选择框）
+                    this.device = yield navigator.bluetooth.requestDevice(options);
+                    // 监听设备广告（如果支持）
+                    if (this.device.watchAdvertisements) {
+                        this.device.addEventListener('advertisementreceived', (event) => {
+                            this.handleDeviceFound({
+                                deviceId: this.device.id,
+                                name: this.device.name,
+                                RSSI: event.rssi || -50,
+                                advertisData: event.manufacturerData,
+                            });
+                        });
+                        yield this.device.watchAdvertisements();
+                    }
+                    else {
+                        // 如果不支持广告监听，直接返回设备信息
+                        this.handleDeviceFound({
+                            deviceId: this.device.id,
+                            name: this.device.name,
+                            RSSI: -50, // 默认值
+                        });
+                    }
+                    resolve();
+                }
+                catch (error) {
+                    if (error.name === 'NotFoundError') {
+                        reject(Errors.scanFailed('用户取消了设备选择'));
+                    }
+                    else {
+                        reject(handlePlatformError(error, 'web'));
+                    }
+                }
+            }));
+        });
+    }
+    stopScanInternal() {
+        return __awaiter(this, void 0, void 0, function* () {
+            // Web Bluetooth 没有明确的停止扫描方法
+            // 设备选择后扫描就结束了
+            if (this.device && this.device.unwatchAdvertisements) {
+                yield this.device.unwatchAdvertisements();
+            }
+            return Promise.resolve();
+        });
+    }
+    checkPermissions() {
+        return __awaiter(this, void 0, void 0, function* () {
+            // Web Bluetooth 权限由浏览器自动管理
+            // 通过用户手势触发 requestDevice 时会自动请求权限
+            return true;
+        });
+    }
+    requestPermissions() {
+        return __awaiter(this, void 0, void 0, function* () {
+            // Web Bluetooth 不需要显式请求权限
+            return true;
+        });
+    }
+    onAdapterStateChange(callback) {
+        this.adapterStateListeners.push(callback);
+        // Web Bluetooth 没有适配器状态变化事件
+        // 直接返回当前状态
+        callback({
+            available: !!navigator.bluetooth,
+            discovering: this.state === 'scanning',
+        });
+    }
+    destroy() {
+        super.destroy();
+        this.device = null;
+        this.server = null;
+    }
+    /**
+     * 连接到设备（Web Bluetooth 特有）
+     */
+    connect() {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            if (!this.device) {
+                throw Errors.notInitialized();
+            }
+            try {
+                this.server = (yield ((_a = this.device.gatt) === null || _a === void 0 ? void 0 : _a.connect())) || null;
+                return this.server;
+            }
+            catch (error) {
+                throw handlePlatformError(error, 'web');
+            }
+        });
+    }
+    /**
+     * 断开连接（Web Bluetooth 特有）
+     */
+    disconnect() {
+        var _a;
+        if (this.device && ((_a = this.device.gatt) === null || _a === void 0 ? void 0 : _a.connected)) {
+            this.device.gatt.disconnect();
+        }
+        this.server = null;
+    }
+    /**
+     * 获取已连接的服务（Web Bluetooth 特有）
+     */
+    getServices() {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this.server) {
+                throw Errors.notInitialized();
+            }
+            try {
+                return yield this.server.getPrimaryServices();
+            }
+            catch (error) {
+                throw handlePlatformError(error, 'web');
+            }
+        });
+    }
+}
+/**
+ * 检查浏览器是否支持 Web Bluetooth
+ */
+function isWebBluetoothSupported() {
+    return 'bluetooth' in navigator && typeof navigator.bluetooth.requestDevice === 'function';
+}
+
 /**
  * 创建蓝牙扫描器
  * @param options 创建选项
@@ -1730,6 +1898,14 @@ function createScanner(options = {}) {
     const { type = 'auto', platformConfig = {} } = options;
     const platform = getPlatform();
     const app = isApp();
+    // 检测是否在浏览器环境
+    const isWeb = typeof window !== 'undefined' && !app;
+    // 如果是 Web 环境或指定使用 Web 扫描器
+    if (type === 'web' || (type === 'auto' && isWeb)) {
+        const webScanner = new WebScanner();
+        Object.assign(webScanner, { platformConfig });
+        return webScanner;
+    }
     // 根据类型和平台选择合适的扫描器
     if (type === 'uniapp' || (type === 'auto' && !app)) {
         // 使用 UniApp 标准 API
@@ -1788,4 +1964,4 @@ function isBluetoothSupported() {
 
 // 导出枚举
 
-export { AndroidNativeScanner, BaseScanner, ErrorCodes, Errors, HarmonyNativeScanner, IOSNativeScanner, Platform, ScanState, UniAppScanner, arrayBufferToBase64, base64ToArrayBuffer, checkPermissions, createError, createNativeScanner, createScanner, createUniAppScanner, createScanner as default, formatUUID, getPlatform, getPlatformName, isApp, isBluetoothSupported, isPlatform, matchUUID, parseAdvertisementData, requestPermissions };
+export { AndroidNativeScanner, BaseScanner, ErrorCodes, Errors, HarmonyNativeScanner, IOSNativeScanner, Platform, ScanState, UniAppScanner, WebScanner, arrayBufferToBase64, base64ToArrayBuffer, checkPermissions, createError, createNativeScanner, createScanner, createUniAppScanner, createScanner as default, formatUUID, getPlatform, getPlatformName, isApp, isBluetoothSupported, isPlatform, isWebBluetoothSupported, matchUUID, parseAdvertisementData, requestPermissions };

package/dist/index.js

@@ -1725,6 +1725,174 @@ class HarmonyNativeScanner extends BaseScanner {
     }
 }
 
+/**
+ * Web 浏览器蓝牙扫描器
+ * 使用 Web Bluetooth API
+ */
+class WebScanner extends BaseScanner {
+    constructor() {
+        super(...arguments);
+        this.device = null;
+        this.server = null;
+    }
+    getPlatform() {
+        return exports.Platform.UNKNOWN;
+    }
+    init() {
+        return __awaiter(this, void 0, void 0, function* () {
+            return new Promise((resolve, reject) => {
+                // 检查浏览器是否支持 Web Bluetooth
+                if (!navigator.bluetooth) {
+                    reject(createError(ErrorCodes.UNSUPPORTED_PLATFORM, '当前浏览器不支持 Web Bluetooth API，请使用 Chrome、Edge 或 Opera'));
+                    return;
+                }
+                this.initialized = true;
+                resolve();
+            });
+        });
+    }
+    startScanInternal() {
+        return __awaiter(this, void 0, void 0, function* () {
+            return new Promise((resolve, reject) => __awaiter(this, void 0, void 0, function* () {
+                try {
+                    // Web Bluetooth 使用 requestDevice 而不是扫描
+                    // 这会弹出浏览器的选择设备对话框
+                    const options = {
+                        acceptAllDevices: true,
+                    };
+                    // 添加服务过滤
+                    if (this.options.services && this.options.services.length > 0) {
+                        options.filters = this.options.services.map(uuid => ({
+                            services: [uuid],
+                        }));
+                    }
+                    else {
+                        options.acceptAllDevices = true;
+                    }
+                    // 请求设备（浏览器会弹出选择框）
+                    this.device = yield navigator.bluetooth.requestDevice(options);
+                    // 监听设备广告（如果支持）
+                    if (this.device.watchAdvertisements) {
+                        this.device.addEventListener('advertisementreceived', (event) => {
+                            this.handleDeviceFound({
+                                deviceId: this.device.id,
+                                name: this.device.name,
+                                RSSI: event.rssi || -50,
+                                advertisData: event.manufacturerData,
+                            });
+                        });
+                        yield this.device.watchAdvertisements();
+                    }
+                    else {
+                        // 如果不支持广告监听，直接返回设备信息
+                        this.handleDeviceFound({
+                            deviceId: this.device.id,
+                            name: this.device.name,
+                            RSSI: -50, // 默认值
+                        });
+                    }
+                    resolve();
+                }
+                catch (error) {
+                    if (error.name === 'NotFoundError') {
+                        reject(Errors.scanFailed('用户取消了设备选择'));
+                    }
+                    else {
+                        reject(handlePlatformError(error, 'web'));
+                    }
+                }
+            }));
+        });
+    }
+    stopScanInternal() {
+        return __awaiter(this, void 0, void 0, function* () {
+            // Web Bluetooth 没有明确的停止扫描方法
+            // 设备选择后扫描就结束了
+            if (this.device && this.device.unwatchAdvertisements) {
+                yield this.device.unwatchAdvertisements();
+            }
+            return Promise.resolve();
+        });
+    }
+    checkPermissions() {
+        return __awaiter(this, void 0, void 0, function* () {
+            // Web Bluetooth 权限由浏览器自动管理
+            // 通过用户手势触发 requestDevice 时会自动请求权限
+            return true;
+        });
+    }
+    requestPermissions() {
+        return __awaiter(this, void 0, void 0, function* () {
+            // Web Bluetooth 不需要显式请求权限
+            return true;
+        });
+    }
+    onAdapterStateChange(callback) {
+        this.adapterStateListeners.push(callback);
+        // Web Bluetooth 没有适配器状态变化事件
+        // 直接返回当前状态
+        callback({
+            available: !!navigator.bluetooth,
+            discovering: this.state === 'scanning',
+        });
+    }
+    destroy() {
+        super.destroy();
+        this.device = null;
+        this.server = null;
+    }
+    /**
+     * 连接到设备（Web Bluetooth 特有）
+     */
+    connect() {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            if (!this.device) {
+                throw Errors.notInitialized();
+            }
+            try {
+                this.server = (yield ((_a = this.device.gatt) === null || _a === void 0 ? void 0 : _a.connect())) || null;
+                return this.server;
+            }
+            catch (error) {
+                throw handlePlatformError(error, 'web');
+            }
+        });
+    }
+    /**
+     * 断开连接（Web Bluetooth 特有）
+     */
+    disconnect() {
+        var _a;
+        if (this.device && ((_a = this.device.gatt) === null || _a === void 0 ? void 0 : _a.connected)) {
+            this.device.gatt.disconnect();
+        }
+        this.server = null;
+    }
+    /**
+     * 获取已连接的服务（Web Bluetooth 特有）
+     */
+    getServices() {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this.server) {
+                throw Errors.notInitialized();
+            }
+            try {
+                return yield this.server.getPrimaryServices();
+            }
+            catch (error) {
+                throw handlePlatformError(error, 'web');
+            }
+        });
+    }
+}
+/**
+ * 检查浏览器是否支持 Web Bluetooth
+ */
+function isWebBluetoothSupported() {
+    return 'bluetooth' in navigator && typeof navigator.bluetooth.requestDevice === 'function';
+}
+
 /**
  * 创建蓝牙扫描器
  * @param options 创建选项
@@ -1734,6 +1902,14 @@ function createScanner(options = {}) {
     const { type = 'auto', platformConfig = {} } = options;
     const platform = getPlatform();
     const app = isApp();
+    // 检测是否在浏览器环境
+    const isWeb = typeof window !== 'undefined' && !app;
+    // 如果是 Web 环境或指定使用 Web 扫描器
+    if (type === 'web' || (type === 'auto' && isWeb)) {
+        const webScanner = new WebScanner();
+        Object.assign(webScanner, { platformConfig });
+        return webScanner;
+    }
     // 根据类型和平台选择合适的扫描器
     if (type === 'uniapp' || (type === 'auto' && !app)) {
         // 使用 UniApp 标准 API
@@ -1799,6 +1975,7 @@ exports.Errors = Errors;
 exports.HarmonyNativeScanner = HarmonyNativeScanner;
 exports.IOSNativeScanner = IOSNativeScanner;
 exports.UniAppScanner = UniAppScanner;
+exports.WebScanner = WebScanner;
 exports.arrayBufferToBase64 = arrayBufferToBase64;
 exports.base64ToArrayBuffer = base64ToArrayBuffer;
 exports.checkPermissions = checkPermissions;
@@ -1813,6 +1990,7 @@ exports.getPlatformName = getPlatformName;
 exports.isApp = isApp;
 exports.isBluetoothSupported = isBluetoothSupported;
 exports.isPlatform = isPlatform;
+exports.isWebBluetoothSupported = isWebBluetoothSupported;
 exports.matchUUID = matchUUID;
 exports.parseAdvertisementData = parseAdvertisementData;
 exports.requestPermissions = requestPermissions;

package/dist/platforms/web-scanner.d.ts

@@ -0,0 +1,35 @@
+import { BaseScanner } from '../core/base-scanner';
+import { Platform, AdapterState } from '../types';
+/**
+ * Web 浏览器蓝牙扫描器
+ * 使用 Web Bluetooth API
+ */
+export declare class WebScanner extends BaseScanner {
+    private device;
+    private server;
+    getPlatform(): Platform;
+    init(): Promise<void>;
+    protected startScanInternal(): Promise<void>;
+    protected stopScanInternal(): Promise<void>;
+    checkPermissions(): Promise<boolean>;
+    requestPermissions(): Promise<boolean>;
+    onAdapterStateChange(callback: (state: AdapterState) => void): void;
+    destroy(): void;
+    /**
+     * 连接到设备（Web Bluetooth 特有）
+     */
+    connect(): Promise<BluetoothRemoteGATTServer | null>;
+    /**
+     * 断开连接（Web Bluetooth 特有）
+     */
+    disconnect(): void;
+    /**
+     * 获取已连接的服务（Web Bluetooth 特有）
+     */
+    getServices(): Promise<BluetoothRemoteGATTService[]>;
+}
+/**
+ * 检查浏览器是否支持 Web Bluetooth
+ */
+export declare function isWebBluetoothSupported(): boolean;
+//# sourceMappingURL=web-scanner.d.ts.map

package/dist/platforms/web-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-scanner.d.ts","sourceRoot":"","sources":["../../src/platforms/web-scanner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EACL,QAAQ,EACR,YAAY,EAIb,MAAM,UAAU,CAAC;AAIlB;;;GAGG;AACH,qBAAa,UAAW,SAAQ,WAAW;IACzC,OAAO,CAAC,MAAM,CAAgC;IAC9C,OAAO,CAAC,MAAM,CAA0C;IAExD,WAAW,IAAI,QAAQ;IAIjB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;cAgBX,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;cAqDlC,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAS3C,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC;IAMpC,kBAAkB,IAAI,OAAO,CAAC,OAAO,CAAC;IAK5C,oBAAoB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,IAAI;IAWnE,OAAO,IAAI,IAAI;IAMf;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,yBAAyB,GAAG,IAAI,CAAC;IAa1D;;OAEG;IACH,UAAU,IAAI,IAAI;IAOlB;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,0BAA0B,EAAE,CAAC;CAW3D;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,OAAO,CAEjD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fww_123/uni-ble-scanner",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "跨平台蓝牙低功耗扫描组件，支持安卓、鸿蒙、iOS",
   "main": "dist/index.js",
   "module": "dist/index.esm.js",

package/src/factory.ts

@@ -3,12 +3,13 @@ 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 { WebScanner } from './platforms/web-scanner';
 import { getPlatform, isApp } from './utils/platform';
 
 /**
  * 扫描器类型
  */
-export type ScannerType = 'auto' | 'uniapp' | 'native';
+export type ScannerType = 'auto' | 'uniapp' | 'native' | 'web';
 
 /**
  * 创建扫描器的选项
@@ -30,6 +31,16 @@ export function createScanner(options: CreateScannerOptions = {}): IBLEScanner {
   const platform = getPlatform();
   const app = isApp();
 
+  // 检测是否在浏览器环境
+  const isWeb = typeof window !== 'undefined' && !app;
+
+  // 如果是 Web 环境或指定使用 Web 扫描器
+  if (type === 'web' || (type === 'auto' && isWeb)) {
+    const webScanner = new WebScanner();
+    Object.assign(webScanner, { platformConfig });
+    return webScanner;
+  }
+
   // 根据类型和平台选择合适的扫描器
   if (type === 'uniapp' || (type === 'auto' && !app)) {
     // 使用 UniApp 标准 API
@@ -45,17 +56,17 @@ export function createScanner(options: CreateScannerOptions = {}): IBLEScanner {
         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();
@@ -70,6 +81,14 @@ export function createScanner(options: CreateScannerOptions = {}): IBLEScanner {
   return defaultScanner;
 }
 
+/**
+ * 创建 Web 扫描器
+ * 使用 Web Bluetooth API，适用于浏览器环境
+ */
+export function createWebScanner(platformConfig?: PlatformConfig): IBLEScanner {
+  return createScanner({ type: 'web', platformConfig });
+}
+
 /**
  * 创建 UniApp 扫描器
  * 使用 UniApp 标准蓝牙 API，兼容所有平台

package/src/index.ts

@@ -48,6 +48,7 @@ export { UniAppScanner } from './platforms/uniapp-scanner';
 export { AndroidNativeScanner } from './platforms/android-native';
 export { IOSNativeScanner } from './platforms/ios-native';
 export { HarmonyNativeScanner } from './platforms/harmony-native';
+export { WebScanner, isWebBluetoothSupported } from './platforms/web-scanner';
 
 // 默认导出
 import { createScanner } from './factory';

package/src/platforms/web-scanner.ts

@@ -0,0 +1,177 @@
+import { BaseScanner } from '../core/base-scanner';
+import {
+  Platform,
+  AdapterState,
+  BLEError,
+  PlatformConfig,
+  BLEDevice,
+} from '../types';
+import { Errors, createError, ErrorCodes, handlePlatformError } from '../utils/errors';
+import { normalizeDeviceData } from '../utils/data-parser';
+
+/**
+ * Web 浏览器蓝牙扫描器
+ * 使用 Web Bluetooth API
+ */
+export class WebScanner extends BaseScanner {
+  private device: BluetoothDevice | null = null;
+  private server: BluetoothRemoteGATTServer | null = null;
+
+  getPlatform(): Platform {
+    return Platform.UNKNOWN;
+  }
+
+  async init(): Promise<void> {
+    return new Promise((resolve, reject) => {
+      // 检查浏览器是否支持 Web Bluetooth
+      if (!navigator.bluetooth) {
+        reject(createError(
+          ErrorCodes.UNSUPPORTED_PLATFORM,
+          '当前浏览器不支持 Web Bluetooth API，请使用 Chrome、Edge 或 Opera'
+        ));
+        return;
+      }
+
+      this.initialized = true;
+      resolve();
+    });
+  }
+
+  protected async startScanInternal(): Promise<void> {
+    return new Promise(async (resolve, reject) => {
+      try {
+        // Web Bluetooth 使用 requestDevice 而不是扫描
+        // 这会弹出浏览器的选择设备对话框
+        const options: RequestDeviceOptions = {
+          acceptAllDevices: true,
+        };
+
+        // 添加服务过滤
+        if (this.options.services && this.options.services.length > 0) {
+          options.filters = this.options.services.map(uuid => ({
+            services: [uuid],
+          }));
+        } else {
+          options.acceptAllDevices = true;
+        }
+
+        // 请求设备（浏览器会弹出选择框）
+        this.device = await navigator.bluetooth.requestDevice(options);
+
+        // 监听设备广告（如果支持）
+        if (this.device.watchAdvertisements) {
+          this.device.addEventListener('advertisementreceived', (event: any) => {
+            this.handleDeviceFound({
+              deviceId: this.device!.id,
+              name: this.device!.name,
+              RSSI: event.rssi || -50,
+              advertisData: event.manufacturerData,
+            });
+          });
+
+          await this.device.watchAdvertisements();
+        } else {
+          // 如果不支持广告监听，直接返回设备信息
+          this.handleDeviceFound({
+            deviceId: this.device.id,
+            name: this.device.name,
+            RSSI: -50, // 默认值
+          });
+        }
+
+        resolve();
+      } catch (error: any) {
+        if (error.name === 'NotFoundError') {
+          reject(Errors.scanFailed('用户取消了设备选择'));
+        } else {
+          reject(handlePlatformError(error, 'web'));
+        }
+      }
+    });
+  }
+
+  protected async stopScanInternal(): Promise<void> {
+    // Web Bluetooth 没有明确的停止扫描方法
+    // 设备选择后扫描就结束了
+    if (this.device && this.device.unwatchAdvertisements) {
+      await this.device.unwatchAdvertisements();
+    }
+    return Promise.resolve();
+  }
+
+  async checkPermissions(): Promise<boolean> {
+    // Web Bluetooth 权限由浏览器自动管理
+    // 通过用户手势触发 requestDevice 时会自动请求权限
+    return true;
+  }
+
+  async requestPermissions(): Promise<boolean> {
+    // Web Bluetooth 不需要显式请求权限
+    return true;
+  }
+
+  onAdapterStateChange(callback: (state: AdapterState) => void): void {
+    this.adapterStateListeners.push(callback);
+
+    // Web Bluetooth 没有适配器状态变化事件
+    // 直接返回当前状态
+    callback({
+      available: !!navigator.bluetooth,
+      discovering: this.state === 'scanning',
+    });
+  }
+
+  destroy(): void {
+    super.destroy();
+    this.device = null;
+    this.server = null;
+  }
+
+  /**
+   * 连接到设备（Web Bluetooth 特有）
+   */
+  async connect(): Promise<BluetoothRemoteGATTServer | null> {
+    if (!this.device) {
+      throw Errors.notInitialized();
+    }
+
+    try {
+      this.server = await this.device.gatt?.connect() || null;
+      return this.server;
+    } catch (error) {
+      throw handlePlatformError(error, 'web');
+    }
+  }
+
+  /**
+   * 断开连接（Web Bluetooth 特有）
+   */
+  disconnect(): void {
+    if (this.device && this.device.gatt?.connected) {
+      this.device.gatt.disconnect();
+    }
+    this.server = null;
+  }
+
+  /**
+   * 获取已连接的服务（Web Bluetooth 特有）
+   */
+  async getServices(): Promise<BluetoothRemoteGATTService[]> {
+    if (!this.server) {
+      throw Errors.notInitialized();
+    }
+
+    try {
+      return await this.server.getPrimaryServices();
+    } catch (error) {
+      throw handlePlatformError(error, 'web');
+    }
+  }
+}
+
+/**
+ * 检查浏览器是否支持 Web Bluetooth
+ */
+export function isWebBluetoothSupported(): boolean {
+  return 'bluetooth' in navigator && typeof navigator.bluetooth.requestDevice === 'function';
+}

package/src/types/web-bluetooth.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Web Bluetooth API 类型声明
+ */
+
+interface BluetoothDevice extends EventTarget {
+  readonly id: string;
+  readonly name: string | null;
+  readonly gatt: BluetoothRemoteGATTServer | null;
+  readonly uuids: string[];
+  
+  watchAdvertisements(): Promise<void>;
+  unwatchAdvertisements(): Promise<void>;
+  
+  addEventListener(type: 'advertisementreceived', listener: (event: BluetoothAdvertisingEvent) => void): void;
+  addEventListener(type: string, listener: EventListenerOrEventListenerObject): void;
+}
+
+interface BluetoothRemoteGATTServer {
+  readonly device: BluetoothDevice;
+  readonly connected: boolean;
+  
+  connect(): Promise<BluetoothRemoteGATTServer>;
+  disconnect(): void;
+  getPrimaryService(service: string | number): Promise<BluetoothRemoteGATTService>;
+  getPrimaryServices(service?: string | number): Promise<BluetoothRemoteGATTService[]>;
+}
+
+interface BluetoothRemoteGATTService extends EventTarget {
+  readonly device: BluetoothDevice;
+  readonly uuid: string;
+  readonly isPrimary: boolean;
+  
+  getCharacteristic(characteristic: string | number): Promise<BluetoothRemoteGATTCharacteristic>;
+  getCharacteristics(characteristic?: string | number): Promise<BluetoothRemoteGATTCharacteristic[]>;
+  getIncludedService(service: string | number): Promise<BluetoothRemoteGATTService>;
+  getIncludedServices(service?: string | number): Promise<BluetoothRemoteGATTService[]>;
+}
+
+interface BluetoothRemoteGATTCharacteristic extends EventTarget {
+  readonly service: BluetoothRemoteGATTService;
+  readonly uuid: string;
+  readonly properties: BluetoothCharacteristicProperties;
+  readonly value: DataView | null;
+  
+  readValue(): Promise<DataView>;
+  writeValue(value: BufferSource): Promise<void>;
+  startNotifications(): Promise<BluetoothRemoteGATTCharacteristic>;
+  stopNotifications(): Promise<BluetoothRemoteGATTCharacteristic>;
+}
+
+interface BluetoothCharacteristicProperties {
+  readonly broadcast: boolean;
+  readonly read: boolean;
+  readonly writeWithoutResponse: boolean;
+  readonly write: boolean;
+  readonly notify: boolean;
+  readonly indicate: boolean;
+  readonly authenticatedSignedWrites: boolean;
+  readonly reliableWrite: boolean;
+  readonly writableAuxiliaries: boolean;
+}
+
+interface BluetoothAdvertisingEvent extends Event {
+  readonly device: BluetoothDevice;
+  readonly rssi: number;
+  readonly txPower: number;
+  readonly manufacturerData: Map<number, DataView>;
+  readonly serviceData: Map<string, DataView>;
+  readonly uuids: string[];
+  readonly name: string | null;
+  readonly appearance: number | null;
+}
+
+interface BluetoothScanFilter {
+  services?: string[];
+  name?: string;
+  namePrefix?: string;
+  manufacturerData?: Map<number, BluetoothManufacturerDataFilter>;
+}
+
+interface BluetoothManufacturerDataFilter {
+  companyIdentifier: number;
+  dataPrefix?: DataView;
+  mask?: DataView;
+}
+
+interface RequestDeviceOptions {
+  filters?: BluetoothScanFilter[];
+  optionalServices?: string[];
+  acceptAllDevices?: boolean;
+}
+
+interface Bluetooth extends EventTarget {
+  requestDevice(options: RequestDeviceOptions): Promise<BluetoothDevice>;
+  getAvailability(): Promise<boolean>;
+  
+  addEventListener(type: 'availabilitychanged', listener: (event: Event) => void): void;
+  addEventListener(type: string, listener: EventListenerOrEventListenerObject): void;
+}
+
+interface Navigator {
+  bluetooth: Bluetooth;
+}