当前位置：首页 > news >正文

Android 低功率蓝牙之BluetoothGattCharacteristic详解

news 来源：原创 2025/5/18 12:09:58

BluetoothGattCharacteristic 是 Android 蓝牙低功耗（BLE）开发中的一个核心类，用于表示 GATT（Generic Attribute Profile）服务中的特征值（Characteristic）。特征值是 BLE 设备之间通信的基本数据单元，通常用于读取、写入或通知数据。

1. 基本概念

GATT: Generic Attribute Profile，定义了 BLE 设备之间通信的数据结构和协议。
Characteristic: 特征值，是 GATT 服务中的一个数据点，包含一个值和一组描述符（Descriptors）。
Descriptor: 描述符，用于描述特征值的元数据，例如特征值的格式、权限等。

2. BluetoothGattCharacteristic 的主要属性

UUID: 唯一标识符，用于区分不同的特征值。
Properties: 特征值的属性，定义了可以对特征值执行的操作（如读、写、通知等）。
Value: 特征值的实际数据，通常是一个字节数组。
Permissions: 特征值的权限，定义了客户端可以执行的操作（如读、写等）。

3. Properties

特征值的属性决定了客户端可以对该特征值执行的操作。常见的属性包括：

PROPERTY_READ: 可读。
PROPERTY_WRITE: 可写。
PROPERTY_NOTIFY: 可通知（服务器可以在值改变时通知客户端）。
PROPERTY_INDICATE: 可指示（类似于通知，但需要客户端确认）。
PROPERTY_WRITE_NO_RESPONSE: 可写且不需要响应。

4. Permissions

特征值的权限决定了客户端可以执行的操作。常见的权限包括：

PERMISSION_READ: 允许读取。
PERMISSION_WRITE: 允许写入。
PERMISSION_READ_ENCRYPTED: 允许加密读取。
PERMISSION_WRITE_ENCRYPTED: 允许加密写入。

5. 常用方法

getValue(): 获取特征值的当前值，返回一个字节数组。
setValue(byte[] value): 设置特征值的值。
setValue(String value): 设置特征值的值为字符串。
getProperties(): 获取特征值的属性。
getPermissions(): 获取特征值的权限。
getUuid(): 获取特征值的 UUID。
getDescriptor(UUID uuid): 获取指定 UUID 的描述符。
getDescriptors(): 获取所有描述符。

6. 使用示例

以下是一个简单的示例，展示了如何读取和写入一个特征值：

java

复制

BluetoothGattCharacteristic characteristic = ...; // 获取特征值

// 读取特征值
if ((characteristic.getProperties() & BluetoothGattCharacteristic.PROPERTY_READ) > 0) {
    boolean success = mBluetoothGatt.readCharacteristic(characteristic);
    if (success) {
        // 读取成功，可以在 onCharacteristicRead 回调中获取值
    }
}

// 写入特征值
if ((characteristic.getProperties() & BluetoothGattCharacteristic.PROPERTY_WRITE) > 0) {
    characteristic.setValue("Hello, BLE!");
    boolean success = mBluetoothGatt.writeCharacteristic(characteristic);
    if (success) {
        // 写入成功
    }
}

// 启用通知
if ((characteristic.getProperties() & BluetoothGattCharacteristic.PROPERTY_NOTIFY) > 0) {
    mBluetoothGatt.setCharacteristicNotification(characteristic, true);
    BluetoothGattDescriptor descriptor = characteristic.getDescriptor(UUID.fromString("00002902-0000-1000-8000-00805f9b34fb"));
    descriptor.setValue(BluetoothGattDescriptor.ENABLE_NOTIFICATION_VALUE);
    mBluetoothGatt.writeDescriptor(descriptor);
}

7. 回调处理

在 BluetoothGattCallback 中，你可以处理特征值的读取、写入和通知事件：

java

复制

@Override
public void onCharacteristicRead(BluetoothGatt gatt, BluetoothGattCharacteristic characteristic, int status) {
    if (status == BluetoothGatt.GATT_SUCCESS) {
        byte[] value = characteristic.getValue();
        // 处理读取到的值
    }
}

@Override
public void onCharacteristicWrite(BluetoothGatt gatt, BluetoothGattCharacteristic characteristic, int status) {
    if (status == BluetoothGatt.GATT_SUCCESS) {
        // 写入成功
    }
}

@Override
public void onCharacteristicChanged(BluetoothGatt gatt, BluetoothGattCharacteristic characteristic) {
    byte[] value = characteristic.getValue();
    // 处理通知的值
}