MDN wants to learn about developers like you: https://qsurvey.mozilla.com/s3/MDN-dev-survey

Bluetooth.requestDevice()

这是一个实验中的功能
此功能某些浏览器尚在开发中,请参考浏览器兼容性表格以得到在不同浏览器中适合使用的前缀。由于该功能对应的标准文档可能被重新修订,所以在未来版本的浏览器中该功能的语法和行为可能随之改变。

Bluetooth接口的Bluetooth.requestDevice()方法返回一个带有对应options的BluetoothDevice对象的Promise对象. 如果没有蓝牙设备选择界面,则此方法返回与条件匹配的第一个设备。

语法

Bluetooth.requestDevice(options).then(function(bluetoothDevice) { ... })

返回值

带有BluetoothDevice 对象的Promise 对象.

参数

options 
设置设备请求选项的对象. 可用的选项是:
  • filters[]: 一个BluetoothScanFilters数组。 此过滤器由一个BluetoothServiceUUID数组,一个名称参数和一个namePrefix参数组成。
  • optionalServices[]: 一个BluetoothServiceUUID数组。
  • acceptAllDevices: boolean 表示请求脚本可以接受所有蓝牙设备。 默认值为false。

示例

//扫描选项匹配任何设备广播:

//. 标准心率服务。

//. 两个16位服务ID 0x1802和0x1803。

//. 专有的128位UUID服务c48e6067-5295-48d3-8d5c-0395f61792b1。

//. 名称为“设备名”的设备。

//. 名称以“前缀”开头的设备。

//

//如果设备包含电池服务,

//即使设备不通告该服务,也可以访问电池服务。

let options = {
  filters: [
    {services: ['heart_rate']},
    {services: [0x1802, 0x1803]},
    {services: ['c48e6067-5295-48d3-8d5c-0395f61792b1']},
    {name: '设备名'},
    {namePrefix: '前缀'}
  ],
  optionalServices: ['battery_service']
}

navigator.bluetooth.requestDevice(options).then(function(device) {
  console.log('名称: ' + device.name);
  // 在此处实现设备调用
})
.catch(function(error) {
  console.log("出现错误: " + error);
});

查看详细示例 

规范

规范 状态 说明
Web Bluetooth
requestDevice()
Draft Initial definition.

浏览器兼容性

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support 56     43  
Feature Android Webview Chrome for Android Firefox Mobile (Gecko) Firefox OS IE Mobile Opera Mobile Safari Mobile
Basic support 未实现 56       43  

文档标签和贡献者

标签: 
 此页面的贡献者: hefang
 最后编辑者: hefang,