House Control + Home Assistant:一次接入,让上千款智能家居设备进入你的3D家
House Control + Home Assistant:一次接入,让上千款智能家居设备进入你的3D家
House Control 是一款开源智能家居控制工具,把你的家变成一个实时 3D 模型,常驻 Mac 菜单栏、MacBook 灵动岛和 iPhone 上。而 Home Assistant 是它最划算的入口:你不需要为每个品牌单独找 App,只要连接一次 Home Assistant,Zigbee、Matter、小米、Aqara、Google Nest、Daikin、Tuya 等上千款设备就会一起出现在你的 3D 家里,点哪控哪。🏠
为什么 Home Assistant 是智能家居的"万能入口"
如果你家的设备品牌比较杂,大概率已经折腾过各种 App:一个开灯、一个调空调、一个看温湿度。Home Assistant 的思路相反——它跑在你自己网络里的服务器上,把几乎所有品牌"收编"到自己下面:
- 无线协议设备:Zigbee / Z-Wave 网关、Matter 设备
- 主流生态:小米、Aqara、IKEA、Sonoff、Google Nest、SmartThings
- 家电:Daikin、Mitsubishi、Tuya 等
House Control 订阅的是 Home Assistant 的事件流,所以从墙上的开关或自动化改的状态,一秒钟内就会同步回 3D 面板,不会出现"手机说开着、面板说关着"的错位。
最快接入方法:两步连上 Home Assistant
整个过程不需要开发账号,全程在局域网内完成:
- 在 Home Assistant 里创建令牌:打开个人头像 → Security → Long-lived access tokens → Create token,命名为 "House Control" 并复制。
- 在 House Control 里连接:右键菜单栏图标 → Edit Home… → Connections → Home Assistant。Home Assistant 服务器会被自动发现,点 Use(或手填
http://homeassistant.local:8123),粘贴令牌,点 Connect 即可。
详细步骤见官方文档 docs/connections.md。
3D 家怎么"认识"你的设备
连接成功后,Home Assistant 里的实体类型会自动映射成 House Control 里的对象,设备所属的 Area 会显示在房间名旁边:
| Home Assistant | 在 House Control 中变成 |
|---|---|
light.* |
一盏灯:开关、亮度、色温、颜色(按设备能力自动识别) |
switch.* |
插座上的灯:开关 |
climate.* |
空调:开关、目标温度、模式、风速、摆风、eco / sleep 预设 |
sensor.*(device_class: temperature) |
空调房间里的温度计 |
这个映射逻辑在 HomeAssistantService.swift 中实现。之后在 3D 平面图上选中一盏灯或一台空调,在 Real device 下拉里挑到真实设备,点 Save & apply——面板就接管了真家伙:亮度可以拖、温度可以拧、开着的空调还会在 3D 场景里"吹出"可见的气流。
不止 Home Assistant:四个平台自由混搭
同一个家里,Hue 的灯、Home Assistant 的空调和 Smart Life 的插座完全可以并存:
- Philips Hue:桥接器自动发现,按一下桥顶按钮完成配对,全程不经过互联网;
- Smart Life / Tuya:用 Smart Life App 扫个二维码登录,无需开发者账号;
- Apple Home:iPhone 端授权 HomeKit 访问后,设备列表自动送到 Mac。
一个实用技巧:Tuya 设备想进 Apple Home?先把它加进 Home Assistant 的 Tuya 集成,再加一个 HomeKit Bridge 集成——同一套登录,两条路都通了。
把 3D 家放进制动岛和 iPhone
接入完成后,控制入口有三处,都是同一个 3D 模型:
- 菜单栏面板:点开即现,点哪控哪;
- 灵动岛:指针停在 MacBook 的"刘海"上,房子就从刘海里探出来——场景、空调、灯光一目了然,指针移开自动收起,不抢你正在用应用的键盘焦点;
- iPhone 应用:3D 模型、房间、设备链接全在手机上完成,不需要 Mac,配对后与 Mac 保持同步。
不响应?打开设备日志查原因
调试不用看源码:右键菜单栏图标 → Reveal Device Log,每一条发往真实设备的指令和云端/服务器的应答都记录在 events.log 里(不含令牌)。没有硬件想先体验?tools/lab/ 自带一套"假装"的 Home Assistant、Hue Bridge 和 HomeKit 桥接器,跑在本地、走真实协议,随便点。
小结
House Control + Home Assistant 的组合,本质上是把"接入"这件事做了一次性投资:一次连接,全品牌进家。你的家从此是菜单栏里的 3D 模型,是刘海里探出的小房子,是 iPhone 上一键可点的模型——而密钥和令牌只存在你自己的设备上,没有任何第三方服务器。🎯
- 楼层平面图格式:docs/floor-plan.md
- 设备接入指南:docs/connections.md
- Home Assistant 实体映射源码:core/Sources/HouseCore/HomeAssistantService.swift
- 无硬件实验环境:tools/lab/README.md



