Jmgo-Home-Assistant

项目简介

Jmgo-Home-Assistant 是一个 Home Assistant 自定义集成（custom component），用于把 坚果 / JMGO 投影仪 接入智能家居系统。作者使用的是坚果 N3 Ultra，实测可用。

代码基础来自 manymuch 的 Xgimi-4-Home-Assistant（极米投影仪集成）。因为作者用的是坚果而不是极米，所以拿过来改造后自用。

工作原理

• 遥控信号协议参考 JMGO-projector-controller
• 通过 局域网 IP + 端口 直连投影仪的遥控服务发送指令
• 作者机器上的端口为 9005，其他型号/固件可能不同，需要自行确认

安装与配置

1. 将集成目录放入 Home Assistant 的 custom_components/ 下
2. 重启 Home Assistant
3. 在「设置 → 设备与服务 → 添加集成」中搜索并添加
4. 填写投影仪的 IP 地址 和 端口（作者为 9005）

适用场景

• 想让投影仪跟随 Home Assistant 自动化（如「看电影」场景一键开机、切换输入源）
• 用语音助手 / 手机面板替代实体遥控器
• 与灯光、窗帘、音箱做联动

使用体验

实测坚果 N3 Ultra 可用，走局域网直连，不依赖云端，响应速度取决于局域网质量。缺点是 UI 和文档还比较简陋（作者自己在 README 里也吐槽「丑是丑了点，文档又看不懂」），配置项少，出错时排查信息有限。

二次开发建议

• 项目体量很小（约 19KB，JavaScript），适合作为学习 Home Assistant 自定义集成的入门样本
• 可借鉴：config_flow 配置流程、实体（Entity）定义、局域网协议封装
• 值得改进：补充型号/端口对照表、增加异常重试与连接状态反馈、完善 UI 与文档、抽出可复用的遥控协议层
• 若投影仪不是坚果，可回到上游极米集成，或参考 JMGO-projector-controller 的原始协议实现

注意

• 项目更新不频繁（最近推送 2026-01），star 数较少，属于个人自用改造项目，生产环境使用需自行验证
• 端口 9005 并非通用值，务必先在本地确认设备实际监听端口