Android蓝牙4.0API-类-BluetoothGatt

Public API for the Bluetooth GATT Profile. 

适用于GATT协议，实现控制等

This class provides Bluetooth GATT functionality to enable communication with Bluetooth Smart or Smart Ready devices.

To connect to a remote peripheral device, create a BluetoothGattCallback and call connectGatt(Context, boolean, BluetoothGattCallback) to get a instance of this class.通过上述两个方法得到这个类的一个实例。 GATT capable能干的 devices can be discovered using the Bluetooth device discovery or BLE scan process.

常量

int CONNECTION_PRIORITY_BALANCED

Connection paramter参数 update - Use the connection paramters recommended推荐，介绍 by the Bluetooth SIG.

int CONNECTION_PRIORITY_HIGH

Connection paramter update - Request a high priority优先级, low latency延迟 connection.

int CONNECTION_PRIORITY_LOW_POWER

Connection paramter update - Request low power, reduced data rate connection parameters.

int GATT_CONNECTION_CONGESTED

远程设备被阻塞

int GATT_FAILURE

A GATT operation failed, errors other than the above

int GATT_INSUFFICIENT_AUTHENTICATION

Insufficient 不足authentication 认证for a given operation

int GATT_INSUFFICIENT_ENCRYPTION

Insufficient encryption加密 for a given operation

int GATT_INVALID_ATTRIBUTE_LENGTH

A write operation exceeds the maximum length of the attribute长度超出限制

int GATT_INVALID_OFFSET

A read or write operation was requested with an invalid无效的 offset补偿抵消

int GATT_READ_NOT_PERMITTED

读的权限不足

int GATT_REQUEST_NOT_SUPPORTED

The given request is not supported

int GATT_SUCCESS

A GATT operation completed successfully

int GATT_WRITE_NOT_PERMITTED

公有方法

void abortReliableWrite()

Cancels a reliable可靠的 write transaction事务 for a given device.

void abortReliableWrite(BluetoothDevice mDevice)

This method was deprecated in API level 19. Use abortReliableWrite()

boolean beginReliableWrite()

Initiates 启用a reliable write transaction for a given remote device.

void close()

关闭GATT客户端

boolean connect();

Connect back to remote device

void disconnect()

Disconnects an established 已建立的connection, or cancels a connection attempt currently in progress.

boolean discoverServices()

Discovers services offered by a remote device as well as their characteristics and descriptors.特征和描述

boolean executeReliableWrite()

Executes a reliable write transaction for a given remote device.执行写的命令

List<BluetoothDevice> getConnectedDevices()

Not supported - please use getConnectedDevices(int) with GATT as argument

int  getConnectionState( BluetoothDevice device)

Not supported - please use getConnectedDevices(int) with GATT as argument论证

BluetoothDevice  getDevice ()

return the remote bluetooth device this GATT client targets to

List < BluetoothDevice > getDevicesMatchingConnectionStates(int[] states)

Not supported - please use getDevicesMatchingConnectionStates(int, int[]) with GATT as first argument
BluetoothGattService getService(UUID uuid)

Returns a BluetoothGattService, if the requested UUID is supported by the remote device.

List<BluetoothGattService> getServices()

Returns a list of GATT services offered by the remote device.

boolean readCharacteristic(BluetoothGattCharacteristic characteristic)

Reads the requested characteristic from the associated关联的 remote device.

boolean readDescriptor(BluetoothGattDescriptor descriptor)

Reads the value for a given descriptor from the associated remote device.

boolean readRemoteRssi()

Read the RSSI for a connected remote device.

boolean requestConnectionPriority(int connectionPriority)

Request a connection parameter update

boolean requestMtu(int mtu)

Request an MTU size used for a given connection.

boolean setCharacteristicNotification(BluetoothGattCharacteristic characteristic, boolean enable)

Enable or disable notifications/indications for a given characteristic.

boolean writeCharacteristic(BluetoothGattCharacteristic characteristic)

Writes a given characteristic and its values to the associated remote device.

boolean writeDescriptor(BluetoothGattDescriptor descriptor)

Write the value of a given descriptor to the associated remote device.