Room control | VCA Help Center

VCA Help Center

VCA 的房间控制功能通过与强大的开源家庭自动化平台 Home Assistant 集成，允许您使用 Controller 平板来便捷地管理和调控会议室内的各种智能硬件设备，如灯光、窗帘、空调、显示设备等，并能执行预设的智能场景。

此功能依赖于您已正确部署并配置好的 Home Assistant 系统。VCA 作为桥梁，将您在 Home Assistant 中精心设计的控制视图展示在 Controller 上，供您轻松操作。

如果您位于中国大陆，请注意使用合法代理，为位于境外服务器上的应用程序和扩展组件的下载加速。

前提条件与准备工作

1

部署 Home Assistant OS

您需要拥有一台 Home Assistant Green 硬件设备，或者在您局域网内的服务器/虚拟机中自行部署并运行 Home Assistant OS。
确保 Home Assistant 系统已正常运行并可以通过网络访问。

2

安装 kiosk-mode 插件

3

安装 ha_rest_api 扩展

在Home Assistant配置目录下的`custom_components`文件夹中执行以下命令：

git clone https://github.com/vcaapp/ha_rest_api.git

在 Home Assistant 的 configuration.yaml 文件中任意新增一行添加以下配置：

ha_rest_api:

4

验证安装

重新启动Home Assistant，扩展将自动加载。

5

在 Home Assistant 中配置智能设备与控制视图

添加与配置智能硬件： 在您的 Home Assistant 系统中，添加并配置所有您希望通过 VCA 控制的会议室智能硬件设备。
设计控制视图： 在 Home Assistant 中，创建一个或多个专门用于会议室控制的 控制视图。在此视图中，您可以自定义布局，添加各种设备控制卡片（如灯光开关、亮度条、窗帘滑块、空调控制、场景按钮等）。
创建长期访问令牌 (Access Token)： 在 Home Assistant 的用户配置中，创建一个长期有效的访问令牌。请务必复制并妥善保存此令牌，后续在 VCA Host 中配置时需要使用。

在 Host 端配置 Home Assistant 集成

完成 Home Assistant 端的准备工作后，您需要在 VCA Host 软件中进行以下配置，以关联您的 Home Assistant 系统：

1

访问房间控制设置

在 Host 软件的主界面或通过其系统托盘/菜单栏图标进入 “设置”。
在设置界面的左侧导航栏中，选择 “房间控制”。
如果尚未关联任何控制视图，页面会提示您 “您尚未关联任何控制视图”。

2

关联控制视图

点击页面中间或右上角的 “关联控制视图” 按钮。
此时会弹出 “关联控制视图” 窗口。

3

输入 Home Assistant 服务器信息

在弹出的窗口中：
- Url ： 输入您的 Home Assistant 服务器的完整 URL 地址。默认通常为 http://homeassistant.local:8123，但如果您的 Home Assistant 部署在不同地址或端口，请务必输入正确的地址。系统会提示“确保局域网内只有一个 Home Assistant ”，以避免冲突以及自动发现 Home Assistant。
- 访问令牌： 粘贴您之前在 Home Assistant 中创建并保存的长期访问令牌。
点击 “连接” 按钮。

4

选择并关联控制视图

如果 VCA Host 成功连接到您的 Home Assistant 服务器：
- 系统可能会先提示您 “控制视图已关联 ”，并建议您“请前往 Home Assistant 完成控制视图的设计”。如果您已设计好控制视图，点击 “继续” 。
- 接下来，会弹出“选择控制视图” 窗口。
- 从 “控制视图” 下拉菜单中，选择您在 Home Assistant 中为该会议室设计的特定控制视图。
- 点击 “关联” 按钮完成关联。

5

查看与管理已关联的视图

成功关联后，Host 端的 “房间控制” 设置页面将直接显示您选择的 Home Assistant 控制视图。
您可以点击页面右上角的 “控制视图” 下拉菜单进行后续管理：
- 设计控制视图： 此选项可能会尝试打开您的 Home Assistant 界面，方便您调整视图设计。
- Home Assistant 观察者： 用于查看 Home Assistant 服务运行状态。
- 编辑控制视图： 允许您重新选择或更改已关联的 Home Assistant 控制视图。
- 取消关联控制视图： 解除 Host 与当前 Home Assistant 控制视图的关联。

在 Controller 上使用房间控制

配置完成后，您可以通过 Controller 平板来实际操作会议室的智能设备。Controller 的使用方式取决于其在初始配对或设置时被定义的角色模式。

典型部署与用途： 通常放置在会议桌上，方便与会者在会议过程中随时调控房间环境，无需起身。
操作步骤：
- 在 Controller 应用的主界面，点击左侧导航栏的 “房间控制” 页签。
- 界面会完整显示从 VCA Host 同步过来的、已关联的 Home Assistant 控制视图。
- 您可以直接在此视图上点击灯光、窗帘、空调等设备的控件，或触发预设的智能场景按钮 (如 Enter, Speech, Discussion 等)。所有操作指令将发送给您的 Home Assistant 服务器执行。

智能场景与自动化建议： 为了获得更佳的自动化体验（尤其是在 “房间控制器” 模式下），建议您在 Home Assistant 系统中结合人体传感器等设备，配置自动化规则。例如，当传感器检测到有人进入会议室时，自动触发“入场”场景（开启灯光、空调等）；当检测到长时间无人时，自动执行“离场/节能”场景。这些高级自动化需在 Home Assistant 中设置。