
本文详解如何通过 BLE GATT 协议在 Android Java 应用中分别读取左、右耳耳机及充电仓的实时电量,涵盖权限配置、设备发现、服务发现、多设备连接策略与典型坑点规避。
本文详解如何通过 ble gatt 协议在 android 应用中分别读取左、右耳耳机及充电仓的实时电量,涵盖权限配置、设备发现、服务发现、多设备连接策略与典型坑点规避。
在开发蓝牙耳机电量监控类应用时,许多开发者会误以为 BluetoothDevice.getBatteryLevel() 反射调用能直接返回双耳独立值——但事实是:该 API 仅返回设备抽象层(Device Class)上报的单个聚合电量值(通常为双耳中较低者),且自 Android 12 起已被系统级弃用,稳定性差、精度低、不支持 TWS 分体式设备。
要真正实现左耳、右耳、充电仓三路独立电量精准读取,必须基于 BLE GATT 协议,主动连接并解析各设备的 Battery Service(0000180F-0000-1000-8000-00805F9B34FB)与 Battery Level Characteristic(00002A19-0000-1000-8000-00805F9B34FB)。现代 TWS 耳机(如漫步者 NeoBuds S Pro、小米 Buds 5、魔声 Momentum True Wireless 4)普遍采用双 BLE 设备架构:左耳(MAC_L)、右耳(MAC_R)作为两个独立的 BLE 外设,各自广播并维护独立的电池特征值;充电仓则可能作为第三设备或通过右耳中继上报。
✅ 正确实现路径(Java)
1. 声明必要权限(AndroidManifest.xml)
<uses-permission android:name="android.permission.BLUETOOTH"/> <uses-permission android:name="android.permission.BLUETOOTH_ADMIN"/> <uses-permission android:name="android.permission.BLUETOOTH_CONNECT"/> <uses-permission android:name="android.permission.BLUETOOTH_SCAN"/> <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/> <!-- BLE 扫描必需 --> <uses-permission android:name="android.permission.BATTERY_STATS"/> <!-- 部分 OEM 需要 -->
⚠️ 注意:
BLUETOOTH_CONNECT和BLUETOOTH_SCAN是运行时危险权限,需在 Activity 中动态申请(requestPermissions()),且ACCESS_FINE_LOCATION在 Android 12+ 为 BLE 扫描硬性依赖。
2. 分别连接左右耳设备(关键!)
TWS 耳机的左右耳是两个独立的 BLE 设备,拥有不同 MAC 地址。切勿尝试“用一个 BluetoothDevice 对象读两次”——必须为左耳、右耳分别建立 BluetoothGatt 连接:
// 假设已获知左/右耳 MAC 地址(可通过配对列表或用户手动输入)
BluetoothDevice leftEarbud = bluetoothAdapter.getRemoteDevice("AA:BB:CC:DD:EE:FF");
BluetoothDevice rightEarbud = bluetoothAdapter.getRemoteDevice("11:22:33:44:55:66");
// 分别连接(注意:不能复用同一 GattCallback 实例处理双连接)
BluetoothGatt gattLeft = leftEarbud.connectGatt(context, false, new EarbudGattCallback("LEFT"));
BluetoothGatt gattRight = rightEarbud.connectGatt(context, false, new EarbudGattCallback("RIGHT"));3. 自定义 GATT 回调,支持多设备上下文识别
private static class EarbudGattCallback extends BluetoothGattCallback {
private final String earSide; // "LEFT" or "RIGHT"
EarbudGattCallback(String side) {
this.earSide = side;
}
@Override
public void onConnectionStateChange(BluetoothGatt gatt, int status, int newState) {
if (newState == BluetoothProfile.STATE_CONNECTED && status == BluetoothGatt.GATT_SUCCESS) {
gatt.discoverServices();
}
}
@Override
public void onServicesDiscovered(BluetoothGatt gatt, int status) {
if (status != BluetoothGatt.GATT_SUCCESS) return;
BluetoothGattService batteryService = gatt.getService(
UUID.fromString("0000180f-0000-1000-8000-00805f9b34fb")
);
if (batteryService != null) {
BluetoothGattCharacteristic batteryChar = batteryService.getCharacteristic(
UUID.fromString("00002a19-0000-1000-8000-00805f9b34fb")
);
if (batteryChar != null) {
gatt.readCharacteristic(batteryChar);
}
}
}
@Override
public void onCharacteristicRead(BluetoothGatt gatt, BluetoothGattCharacteristic characteristic, int status) {
if (status == BluetoothGatt.GATT_SUCCESS) {
int level = characteristic.getIntValue(BluetoothGattCharacteristic.FORMAT_UINT8, 0);
Log.d("Battery", earSide + "_EAR: " + level + "%");
// ▶️ 此处更新 UI:例如更新 TextView.setText("左耳:" + level + "%")
}
gatt.close(); // 读完即关,避免资源泄漏
}
}4. 充电仓电量的特殊处理
多数 TWS 充电仓不直接广播 BLE 信号,而是由耳机(通常是右耳)通过 Vendor-Specific Service(厂商自定义服务)中继上报。例如:
- 漫步者 EDIFIER TWS1 Air:通过
0000FE10-0000-1000-8000-00805F9B34FB服务中的0000FE11-...特征值传输仓电量; - 小米 Buds 5:使用
0000FFF0-0000-1000-8000-00805F9B34FB下的0000FFF1-...。
? 解决方案:查阅对应耳机型号的公开协议文档(如 Edifier Connect SDK 或小米 Open SDK),或使用 nRF Connect 工具抓包分析其私有服务结构,再在 onServicesDiscovered() 中按 UUID 定位并读取。
⚠️ 关键注意事项
-
不要依赖反射
getBatteryLevel():该方法非官方 API,不同 OEM 行为不一致(华为/小米可能返回 0,三星可能崩溃),且无法区分左右耳。 -
连接顺序无关紧要,但必须并发连接:左右耳可同时
connectGatt(),系统底层会自动调度;若串行连接(先连左再连右),可能因超时导致第二连接失败。 -
电量单位是百分比(0–100):
FORMAT_UINT8读出的字节值即为整数百分比,无需换算。 -
固件兼容性决定是否支持:若耳机固件未启用 Battery Service(如部分老款 W200BT),GATT 读取将返回
GATT_FAILURE;此时需引导用户升级固件(通过官方 App)。 -
后台限制:Android 8.0+ 对后台 BLE 扫描与连接有严格限制,电量轮询类功能建议结合前台服务(
startForegroundService())+ Notification 保活。
✅ 总结
获取双耳独立电量不是“调一个 API”,而是一套完整的 BLE 设备管理流程:识别双设备 → 并发建立 GATT 连接 → 分别发现并读取 Battery Service → 解析特征值 → 合理释放资源。掌握此模式后,你不仅能支持漫步者、小米、魔声等主流品牌,还可快速适配 AirPods(需配合 Fast Pair 协议解析)或任何符合 Bluetooth SIG Battery Service 规范的 TWS 设备。实际开发中,建议封装为 TwsBatteryManager 类,统一管理连接生命周期与电量回调,大幅提升可维护性。


















