BluetoothAdapter (Firefox OS) - Archive of obsolete content

在此页

Interface overview
特性
方法
规范
浏览器兼容性
另请参阅
相关话题

This API is available on Firefox OS for internal applications 仅。

BluetoothAdapter 接口在 Web Bluetooth API is used to handle all the operations requested by Bluetooth networks. A Bluetooth adapter is the physical interface which is used to interact with local Bluetooth device.

Interface overview

[CheckPermissions="bluetooth"]
interface BluetoothAdapter: EventTarget
{
  [AvailableIn=CertifiedApps] readonly attribute DOMString address;
  [AvailableIn=CertifiedApps] readonly attribute BluetoothPairingListener pairingReqs;
  readonly attribute BluetoothAdapterState state;
  readonly attribute DOMString name;
  readonly attribute boolean discoverable;
  readonly attribute boolean discovering;
  readonly attribute BluetoothGattServer? gattServer;
           attribute EventHandler onattributechanged;
           attribute EventHandler ondevicepaired;
           attribute EventHandler ondeviceunpaired;
           attribute EventHandler onpairingaborted;
  [NewObject, AvailableIn=CertifiedApps] Promise<void> enable();
  [NewObject, AvailableIn=CertifiedApps] Promise<void> disable();
  [NewObject, AvailableIn=CertifiedApps] Promise<void> setName(DOMString aName);
  [NewObject] Promise<void> setDiscoverable(boolean aDiscoverable);
  [NewObject] Promise<BluetoothDiscoveryHandle> startDiscovery();
  [NewObject] Promise<void> stopDiscovery();
  [NewObject] Promise<void> pair(DOMString aAddress);
  [NewObject] Promise<void> unpair(DOMString aAddress);
  sequence<BluetoothDevice> getPairedDevices();
  // BLE methods
  [NewObject] Promise<BluetoothDiscoveryHandle> startLeScan(sequence<DOMString> aServiceUuids);
  [NewObject] Promise<void> stopLeScan(BluetoothDiscoveryHandle aDiscoveryHandle);
};

特性

BluetoothAdapter.address 只读
BluetoothAdapter.discoverable 只读: A boolean indicating if the device is discoverable ( true ) 或不 ( false ) by other Bluetooth devices.
BluetoothAdapter.discovering 只读: A boolean indicating if the device's adapter is in the process of discovering ( true ) 或不 ( false ) surrounding Bluetooth devices.
BluetoothAdapter.gattServer 只读: 返回 BluetoothGattServer to use to conduct GATT server operations on the local bluetooth adapter. Will return null if the adapter is not enabled.
BluetoothAdapter.name 只读
BluetoothAdapter.pairingReqs 只读: 返回 BluetoothPairingListener object containing the event handlers needed to response to different pairing types operations.
BluetoothAdapter.state 只读

事件处理程序

BluetoothAdapter.onattributechanged: 处理程序为 attributechanged event; it is triggered when one of the local bluetooth adapter's properties has changed
BluetoothAdapter.ondevicepaired: 处理程序为 devicepaired event; it is triggered when a remote device gets paired with the local bluetooth adapter.
BluetoothAdapter.ondeviceunpaired: 处理程序为 deviceunpaired event; it is triggered when a remote device gets unpaired from the local bluetooth adapter.
BluetoothAdapter.onpairingaborted: 处理程序为 pairingaborted event; it is triggered when pairing fails due to authentication failure, the remote device being down (bluetooth ACL becomes disconnected), or some kind of internal error.

注意： 由于 BluetoothAdapter interface inherits from the EventTarget interface, all these events can be listened by using the addEventListener 方法。

过时特性

BluetoothAdapter.class 只读
BluetoothAdapter.discoverableTimeout 只读
BluetoothAdapter.devices 只读: An 数组 of BluetoothDevice object representing all the Bluetooth devices discovered in the area surrounding the device.
BluetoothAdapter.uuids 只读: An 数组 of string, each of them representing the UUID of a Bluetooth service the device's adapter is able to provide.

Obsolete event handlers

BluetoothAdapter.ona2dpstatuschanged: 处理程序为 a2dpstatuschanged event; it is triggered when an A2DP connection status changes.
BluetoothAdapter.ondevicefound: 处理程序为 devicefound event; it is triggered when a Bluetooth device is found.
BluetoothAdapter.onhfpstatuschanged: 处理程序为 hfpstatuschanged event; it is triggered when an HFP connection status changes.
BluetoothAdapter.onpairedstatuschanged: 处理程序为 pairedstatuschanged event; it is triggered when a pairing process is completed.
BluetoothAdapter.onrequestmediaplaystatus: 处理程序为 requestmediaplaystatus event; it is triggered when a remote Bluetooth device queries the current media play status.
BluetoothAdapter.onscostatuschanged: 处理程序为 scostatuschanged event; it is triggered when a SCO connection status changes.

方法

BluetoothAdapter.enable()
BluetoothAdapter.disable()
BluetoothAdapter.getPairedDevices()
BluetoothAdapter.pair()
BluetoothAdapter.setDiscoverable(): Allows to change the value of the discoverable 特性。
BluetoothAdapter.startDiscovery()
BluetoothAdapter.startLeScan()
BluetoothAdapter.setName(): Allows to change the value of the 名称 特性。
BluetoothAdapter.stopDiscovery()
BluetoothAdapter.stopLeScan()
BluetoothAdapter.unpair()

过时方法

BluetoothAdapter.answerWaitingCall(): Allows HFP devices to answer a pending incoming call on a CDMA network.
BluetoothAdapter.confirmReceivingFile()
BluetoothAdapter.connect()
BluetoothAdapter.connectSco()
BluetoothAdapter.disconnect()
BluetoothAdapter.disconnectSco()
BluetoothAdapter.getConnectedDevices()
BluetoothAdapter.ignoreWaitingCall(): Allows HFP devices to dismiss a pending incoming call on a CDMA network.
BluetoothAdapter.isConnected()
BluetoothAdapter.isScoConnected()
BluetoothAdapter.sendFile()
BluetoothAdapter.sendMediaMetaData(): Allows to send metadata about a media to remote devices connected with the AVRCP profile.
BluetoothAdapter.sendMediaPlayStatus(): Allows to send the play status of the device to remote devices connected with the AVRCP profile.
BluetoothAdapter.setDiscoverableTimeout(): Allows to change the value of the discoverableTimeout 特性。
BluetoothAdapter.setPairingConfirmation()
BluetoothAdapter.setPasskey()
BluetoothAdapter.setPinCode()
BluetoothAdapter.stopSendingFile()
BluetoothAdapter.toggleCalls(): Allows HFP devices to switch from one call to the other on a CDMA network.

规范

规范	状态	注释
Web Bluetooth The definition of 'BluetoothAdapter' in that specification.	草案	Rough draft; not part of any official specification yet. It should be discussed as part of the W3C's System Applications Working Group .

浏览器兼容性

Firefox OS 2.1 adds Bluetooth 'v2' support: pairingReqs , state , onadapterremoved, gattServer , onattributechange , ondevicepaired , ondeviceunpaired , onpairingaborted, enable(), disable(), startLeScan(), stopLeScan()

Firefox 1.0.1 Bluetooth initial support: address , discoverable, discovering , 名称 , class , discoverableTimeout , devices , uuids, ona2dpstatuschanged , ondevicefound , onhfpstatuschanged , onpairedstatuschanged , onrequestmediaplaystatus , onscostatuschanged , setName() , setDiscoverable() , startDiscovery() , stopdiscovery() , pair() , unpair() , getPairedDevices(), answerWaitingCall(), confirmReceivingFile(), connect(), connectSco(), disconnect(), disconnectSco(), getConnectedDevices(), ignoreWaitingCall(), isConnected(), isScoConnected(), sendFile(), sendMediaMetaData(), sendMediaPlayStatus(), setDiscoverableTimeout(), setPairingConformation(), setPasskey(), setPinCode(), stopSendingFile(), toggleCalls()

另请参阅

Using the Web Bluetooth API

元数据

最后修改： 2019 年 3 月 23 日

在此页