讲师中心 微信公众号

工具推荐

视频效率加速
updream

一键生成高质量推广成片

SoundView
SoundView

字幕擦除翻译、配音口型同步

Seko
Seko

AI短剧一键生成成片

剧云
剧云

中文短剧剧本制作平台

如何在 Android 应用中精准获取左右耳真无线耳机(TWS)的独立电量

星浩君_2021

星浩君_2021

发布时间:2026-11-17 10:06:10

|

975人浏览过

|

来源于php中文网

原创

如何在 Android 应用中精准获取左右耳真无线耳机(TWS)的独立电量

本文详解如何通过 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 连接:

Android Control
Android Control

通过命令行工具(uiautomator、screencap、input、am)控制安卓设备。优先尝试非 root 执行,失败后自动回退至 root...

下载
// 假设已获知左/右耳 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 类,统一管理连接生命周期与电量回调,大幅提升可维护性。

热门AI工具

更多
Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

函子Zion

一款支持AI搭建、可视化编辑和多端发布的全栈无代码开发平台。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

相关专题

更多
android开发三大框架
android开发三大框架

android开发三大框架是XUtil框架、volley框架、ImageLoader框架。本专题为大家提供android开发三大框架相关的各种文章、以及下载和课程。

942

2023.08.14

android是什么系统
android是什么系统

Android是一种功能强大、灵活可定制、应用丰富、多任务处理能力强、兼容性好、网络连接能力强的操作系统。本专题为大家提供android相关的文章、下载、课程内容,供大家免费下载体验。

2847

2023.08.22

android权限限制怎么解开
android权限限制怎么解开

android权限限制可以使用Root权限、第三方权限管理应用程序、ADB命令和Xposed框架解开。详细介绍:1、Root权限,通过获取Root权限,用户可以解锁所有权限,并对系统进行自定义和修改;2、第三方权限管理应用程序,用户可以轻松地控制和管理应用程序的权限;3、ADB命令,用户可以在设备上执行各种操作,包括解锁权限;4、Xposed框架,用户可以在不修改系统文件的情况下修改应用程序的行为和权限。

5797

2023.09.19

android重启应用的方法有哪些
android重启应用的方法有哪些

android重启应用有通过Intent、PendingIntent、系统服务、Runtime等方法。本专题为大家提供Android相关的文章、下载、课程内容,供大家免费下载体验。

765

2023.10.18

Android语音播放功能实现方法
Android语音播放功能实现方法

实现方法有使用MediaPlayer实现、使用SoundPool实现两种。可以根据具体的需求选择适合的方法进行实现。想了解更多语音播放的相关内容,可以阅读本专题下面的文章。

984

2024.03.01

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

140

2026.11.12

Go-Zero安装与goctl环境配置教程
Go-Zero安装与goctl环境配置教程

本专题围绕Go-Zero的安装与工具链配置展开,讲清Go版本要求、goctl安装方式、代理镜像、protoc依赖与环境变量设置,说明多版本共存、升级回退与CI流水线安装的做法,并整理安装阶段的常见报错与验证步骤。

100

2026.11.12

Go-Zero零基础入门教程
Go-Zero零基础入门教程

本专题整理Go-Zero的入门知识,从框架定位、环境准备到跑通第一个API服务,讲清目录分层、配置加载、日志与中间件的基本用法,并对比Gin、Kratos的差异,帮助Go开发者建立整体认知,判断它是否适合当前项目。

80

2026.11.12

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

160

2026.11.06

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Excel 教程
Excel 教程

共162课时 | 45.8万人学习

Java 教程
Java 教程

共578课时 | 199.9万人学习

Uniapp从零开始实现新闻资讯应用
Uniapp从零开始实现新闻资讯应用

共64课时 | 9.8万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn