Node-RED contrib Home Assistant WebSocket 指南

1. 项目介绍

node-red-contrib-home-assistant-websocket 是一个Node-RED节点插件，它允许你通过WebSocket API与Home Assistant智能家居系统进行交互。这个插件使得在Node-RED环境中控制和监控Home Assistant变得简单直观。你可以创建自动化流程，实现设备的远程控制、状态查询等功能。

2. 项目快速启动

安装依赖

首先确保你的Node-RED环境已经安装并运行。然后，在Node-RED的配置界面（通常在浏览器中输入http://your_ip:1880/settings）中，点击"Manage Palette"按钮，接着选择"Install"标签页。

在搜索框里输入 node-red-contrib-home-assistant-websocket，找到对应的插件后点击 "Install" 进行安装。

配置连接

重启Node-RED服务后，新安装的Home Assistant节点应该会在“Input”类别下出现。拖一个home assistant节点到工作区，双击进行配置。

输入以下信息：

• 服务器地址：Home Assistant实例的URL（例如 http://localhost:8123 或 http://your_home_assistant_ip）
• 认证方式：选择使用“访问令牌”或“基本认证”
  • 如果是“访问令牌”，在相应字段输入你在Home Assistant的api:token_generator页面生成的令牌。
  • 如果是“基本认证”，填写用户名和密码。

完成配置后保存并部署节点。

使用示例

下面是一个简单的例子，用于获取Home Assistant中的所有传感器状态：

1. 在工作区添加一个home assistant输入节点和一个debug节点。
2. 将home assistant节点输出连接到debug节点。
3. 部署流。
4. 在home assistant节点上右键单击，选择“Send test message”。
5. 查看调试栏（通常是底部的日志窗口），你应该能看到所有传感器的状态信息。

3. 应用案例和最佳实践

• 自动化场景：根据特定条件触发Home Assistant执行操作，如温度过高时开启空调。
• 实时反馈：通过Node-RED获取设备状态并在网页或其他应用中实时显示。
• 云集成：与其他云服务（例如IFTTT，AWS等）结合，实现跨平台的家庭自动化。

最佳实践包括定期更新节点以获取最新功能和安全补丁，以及保持良好的代码组织，将相关节点组合成子流程以便于管理。

4. 典型生态项目

• Home Assistant Core: 整个智能家居系统的中心，提供丰富的组件支持。
• Node-RED Dashboard: 创建自定义用户界面来控制和监控Home Assistant。
• HASS.io Add-ons: 提供额外的工具和服务，如数据库备份和日志查看器，可直接在Home Assistant环境中运行。

以上就是对node-red-contrib-home-assistant-websocket的基本介绍和使用指南。通过这个插件，你将能够充分利用Node-RED的强大功能来扩展你的Home Assistant体验。祝你好运，开始你的智能家居自动化旅程吧！