BluetoothRemoteGATTServer - Web APIs 编辑

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.connectedRead 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.deviceRead 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 specified BluetoothServiceUUID.

BluetoothRemoteGATTServer.getPrimaryServices()

Returns a promise to a list of primary BluetoothGATTService objects offered by the bluetooth device for a specified BluetoothServiceUUID.

Specifications

Browser compatibility

BCD tables only load in the browser