Android 蓝牙 Android BluetoothGatt

### Android BluetoothGatt 使用方法 #### 1. 初始化蓝牙适配器并检查 BLE 支持 为了使用 `BluetoothGatt` 功能，首先需要初始化蓝牙适配器，并确认设备是否支持 BLE 功能。这一步骤通常涉及读取系统的蓝牙状态以及验证必要的权限。 在应用程序的清单文件 (`AndroidManifest.xml`) 中需声明以下权限和硬件特性[^4]: ```xml <uses-permission android:name="android.permission.BLUETOOTH"/> <uses-permission android:name="android.permission.BLUETOOTH_ADMIN"/> <uses-feature android:name="android.hardware.bluetooth_le" android:required="true"/> ``` 如果目标 API 级别为 23 或更高，则还需要动态请求位置权限，因为从 Android 6.0 开始，扫描附近设备需要访问粗略或精确的位置数据。 #### 2. 连接到远程设备 通过调用 `connectToDevice` 方法可以建立与远程设备的连接。此操作返回一个 `BluetoothGatt` 实例，该实例用于管理后续的所有 GATT 客户端交互。以下是典型的连接代码片段： ```java bluetoothGatt = device.connectGatt( context, false, // 不启用自动重连 gattCallback, // 自定义回调对象 BluetoothDevice.TRANSPORT_LE); // 指定低功耗传输模式 ``` 上述代码中的参数解释已在引用中提供[^3]。 #### 3. 处理 GATT 回调事件 当成功连接到远程设备后，所有的通信都依赖于 `BluetoothGattCallback` 类型的对象。开发者可以在其中监听各种事件，例如服务发现完成、特征值更新等。 下面是一个简单的回调实现示例： ```java private final BluetoothGattCallback gattCallback = new BluetoothGattCallback() { @Override public void onConnectionStateChange(BluetoothGatt gatt, int status, int newState) { super.onConnectionStateChange(gatt, status, newState); if (newState == BluetoothProfile.STATE_CONNECTED && status == BluetoothGatt.GATT_SUCCESS){ Log.d(TAG,"Connected to the remote device."); gatt.discoverServices(); // 发现服务 }else{ Log.e(TAG,"Disconnected from the remote device or connection failed with error code:"+status); } } @Override public void onServicesDiscovered(BluetoothGatt gatt, int status) { super.onServicesDiscovered(gatt, status); if(status==BluetoothGatt.GATT_SUCCESS){ List<BluetoothGattService> services=gatt.getServices(); for(BluetoothGattService service :services){ Log.i(TAG,"Found Service UUID:" +service.getUuid().toString()); } } } }; ``` #### 常见问题分析 ##### A. 设备无法找到 BLE 特征值 可能的原因包括未正确执行服务发现流程或者目标设备的服务配置不符合预期。确保在接收到 `onServicesDiscovered` 回调后再尝试获取任何特定的 `BluetoothGattCharacteristic` 对象[^2]。 ##### B. 数据写入失败 某些情况下即使发送命令给外设也可能得不到响应。这是由于没有设置正确的属性标志位所致。比如要向某个特征值写入数据之前应该先判断其是否允许写操作(`PROPERTY_WRITE_NO_RESPONSE` 或者 `PROPERTY_WRITE`)。 ##### C. 断开连接异常频繁 断链现象可能是由多种因素引起的，如信号强度弱、干扰源存在或是程序逻辑错误造成的资源泄漏等问题。建议增加心跳包机制保持链接稳定性；同时注意释放不再使用的 GATT 资源以减少内存占用率。 --- ###