Appearance
产品介绍
HA Bridge 是一套独立部署的家庭中控仪表盘。通过可视化编辑器，把 Home Assistant 中的设备、状态和常用操作组织成自己的界面：可以自由 DIY 二维面板，也可以在实时 3D 户型中查看空间、聚焦设备并进行控制。
Home Assistant 负责设备接入、实体管理与自动化；HA Bridge 负责中控界面的布局、展示和交互。仪表盘、户型和素材保存在自己部署的 HA Bridge 中。
按自己的习惯 DIY
从空白仪表盘开始，或使用「栖光」完整 UI 方案作为起点。替换为自己的实体，再调整布局、配色和内容，逐步做出适合家人的总览页、房间页与设备页。
- 自由组合控件：设备按钮、图片、天气、时间、摄像头、扫地机地图与数据图表等，可以拖拽、调整大小并组合排布。
- 设计操作方式：为控件配置点按、双击、长按等动作，把灯光、空调与窗帘集中到自定义弹窗中。
- 适配使用设备：为手机、平板和固定中控屏设置合适的画布分辨率、布局与显示方式。
从户型绘制到 3D 交互
绘制自己的家
在「户型图绘制」中导入平面图、标定比例、描绘墙体与门窗，再摆放家具、电器和灯具。支持多楼层、3D 预览、灯光布置和视角调整，无需使用专业建模软件。
保存户型后，可以选择两种方式放到仪表盘中：
| 使用方式 | 适合的展示与操作 |
|---|---|
| 户型图片与灯光图层 | 固定视角展示，搭配设备按钮和灯光效果；可手动组合，也可使用自动导图流程。 |
| 3D 交互控件 | 在实时 3D 场景中旋转、缩放、切换楼层、聚焦设备，并打开对应控制弹窗。 |
在户型里操作设备
将保存的户型载入「3D 交互」控件，按楼层为灯组和设备模型绑定 Home Assistant 实体。模型呈现设备的位置与外观，实体提供真实状态与可用操作。
- 灯光：点按开关、聚焦或打开弹窗；按实体能力调节亮度与色温，配置灯光照射范围。
- 环境：控制空调、窗帘与空气净化器，显示温湿度；双层窗帘可组合为一个入口，分别保留两层控制与动画。
- 设备：配置电视、NAS、冰箱、洗衣机等模型的状态与弹窗；扫地机支持聚焦、快捷操作，以及在具备位置数据时跟随真实位置。
- 安防：查看摄像头画面、人体感应与门的开合状态。门扇动画用于状态展示，不提供开锁控制。
楼层总览、默认视角、设备聚焦、弹窗大小与位置、闲置后自动旋转等都可以调整。渲染分辨率和反射效果也可按手机或平板的性能设置。
先配置一盏灯
3D 交互需要相应功能授权、已保存的户型，以及正常连接的 Home Assistant。先把一个灯组绑定到真实灯光，验证开关与状态同步，再逐步加入其他设备。具体控制能力取决于实体提供的功能。
在手机、平板与中控屏上使用
完成页面并保存后，在目标设备上打开仪表盘，检查显示比例、触控、设备控制与摄像头播放。二维控件和 3D 交互可以按需要组合到同一套仪表盘中，按使用场景设计各个页面。
授权与开始使用
HA Bridge 为付费项目，具体功能按授权范围开放，3D 交互需开通对应功能权益。购买前请查看商店中的授权说明。
主授权、订单和激活码统一保存在授权账号中。购买后在账号中心查看激活码，按照对应部署教程安装、激活，再连接 Home Assistant。