artteth/com-port-scanner-web-app-test
GitHub: artteth/com-port-scanner-web-app-test
这是一个基于 Web Bluetooth API 的渐进式 Web 应用,用于在浏览器中连接并实时读取 BLE 条码扫描器的数据。
Stars: 0 | Forks: 0
# BLE 扫描器 PWA
Bluetooth Low Energy (BLE) 条码扫描器 Web 应用程序。
## 功能
- 连接 BLE 条码扫描器
- 实时扫描数据显示
- PWA 支持(可安装到主屏幕)
- 适用于 Android (Chrome) 和 iOS (Safari)
## 设置
1. **启动本地服务器:**
node server.js
2. **在浏览器中打开:**
- Android: Chrome 中访问 `http://YOUR_IP:3000`
- iOS: Safari 中访问 `http://YOUR_IP:3000`
- 本地: `http://localhost:3000`
3. **连接扫描器:**
- 将扫描器置于 BLE 模式
- 点击“Connect Scanner”
- 从列表中选择您的设备
## BLE 配置
应用尝试使用标准 BLE 服务进行连接。如果您的扫描器使用自定义 UUID,您可能需要在 `app.js` 中更新它们:
```
this.services = [
'YOUR_SERVICE_UUID'
];
```
常见的条码扫描器 BLE 服务:
- `0000180a-0000-1000-8000-00805f9b34fb` - Device Information
- `0000180f-0000-1000-8000-00805f9b34fb` - Battery Service
## 浏览器支持
| 平台 | 浏览器 | 支持 |
|----------|---------|---------|
| Android | Chrome | ✅ 完全支持 |
| iOS | Safari | ✅ 完全支持 |
| Desktop | Chrome | ✅ 完全支持 |
| Desktop | Firefox | ❌ 不支持 |
| Desktop | Edge | ✅ 完全支持 |
## PWA 安装
- **Android**: Chrome → 菜单 → “Add to Home screen”
- **iOS**: Safari → 分享 → “Add to Home Screen”
## 注意事项
- 需要 HTTPS(或开发环境下的 localhost)
- 建立 BLE 连接需要用户手势
- 扫描器必须支持 BLE 模式(不支持 SPP)
标签:Android, BLE, DSL, GNU通用公共许可证, HTTPS, iOS, MITM代理, Node.js, PWA, Web API, Web蓝牙, 串口通信, 低功耗蓝牙, 外设, 实时数据, 扫描枪, 数据可视化, 本地开发, 条码扫描, 渐进式Web应用, 物联网, 硬件连接, 移动端适配, 自定义脚本, 蓝牙, 虚拟串口