librepods官方版

librepods 是一款面向安卓设备的 AirPods 辅助工具，用来补上 AirPods 连安卓后被砍掉的那些功能。原版连接后只能看个大概电量，装完它就能分别看到左耳、右耳和充电盒的精确剩余电量。入耳检测也一并支持：戴上耳机自动接着播，摘掉一只暂停，两只都摘了声音切回手机外放。

项目性质与平台覆盖

· 纯开源 FOSS 项目，没有广告、内购或付费解锁。

· 把 AirPods 的高级功能在安卓端基本还原出来，接近 iPhone 上的完整体验。

· 安卓和 Linux 都能用，手机、电脑等设备都有覆盖。

功能支持范围

· 主动降噪、自适应模式、通透模式可以直接切换，安卓通知栏里就能操作。

· 入耳自动播放、摘耳机暂停这类原生逻辑不用手动干预。

· 左右耳和充电盒的电量实时显示。

· 支持 AirPods 原生的头部手势和触控手势，触发动作可以自己改。

· 接听/挂断电话、播放/暂停、切歌这些蓝牙耳机常规操作都能用。

· 与苹果生态衔接，AirPods 在安卓/Linux 设备和苹果设备之间可以自动切换，不用重新配对。

· 提供听觉辅助相关设置，能按个人需要调整音效。

· 各种功能的触发方式可以在软件里自定义，按自己的习惯来配。

快速上手方法

1. 先把 AirPods 通过蓝牙连到安卓手机。

2. 安装并打开 LibrePods，允许蓝牙权限。

3. App 会自动识别耳机，显示电量和状态。

4. 在主页直接点降噪、通透或自适应切换。

5. 打开「入耳检测」「对话感知」「头部手势」。

6. 添加桌面组件，控制起来更方便。

初始配置与权限流程

1. 打开应用后，系统会提示授予蓝牙、通知、电话和显示权限，点「Ask for regular permissions」申请必要权限继续使用。

2. 进入设置界面后，提示需要 Root 权限才能挂钩蓝牙库，点「Check Root Access」验证设备是否已获取 Root。

3. 如果已经手动装过蓝牙补丁模块，可以选「Skip Setup」跳过常规配置，适合自定义过系统环境的情况。

4. 连接 AirPods 前，主界面会提示未连接设备，点「Troubleshoot Connection」进入故障排查页做诊断和修复。

5. 在故障排查页点「Collect Logs」开始收集日志，用来分析连接问题，当前暂无保存的日志记录。

高级设置与日志处理

1. 点「Open Xposed Settings」检查 Xposed 模块配置，确认其已启用并允许应用修改系统行为。

2. 打开 AirPods 盒并连接耳机，系统自动采集连接日志，完成后可手动停止，日志文件保存到本地供后续分析。

3. 进入定制设置，可开启小部件电池显示、会话感知音量调节，并控制通话或媒体播放时的自动连接行为。

4. 高级选项里可设置身份解析密钥（IRK）和加密密钥（ENC_KEY），用于解密蓝牙广告数据，提升兼容性。

5. 点「Reset Hook Offset」会重置挂钩偏移，需要重新走一遍设置流程，适合修复因偏移错误导致的功能异常。