# BudsCtl：还原 SoundPEATS 耳机控制指令

> BudsCtl 还原 SoundPEATS Air4 Pro 的 GAIA V2 控制指令，在 macOS 菜单栏中切换降噪模式并读取左右耳电量。文档说明 BLE 服务、命令帧及响应行为；另有依据外部协议资料实现的 Samsung RFCOMM 控制代码。

- 类型：案例
- 目标：协议
- 类别：独立重建案例
- 关联：独立重建项目
- 来源复核于：2026-11-08
- 收录于：2026-11-08
- 原始资源：<https://github.com/hammad-iftikhar/budsctl>
- 一手来源：<https://github.com/hammad-iftikhar/budsctl/blob/48d28a17c7ec68d03e9cc5754e57c65ab508242e/README.md>
- 目录页面：<https://awesomerea.org/zh/resources/budsctl-case/>
- 记录 JSON：<https://awesomerea.org/resources/budsctl-case/record.json>
- 英文版：[English](https://awesomerea.org/resources/budsctl-case/index.md)

## 使用条件与局限

- **前提条件：**需要运行 macOS 26 或更新版本的 Apple Silicon Mac、已配对耳机和蓝牙权限。
- **测试证据：**SoundPEATS Air4 Pro 是经实物确认的型号；Samsung 实现有合成字节单元测试，尚无实物运行记录。
- **许可：**采用 MIT 许可证。

## 一手来源

1. <https://github.com/hammad-iftikhar/budsctl/blob/48d28a17c7ec68d03e9cc5754e57c65ab508242e/README.md>
2. <https://github.com/hammad-iftikhar/budsctl/blob/48d28a17c7ec68d03e9cc5754e57c65ab508242e/LICENSE>

## 同分区更多条目：协议

- [Babyface Pro FS：在 Linux 上还原专有 USB 模式](https://awesomerea.org/zh/resources/babyface-pro-linux-case/index.md) · 案例
- [wolfmix-automation：重建 W1 项目文件与 USB 控制协议](https://awesomerea.org/zh/resources/wolfmix-automation-case/index.md) · 案例
- [Mammotion RTK 3：还原割草机的 LoRa 差分链路](https://awesomerea.org/zh/resources/mammotion-rtk-lora-case/index.md) · 案例
- [DingTalk A1 Local Toolkit：重建 BLE 录音访问流程](https://awesomerea.org/zh/resources/dingtalk-a1-local-toolkit-case/index.md) · 案例
- [Remote for Apple TV：在 Android 上重建 Companion Link 控制](https://awesomerea.org/zh/resources/apple-tv-remote-android-case/index.md) · 案例
- [panelbeater：还原 ScanSnap iX1500 面板控制](https://awesomerea.org/zh/resources/panelbeater-case/index.md) · 案例

## 关于此条目

说明已依据一手来源复核。
原创说明采用 MIT 许可；外部项目、论文与素材保留各自的权利和许可。