标题：鸿蒙 onCharacteristicChanged 实现指南
引言
在鸿蒙开发中，onCharacteristicChanged 是一个重要的函数，它可以用于接收来自设备的特征值变化通知。对于刚入行的开发者来说，理解和实现这个函数可能会有一些困惑。本文将详细介绍如何实现鸿蒙 onCharacteristicChanged 函数，并提供步骤和代码示例帮助你快速上手。
整体流程
为了更好地理解实现 onCharacteristicChanged 函数的过程，我们可以用一个表格展示整个流程的步骤。
| 步骤 | 描述 |
|---|---|
| 步骤一 | 初始化蓝牙适配器 |
| 步骤二 | 连接目标设备 |
| 步骤三 | 获取设备的特征服务 |
| 步骤四 | 获取需要监听的特征值 |
| 步骤五 | 注册特征值变化通知 |
| 步骤六 | 实现 onCharacteristicChanged 函数 |
下面我们逐步介绍每个步骤需要做的事情以及相应的代码示例。
步骤一：初始化蓝牙适配器
在实现 onCharacteristicChanged 函数之前，首先需要初始化蓝牙适配器。初始化蓝牙适配器的代码如下：
BluetoothManager bluetoothManager = (BluetoothManager) getSystemService(Context.BLUETOOTH_SERVICE);
BluetoothAdapter bluetoothAdapter = bluetoothManager.getAdapter();
这段代码获取了系统的蓝牙适配器。
步骤二：连接目标设备
使用蓝牙适配器连接目标设备的代码如下：
BluetoothDevice device = bluetoothAdapter.getRemoteDevice(deviceAddress);
BluetoothGatt gatt = device.connectGatt(this, false, gattCallback);
其中，deviceAddress 是目标设备的 MAC 地址，gattCallback 是一个实现了 BluetoothGattCallback 接口的对象，用于处理蓝牙连接状态和数据通信。
步骤三：获取设备的特征服务
要监听设备的特征值变化，首先需要获取设备的特征服务。代码如下：
BluetoothGattService service = gatt.getService(serviceUuid);
其中，serviceUuid 是特征服务的 UUID。
步骤四：获取需要监听的特征值
在获取设备的特征服务之后，需要找到需要监听的特征值。代码如下：
BluetoothGattCharacteristic characteristic = service.getCharacteristic(characteristicUuid);
其中，characteristicUuid 是需要监听的特征值的 UUID。
步骤五：注册特征值变化通知
获取到需要监听的特征值之后，需要注册特征值变化的通知。注册通知的代码如下：
gatt.setCharacteristicNotification(characteristic, true);
BluetoothGattDescriptor descriptor = characteristic.getDescriptor(descriptorUuid);
descriptor.setValue(BluetoothGattDescriptor.ENABLE_NOTIFICATION_VALUE);
gatt.writeDescriptor(descriptor);
其中，descriptorUuid 是特征值变化通知的描述符 UUID。
步骤六：实现 onCharacteristicChanged 函数
最后一步是实现 onCharacteristicChanged 函数，用于接收特征值变化的通知。代码如下：
@Override
public void onCharacteristicChanged(BluetoothGatt gatt, BluetoothGattCharacteristic characteristic) {
byte[] value = characteristic.getValue();
// 处理接收到的特征值变化
}
在这个函数中，我们可以通过 characteristic.getValue() 获取到特征值的字节数组，并进行相应的处理。
序列图
为了更好地可视化整个过程，我们可以使用序列图来展示整个实现过程。
sequenceDiagram
participant 开发者
participant 设备
开发者->>设备: 初始化蓝牙适配器
开发者->>设备: 连接目标设备
设备->>开发者: 连接成功
开发者->>设备: 获取特征服务
设备->>开发者: 返回特征服务
开发者->>设备: 获取特征值
设备->>开发者
