# PartyBox for Home Assistant：还原 JBL 音箱的蓝牙控制协议

> PartyBox for Home Assistant 通过蓝牙客户端和 MQTT 实体控制 JBL PartyBox 音箱。项目依据 JBL PartyBox Android 应用 3.14.20 及通信观察还原协议，记录了 GATT 命令帧和经典蓝牙上的 ATT 连接方式。

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

## 使用条件与局限

- **前提条件：**需要 Home Assistant OS 或 Supervised，以及处于音箱通信范围内的蓝牙适配器。
- **测试证据：**作者报告仅在一款 PartyBox 音箱和一套 Home Assistant OS 环境中测试；其他型号可能存在差异。
- **许可：**许可证为 MIT。

## 一手来源

1. <https://github.com/BaggaBruh/jbl-partybox-ha/blob/1591ee548e119d877a051612372090210dabb657/README.md>
2. <https://github.com/BaggaBruh/jbl-partybox-ha/blob/1591ee548e119d877a051612372090210dabb657/PROTOCOL.md>

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

- [carlinkit-cxx：Carlinkit Auto Box USB 消息的 Linux 接收端](https://awesomerea.org/zh/resources/carlinkit-cxx-case/index.md) · 案例
- [mchose-linux：MCHOSE HID 设置协议与 Linux 客户端](https://awesomerea.org/zh/resources/mchose-hid-linux-case/index.md) · 案例
- [K1C CFS without official Creality firmware：CFS 协议客户端与 Klipper 集成](https://awesomerea.org/zh/resources/k1c-cfs-klipper-case/index.md) · 案例
- [Open TechEd：重建 NanoDrop 1000 的 USB 控制协议](https://awesomerea.org/zh/resources/open-teched-nanodrop-case/index.md) · 案例
- [douze：SSL 12 USB 控制协议与 Linux 客户端](https://awesomerea.org/zh/resources/douze-case/index.md) · 案例
- [Osmotic：基于 DJI Osmo 相机协议的 Mac 客户端](https://awesomerea.org/zh/resources/osmotic-case/index.md) · 案例

## 关于此条目

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