Android开发 - BluetoothClient 自定义类处理蓝牙全过程连接与数据解析

BluetoothClient 是什么

• BluetoothClient 自定义类是开发者自定义封装的类，不存在 Java 中。它通常用于蓝牙应用中，特别是与蓝牙设备进行通信的客户端管理。通常用于在 Android 应用中进行蓝牙通信。它帮助你处理与蓝牙连接、设备发现、数据传输等等任务

BluetoothClient 的使用环境

• 连接到蓝牙设备：通过 BluetoothClient，你可以连接到指定的蓝牙设备。它通常提供了连接设备的方法，并允许你配置连接的选项（如超时时间、自动重连等）

• 断开连接：当你不再需要与蓝牙设备通信时，BluetoothClient 允许你断开连接并释放相关资源

• 数据传输：BluetoothClient 支持从蓝牙设备读取数据和向设备发送数据。这通常涉及到与蓝牙设备的特征和服务进行交互

• 处理连接状态：它通常提供回调方法或监听器，以便你可以处理连接的成功、失败、断开等状态

代码示例解析

• 假设我们使用一个通用的蓝牙库，以下是 BluetoothClient 类的一个创建示例，用于连接蓝牙设备和进行数据传输

  • 定义 BluetoothClient 类

    public class BluetoothClient {
    
        private BluetoothGatt bluetoothGatt; // 用于管理和蓝牙设备的连接及数据传输的实例
    
        // 连接到蓝牙设备
        // device: 要连接的蓝牙设备
        // context: 当前的上下文环境，一般是 Activity 或 Application
        public void connect(BluetoothDevice device, BluetoothGattCallback callback) {
            // false: 不使用自动重连机制
            // callback: 处理连接状态变化和数据交互的回调
            bluetoothGatt = device.connectGatt(context, false, callback);
        }
    
        // 断开连接
        public void disconnect() {
            // 检查 BluetoothGatt 实例是否存在
            if (bluetoothGatt != null) {
                // 断开与设备的连接
                bluetoothGatt.disconnect();
                // 关闭 BluetoothGatt 实例，释放资源
                bluetoothGatt.close();
            }
        }
    
        // 发送数据
        // 向蓝牙设备的特征写入数据。characteristic 是要写入的特征，data 是要发送的数据
        public void writeCharacteristic(BluetoothGattCharacteristic characteristic, byte[] data) {
            // 设置要发送的数据到特征中
            characteristic.setValue(data);
            // 写入数据到特征
            bluetoothGatt.writeCharacteristic(characteristic);
        }
    
        // 读取数据
        // 从蓝牙设备的特征读取数据
        public void readCharacteristic(BluetoothGattCharacteristic characteristic) {
            // 请求读取特征的值
            bluetoothGatt.readCharacteristic(characteristic);
        }
    }
    

  • 使用 BluetoothClient 连接设备

    public class MainActivity extends AppCompatActivity {
    
        private BluetoothClient bluetoothClient;  // 蓝牙客户端实例
        private BluetoothGattCallback gattCallback;  // 处理连接状态和数据传输的回调
    
        @Override
        protected void onCreate(Bundle savedInstanceState) {
            super.onCreate(savedInstanceState);
            setContentView(R.layout.activity_main);
    
            // 初始化蓝牙客户端
            bluetoothClient = new BluetoothClient();
    
            // 创建处理蓝牙连接状态和数据传输的回调
            // 连接到指定的蓝牙设备，并使用 BluetoothGattCallback 回调处理连接状态和数据传输
            gattCallback = new BluetoothGattCallback() {
                // 连接状态变化时调用
                @Override
                public void onConnectionStateChange(BluetoothGatt gatt, int status, int newState) {
                    // 如果连接成功
                    if (newState == BluetoothProfile.STATE_CONNECTED) {
                        Log.d("Bluetooth", "Connected to GATT server.");
                        // 发现设备提供的服务
                        gatt.discoverServices();
                    // 如果连接断开
                    } else if (newState == BluetoothProfile.STATE_DISCONNECTED) {
                        Log.d("Bluetooth", "Disconnected from GATT server.");
                    }
                }
    
                // 服务发现完成时调用
                @Override
                public void onServicesDiscovered(BluetoothGatt gatt, int status) {
                    // 处理服务发现逻辑，例如查找特定服务和特征
                }
    
                // 读取特征值完成时调用
                @Override
                public void onCharacteristicRead(BluetoothGatt gatt, BluetoothGattCharacteristic characteristic, int status) {
                    // 处理数据读取
                }
                
    			// 写入特征值完成时调用
                @Override
                public void onCharacteristicWrite(BluetoothGatt gatt, BluetoothGattCharacteristic characteristic, int status) {
                    // 处理数据写入
                }
            };
    
            // 获取 BluetoothDevice 实例（设备地址需替换为实际设备的地址）
            BluetoothDevice device = ... // 获取蓝牙设备
                // 连接到蓝牙设备
            bluetoothClient.connect(device, gattCallback);
        }
    
        @Override
        protected void onDestroy() {
            super.onDestroy();
            // 断开与蓝牙设备的连接，并关闭 BluetoothGatt 实例，避免内存泄漏
            bluetoothClient.disconnect(); // 断开连接
        }
    }
    

总结

• BluetoothClient 类在蓝牙应用开发中扮演了重要角色，它简化了蓝牙连接的管理和数据传输的操作。通过配置连接参数、处理连接状态、进行数据传输，你可以使用 BluetoothClient 来实现与蓝牙设备的交互。具体实现可能会因使用的库或框架而异，但核心功能通常包括连接、断开连接、数据读写等