sirix12/SoundPeats-Mini-Pro-Hs-Controller

# Soundpeats Mini Pro HS 控制器 一款用于连接和控制 Soundpeats Mini Pro HS 耳机的开源 Android 应用程序。该应用使用 Kotlin 和 Jetpack Compose 构建，通过蓝牙 SPP（Serial Port Profile）直接进行通信。 ## ✨ 功能 * **自动连接：** 启动时直接轮询并验证与 Soundpeats 耳机的蓝牙连接，跳过手动设备选择过程。 * **实时状态同步：** 连接后立即查询并同步硬件的活动状态（ANC 模式、Game mode、电池电量），确保 UI 始终准确。 * **高级参数均衡器 (PEQ)：** * 完整的 7 段配置，具有精确的 16 位有符号增益计算。 * 每个频段（0x71-0x77）直接传输 17 字节的命令数据包。 * 自动处理序列执行、主 EQ 开关和提交命令，以防止内存缓冲区溢出或耳机重启。 * **设备控制开关：** 完整的读写功能包括： * ANC（Active Noise Cancellation）模式：ANC On、ANC Off、Transparency * Game Mode（低延迟） * Touch Controls（启用/禁用） * **现代 UI：** 完全使用 Jetpack Compose 构建，采用受 Material 3 启发的时尚设计。 ## 💡 为什么做这个项目？ 这个应用程序源于对官方 Soundpeats 应用程序的失望。大多数用户只想调整他们的硬件设置，而不想被繁琐的条件所限制。 * **无需账户：** 官方应用程序需要创建账户和云端登录才能切换基本模式——对于本地硬件控制来说，这种要求毫无意义。 * **隐私至上：** 为了一副耳机而不断进行数据同步是对用户隐私的不必要侵犯。本应用不需要任何账户，不需要任何互联网访问，也不收集任何数据。 * **直接控制：** 它直接与您的设备通信，这正是蓝牙硬件本该有的使用方式。 ## 🛠️ 技术细节 * **语言：** Kotlin * **UI 框架：** Jetpack Compose (Material 3) * **最低 SDK：** 26 (Android 8.0) * **目标 SDK：** 34 (Android 14) * **通信协议：** 蓝牙 RFCOMM / SPP（Hex 数据包传输） * **目标芯片组：** WuQi WQ7033（存在于 Soundpeats Mini Pro HS 中） ## 🚀 快速开始 ### 前置条件 * Android Studio（推荐最新版本） * 运行 Android 8.0+ 的 Android 设备 * Soundpeats Mini Pro HS 耳机（已与您的设备配对） ### 构建项目 1. 克隆代码库： git clone https://github.com/yourusername/soundpeats-controller.git 2. 在 Android Studio 中打开项目。 3. 同步 Gradle 文件。 4. 在您的物理 Android 设备上构建并运行该应用程序。（蓝牙功能无法在模拟器上测试）。 ### 权限 该应用程序需要以下权限才能发现、连接您的耳机并进行通信： * `BLUETOOTH` 和 `BLUETOOTH_ADMIN`（旧版） * `BLUETOOTH_SCAN`、`BLUETOOTH_ADVERTISE`、`BLUETOOTH_CONNECT`（Android 12+） ## ⚠️ 免责声明 这是一个非官方的开源应用程序，不隶属于 Soundpeats，也不受其维护、授权、认可或赞助。它使用专用于 WuQi WQ7033 芯片组的逆向工程蓝牙命令。使用风险由您自行承担。 ## 🤝 贡献 欢迎贡献代码、提出问题和功能请求！如果您有不同型号的 Soundpeats（例如 Air3、Engine4），并且想要帮助扩展兼容性，请随时提交 pull request 或开启 issue。

标签：Android, DSL, Jetpack Compose, Kotlin, Python, 无后门, 物联网, 蓝牙通信, 设备控制, 逆向工具