promise不直接扫描蓝牙设备,而是封装bluetooth api的异步操作;requestdevice()返回promise用于用户选择设备,watchadvertisements()需用promise+abortcontroller封装超时监听,批量扫描需结合promise.all、去重和错误处理。

Promise 本身不直接处理蓝牙设备扫描结果,它只是封装异步操作的工具;真正发起扫描的是 Bluetooth API(如 navigator.bluetooth.requestDevice() 或 watchAdvertisements()),这些 API 返回 Promise 或基于事件的流,你需要用 Promise 配合事件监听、超时控制和结果聚合来合理管理扫描过程。
用 Promise 封装 requestDevice() 获取单个设备
这是最常用的方式,适合用户主动选择设备的场景。该方法返回 Promise,成功后得到一个 BluetoothDevice 实例:
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
async function selectBluetoothDevice() {
try {
const device = await navigator.bluetooth.requestDevice({
acceptAllDevices: true,
optionalServices: ['battery_service'] // 可选,用于过滤
});
console.log('选中的设备:', device.name, device.id);
return device;
} catch (err) {
console.error('设备选择失败:', err.name, err.message);
throw err;
}
}
- 注意:必须在安全上下文(HTTPS 或 localhost)中运行
- 需用户手动授权并点击设备,不能后台自动扫描
- 返回的 Promise 在用户取消或拒绝权限时会 reject
用 Promise 包裹广告扫描(watchAdvertisements())
Chrome 95+ 支持通过 watchAdvertisements() 持续监听附近广播的 BLE 设备,但它返回的是 AsyncIterator,不是 Promise。你可以用 Promise 封装“等待首个有效广告”逻辑:
async function waitForFirstAdvertisement(timeoutMs = 5000) {
return new Promise((resolve, reject) => {
const controller = new AbortController();
const timeoutId = setTimeout(() => {
controller.abort();
reject(new Error('扫描超时'));
}, timeoutMs);
navigator.bluetooth.requestDevice({ acceptAllDevices: true })
.then(device => device.watchAdvertisements({ signal: controller.signal }))
.then(iterator => {
const onAdvertisement = async () => {
try {
const { value, done } = await iterator.next();
if (done) return;
console.log('收到广告:', value.device.name || value.device.id);
clearTimeout(timeoutId);
resolve(value.device);
} catch (e) {
if (e.name !== 'AbortError') reject(e);
}
};
onAdvertisement();
})
.catch(reject);
});
}
- 这个封装把“监听一次有效广告”变成了可 await 的 Promise
- 依赖
AbortController实现超时和提前终止 - 实际项目中建议加设备去重和信号强度过滤
批量扫描并 Promise.all 聚合多个设备(模拟“发现列表”)
标准 Web Bluetooth 不支持无交互式批量扫描,但可通过反复调用 requestDevice(配合不同过滤条件)或结合服务发现 + 广告解析来逼近效果。更实用的做法是用 Promise 链/数组控制扫描节奏:
- 启动扫描前先检查
navigator.bluetooth是否可用 - 用
Promise.race()设置全局超时,避免卡死 - 将每次
device.gatt.connect()等后续操作也包装为 Promise,统一错误处理 - 使用
Set去重设备 ID,防止重复添加
常见陷阱与建议
- 不要在非 secure context 下调用,否则 Promise 直接 reject 并报错 “NotSupportedError”
- 用户未开启蓝牙时,
requestDevice的 Promise 会 pending 很久,建议加 UI 提示并提供手动重试 - Android Chrome 对后台广告监听有限制,iOS Safari 不支持 Web Bluetooth,需降级提示
- 扫描结果里的设备名可能为空(尤其未配对设备),优先用
device.id做唯一标识
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










