第一个 3D 交互面板

做完本页，你会得到一个可以旋转户型、点击并控制一盏灯的 3D 仪表盘。

开始前准备

• 已激活，且授权包含 3D 交互功能增量包。
• 已连接 Home Assistant，准备好一个灯或开关实体。
• 已绘制并保存户型，户型里至少有一个灯组。

户型提供位置和外观，HA 实体提供真实状态与控制。 实时 3D 交互直接载入已保存的户型，无需先导出图片。

想先体验现成的 3D 模板？

新建仪表盘时，也可选择「栖光3D-iPad（暖阳原木）」或「栖光3D-手机（默认主题）」。它们自带示例户型和布局，创建后可直接打开设备配置、替换实体。示例户型独立于你的绘制户型；本页下面的空白流程用于搭建自己的户型面板。

1. 创建仪表盘

1. 在编辑器左侧「仪表盘」区域点击「新建」。
2. 选择「空白仪表盘」，填写名称和画布宽高，点击「创建项目」。
3. 在左侧「页面」点击「新建」，输入「家庭总览」等名称，点击「创建页面」。
4. 选择该页面，再切换到「主页面」添加控件。

画布比例按中控设备的横屏或竖屏设置；后续可以在仪表盘设置中调整。

2. 添加 3D 交互

1. 点击「＋ 添加控件」，选择「3D 交互」。
2. 等待已保存的户型载入。
3. 在右侧「户型与布局」选择「铺满」，让面板覆盖画布；需要留出其他控件的位置时选择「自由」。

完成标志： 页面能看到自己的户型。未载入时先检查绘制页是否已保存，再用「重新载入户型」重试。

3. 绑定第一盏灯

1. 在右侧「设备配置」点击「配置灯光」。
2. 选择「配置楼层」，点击「添加灯光」。
3. 选择绘制时建立的「关联灯组」，点击「确定添加」。
4. 在「基础绑定」中填写名称，通过「绑定实体」选择家里对应的灯或开关。
5. 将「点击灯光」设为「仅开关灯」。先保留其他默认设置。

没有可选灯组时，先回到绘制页添加灯组并等待保存，再重新载入户型。

4. 保存并测试

1. 点击灯光窗口顶部的「保存配置」，退出配置窗口。
2. 点击编辑器顶部的「保存」。
3. 切换到「仪表盘」模式，点击刚添加的灯光按钮。
4. 再点击一次，检查灯能关闭，状态能同步回来。

本文标注截图使用当前界面和演示户型；实体与状态为演示数据，请选择自己的 HA 实体。

完成标志： 控制的是正确的灯，按钮和灯效跟随状态；刷新页面后配置仍在。

下一步

• 添加更多设备：绑定设备与传感器。
• 调整视角：视角与楼层。
• 放到平板上使用：连接中控设备。
• 操作遇到问题：3D 交互问题排查。