Experimental
This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The BluetoothRemoteGATTServer
interface of the Web Bluetooth API represents a GATT
Server on a remote device.
This page describes the W3C Community Group Web Bluetooth API. For the Firefox OS
Bluetooth API, see BluetoothGattServer
(Firefox OS).
Interface
interface BluetoothRemoteGATTServer {
readonly attribute BluetoothDevice device;
readonly attribute boolean connected;
Promise<BluetoothRemoteGATTServer> connect();
void disconnect();
Promise<BluetoothRemoteGATTService> getPrimaryService(BluetoothServiceUUID service);
Promise<sequence<BluetoothRemoteGATTService>> getPrimaryServices(optional BluetoothServiceUUID service);
};
Properties
BluetoothRemoteGATTServer.connected
Read only- A boolean value that returns true while this script execution environment is
connected to
this.device
. It can be false while the user agent is physically connected. BluetoothRemoteGATTServer.device
Read only- A reference to the
BluetoothDevice
running the server.
Methods
BluetoothRemoteGATTServer.connect()
- Causes the script execution environment to connect to
this.device
. BluetoothRemoteGATTServer.disconnect()
- Causes the script execution environment to disconnect from
this.device
. BluetoothRemoteGATTServer.getPrimaryService()
- Returns a promise to the primary
BluetoothGATTService
offered by the bluetooth device for a specifiedBluetoothServiceUUID
. BluetoothRemoteGATTServer.getPrimaryServices()
- Returns a promise to a list of primary
BluetoothGATTService
objects offered by the bluetooth device for a specifiedBluetoothServiceUUID
.
Specifications
Specification | Status | Comment |
---|---|---|
Web Bluetooth The definition of 'BluetoothRemoteGATTServer' in that specification. |
Draft | Initial definition. |
Browser compatibility
BCD tables only load in the browser