企业官网建设流程全解析

NeonPlan 3D 的 Camera Cockpit（相机驾驶舱）是专为 Home Assistant 打造的 3D 家庭监控中枢：门铃一响，墙装平板上的 3D 视图会自动飞向大门，并以门前摄像头的视角实时查看门外情况，随后自动回到原视图。本文将带你一步步配置这套"无人值守"的自动巡航体验。

一、Camera Cockpit 是什么？

Camera Cockpit 是 NeonPlan 3D 的一组 Pro 功能，让屏幕自己"看见"家里发生的事：

• 门铃响起：3D 视图飞到前门，透过摄像头看向门外
• 摄像头发现有人：自动切换到对应摄像头视角
• 洗衣机/烘干机/洗碗机洗完：飞往对应房间
• 出现新告警（烟雾、漏水、报警等）：立即定位到事发处

每个事件都是独立开关，默认全部关闭，你可以只启用最需要的。核心调度逻辑在 frontend/src/director.ts 中实现，事件优先级为：告警 > 门铃 > 自定义触发器 > 移动侦测 > 家电完成，并且每类事件都内置了冷却时间（例如门铃 20 秒、移动侦测 120 秒），不会频繁抢屏。

二、第一步：在编辑器中放置摄像头并调整视野

Live director 能"透过摄像头看"的前提，是摄像头已经放进户型图，并且视野方向正确。

1. 打开编辑器，像放置其他设备一样放置摄像头
2. 在图纸中会出现一个视野楔形（wedge），拖动尖端手柄即可旋转方向、同时调整覆盖范围
3. 在右侧表单中可精确输入Field of view (°)、Reach (m)、Tilt down (°)
4. 在 3D 视图中，摄像头会挂在墙上或天花板上，视野投影在地面上；一旦摄像头的移动/在场传感器上报移动，视野楔形会变红

完整说明见 docs/manual.md 第 4.13 节 "Cameras"。

三、第二步：配置 Live director 触发事件

进入编辑器顶部⚙ Settings → 🎬 Live director，每一项事件都有独立开关：

💡 小提示：门铃自动匹配摄像头时，会优先取同一设备上的摄像头，其次取同一 area 内的摄像头。摄像头必须放在图纸里，否则视图只能飞上门铃，无法透传画面。

四、第三步：在墙装平板上开启自动巡航

配置分两处，缺一不可：

1. 哪些事件：如上节在 Live director 中勾选
2. 在哪块屏幕：同一节的Switch on on this device，只对当前浏览器生效——正是墙装平板的 NeonPlan 面板。若在仪表盘卡片中使用，则改为卡片设置里的director: true

几个贴心的细节：

• 有人正在使用平板时，只有门铃和告警会打断画面，移动侦测不会
• director 展示期间你触摸屏幕，视图就会停在你所在处，不再自动返回
• 配合卡片选项camera_wall: true（Pro），平板底部会出现 "Cameras" 按钮，一键铺开所有摄像头的实时画面墙，正在侦测到移动的摄像头标红框、录像中标红点

五、配套功能：移动轨迹与检测标记

Camera Cockpit 还有两个"看家"好手，可与 Live director 搭配使用：

• Trail（移动轨迹）：显示最近 30 分钟内移动上报的位置，发光标记带时间戳并按顺序连线，越久越淡。数据来自 Home Assistant 历史记录，每分钟刷新一次
• Detection pins（检测标记）：当摄像头传感器（Frigate、UniFi Protect、Reolink 等）当前上报检测时，摄像头前会立起一个图钉，显示类型和时间，如 "Person · 18:42"；多个对象会叠加显示。嫌太花哨可在摄像头表单中关闭Show detection symbols，检测时仅让视野变红

六、常见问题

Q：门铃响了但视图没有飞过去？确认三点：门铃实体在 Live director 中被识别、"Switch on on this device" 在平板浏览器上已开启、摄像头已放置到图纸中。

Q：画面对不齐怎么办？在编辑器中修正摄像头的旋转和俯角（Tilt down），楔形尖端手柄可以旋转同时设置覆盖范围。

Q：老平板卡？把画质档位切到Tablet（自动省略纹理、阴影和光晕），并关闭 "Live picture when looking through"，让透视模式使用静态截图。平板档位下摄像头墙刷新间隔会从 5 秒变为 10 秒，页头会有提示。

Q：只想让卡片而不是面板自动巡航？在仪表盘卡片设置中打开Live director（YAML 中director: true），无需改动平板浏览器设置。

七、总结

Camera Cockpit 把 NeonPlan 3D 从"好看的 3D 户型图"升级为"会自己值班的安防中枢"：放置摄像头 → 勾选门铃等触发事件 → 在墙装平板上开启本设备开关，三步即可完成。门铃一响，视图自动飞向前门并以摄像头视角呈现门外，30 秒后自动归位——整个过程零手动操作，且全部数据本地运行，不经过任何云。更多细节请查阅 docs/manual.md 第 6.1 节 "Camera cockpit" 与 frontend/src/director.ts 源码注释。