Bluetooth.requestDevice()

在此页

句法
异常
范例
规范
浏览器兼容性
相关话题

安全上下文
此特征只可用于安全上下文 (HTTPS)，在某些或所有支持浏览器 .

这是实验性技术
检查浏览器兼容性表格要小心谨慎在生产中使用这之前。

Bluetooth.requestDevice() 方法在 蓝牙 interface returns a Promise to a BluetoothDevice object with the specified options. If there is no chooser UI, this method returns the first device matching the criteria.

句法

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

A Promise to a BluetoothDevice 对象。

参数

选项可选

An object that sets options for the device request. The available options are:

filters[] : An array of BluetoothScanFilters . This filter consists of an array of BluetoothServiceUUID s, a 名称 参数，和 namePrefix 参数。
optionalServices[] : An array of BluetoothServiceUUID 。
acceptAllDevices : A 布尔 indicating that the requesting script can accept all Bluetooth devices. The default is false .

异常

TypeError: 提供的 选项 do not makes sense. For example, options.filters 存在且 options.acceptAllDevices is true ，或者若 options.filters is not present and options.acceptAllDevices is false . Or options.filters is [] .
NotFoundError
SecurityError

范例

// Discovery options match any devices advertising:
// . The standard heart rate service.
// . Both 16-bit service IDs 0x1802 and 0x1803.
// . A proprietary 128-bit UUID service c48e6067-5295-48d3-8d5c-0395f61792b1.
// . Devices with name "ExampleName".
// . Devices with name starting with "Prefix".
//
// And enables access to the battery service if devices
// include it, even if devices do not advertise that service.
let options = {
  filters: [
    {services: ['heart_rate']},
    {services: [0x1802, 0x1803]},
    {services: ['c48e6067-5295-48d3-8d5c-0395f61792b1']},
    {name: 'ExampleName'},
    {namePrefix: 'Prefix'}
  ],
  optionalServices: ['battery_service']
}
navigator.bluetooth.requestDevice(options).then(function(device) {
  console.log('Name: ' + device.name);
  // Do something with the device.
})
.catch(function(error) {
  console.log("Something went wrong. " + error);
});

Detailed examples are in the specification.

规范

规范	状态	注释
Web Bluetooth The definition of 'requestDevice()' in that specification.	草案	初始定义。

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据

	桌面						移动
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
`requestDevice`	Chrome 56 注意事项 56 注意事项 macOS only. 56 注意事项 Disabled Linux and versions of Windows earlier than 10. Disabled From version 56: this feature is behind the `#enable-experimental-web-platform-features` preference (needs to be set to `enabled` ). To change preferences in Chrome, visit chrome://flags. 70 注意事项 Windows 10.	Edge ≤79 注意事项 ≤79 注意事项 macOS only. ≤79 注意事项 Disabled Linux and versions of Windows earlier than 10. Disabled From version ≤79: this feature is behind the `#enable-experimental-web-platform-features` preference (needs to be set to `enabled` ). ≤79 注意事项 Windows 10.	Firefox 不支持 No	IE 不支持 No	Opera 43 注意事项 43 注意事项 macOS only. 43 注意事项 Disabled Linux and versions of Windows earlier than 10. Disabled From version 43: this feature is behind the `#enable-experimental-web-platform-features` preference (needs to be set to `enabled` ). 57 注意事项 Windows 10.	Safari 不支持 No	WebView Android 不支持 No	Chrome Android 56	Firefox Android 不支持 No	Opera Android 43	Safari iOS 不支持 No	Samsung Internet Android 6.0

图例

完整支持
不支持
实验。期望将来行为有所改变。

用户必须明确启用此特征。

元数据

最后修改： Apr 4, 2020

在此页

句法

返回

参数

异常

范例

规范

浏览器兼容性

图例

相关话题