Assistant Relay与Home Assistant集成指南：打造终极智能家居控制中心 🏠

【免费下载链接】assistant-relay A Node.js server that allows for sending commands to Google Home/Assistant from endpoints 项目地址: https://gitcode.com/gh_mirrors/as/assistant-relay

想要将Google Assistant的强大语音控制功能无缝集成到Home Assistant智能家居系统中吗？🤔 Assistant Relay正是您需要的解决方案！这个开源项目让您能够通过简单的API调用来控制Google Home设备，为您的智能家居生态系统增添强大的语音控制能力。本文将为您详细介绍如何通过Assistant Relay与Home Assistant集成，打造一个真正统一的智能家居控制中心。

📋 什么是Assistant Relay？

Assistant Relay是一个基于Node.js的中间件服务器，它将Google Assistant的功能暴露为REST API接口。这意味着您可以通过HTTP请求来发送任何原本需要通过语音对Google Assistant发出的指令。无论是简单的"开灯"命令，还是复杂的场景控制，Assistant Relay都能完美处理。

核心功能亮点：

• 🔄 REST API接口 - 通过HTTP POST请求控制Google Assistant
• 📢 广播功能 - 向所有Google Home设备发送语音通知
• 🎯 预设命令 - 内置多种实用广播预设（起床、用餐、就寝等）
• 🎵 音频响应 - 获取Google Assistant的语音响应音频
• 🔧 灵活配置 - 支持多用户、安静时段等高级设置

🚀 快速安装与配置

环境准备

首先确保您的系统已安装Node.js和PM2：

# 安装Node.js（从官网下载）
# 安装PM2进程管理器
npm i pm2 -g

安装步骤

1. 克隆仓库：

   git clone https://gitcode.com/gh_mirrors/as/assistant-relay
   cd assistant-relay/relay
   

2. 安装依赖：

   npm install
   

3. 启动服务：

   npm run start
   

初始配置

启动后访问 http://<服务器IP>:3000 进入配置向导，按照提示完成Google OAuth认证设置。您需要创建一个Google Cloud项目并启用Google Assistant API，然后下载OAuth凭据文件。

🔗 Assistant Relay与Home Assistant集成方法

方法一：使用RESTful命令集成

Home Assistant的RESTful命令组件是与Assistant Relay集成的完美选择。在您的configuration.yaml文件中添加以下配置：

rest_command:
  google_assistant_broadcast:
    url: "http://assistant-relay-ip:3000/assistant"
    method: POST
    content_type: "application/json"
    payload: '{"command": "{{ message }}", "user": "homeassistant", "broadcast": true}'
    
  google_assistant_command:
    url: "http://assistant-relay-ip:3000/assistant"
    method: POST
    content_type: "application/json"
    payload: '{"command": "{{ command }}", "user": "homeassistant", "converse": true}'

方法二：自动化场景示例

创建一个自动化场景，当检测到有人回家时，通过Google Home广播欢迎消息：

automation:
  - alias: "Welcome Home Broadcast"
    trigger:
      platform: state
      entity_id: binary_sensor.front_door
      to: "on"
    action:
      - service: rest_command.google_assistant_broadcast
        data:
          message: "欢迎回家！客厅的灯已经为您打开"

🎛️ 实用场景与应用

场景1：早晨唤醒流程 ⏰

automation:
  - alias: "Morning Routine"
    trigger:
      platform: time
      at: "07:00:00"
    action:
      - service: light.turn_on
        entity_id: light.bedroom
      - delay: "00:00:30"
      - service: rest_command.google_assistant_broadcast
        data:
          message: "早上好！现在是7点，早餐已经准备好了"

场景2：安全警报通知 🔔

automation:
  - alias: "Security Alert"
    trigger:
      platform: state
      entity_id: binary_sensor.motion_sensor
      to: "on"
    condition:
      condition: state
      entity_id: input_boolean.home_mode
      state: "away"
    action:
      - service: rest_command.google_assistant_broadcast
        data:
          message: "安全警报！检测到异常活动"

场景3：多媒体控制 🎬

script:
  movie_mode:
    sequence:
      - service: light.turn_off
        entity_id: light.living_room
      - service: media_player.volume_set
        data:
          entity_id: media_player.living_room_speaker
          volume_level: 0.6
      - service: rest_command.google_assistant_command
        data:
          command: "play Stranger Things on Netflix"

⚙️ 高级配置技巧

特定设备广播

Assistant Relay支持向特定的Google Home设备组广播。您需要为每个设备组创建独立的Google账户：

1. 创建新的Google账户
2. 仅将目标设备链接到该账户
3. 在Assistant Relay中配置该账户
4. 发送广播时指定对应的用户名

安静时段设置

避免在夜间打扰家人，配置安静时段：

• 在Assistant Relay仪表板的配置页面中
• 设置开始和结束时间
• 在此期间广播命令将被自动阻止

预设广播命令

Assistant Relay内置了多种实用的预设广播命令：

预设命令	功能描述	示例用途
wakeup	唤醒通知	早晨闹钟
breakfast	早餐就绪	用餐提醒
dinner	晚餐就绪	家庭聚餐
bedtime	就寝时间	睡前提醒
movietime	电影时间	家庭影院

🔧 故障排除与优化

常见问题解决

问题1：认证失败

• 检查OAuth凭据文件是否正确放置
• 确认Google Cloud项目中已启用Google Assistant API
• 验证重定向URI配置

问题2：命令无响应

• 检查Assistant Relay服务是否正常运行
• 确认网络连接正常
• 查看日志文件获取详细信息

问题3：音频播放问题

• 确保Google Home设备在线
• 检查设备音量设置
• 验证网络延迟

性能优化建议

1. 使用PM2管理进程：确保服务稳定运行
2. 配置反向代理：通过Nginx提高安全性
3. 定期更新：关注项目更新获取新功能
4. 监控日志：使用日志分析工具监控服务状态

📈 扩展应用与未来展望

与IFTTT集成

通过Webhooks将Assistant Relay与IFTTT连接，创建更复杂的自动化流程：

• 天气变化时自动广播提醒
• 日程变更通知
• 智能家电状态播报

语音反馈系统

利用Assistant Relay的音频响应功能，创建语音反馈系统：

• 查询设备状态并语音回复
• 报告传感器数据
• 提供操作确认反馈

多语言支持

虽然Assistant Relay主要支持英语，但可以通过创意方式实现多语言广播：

• 使用文本转语音服务预处理消息
• 结合翻译API实现多语言支持

🎯 总结

Assistant Relay为Home Assistant用户提供了一个强大的桥梁，将Google Assistant的语音控制能力无缝集成到您的智能家居生态系统中。通过简单的REST API调用，您可以实现：

✅ 统一的控制中心 - 将所有设备控制集中到Home Assistant
✅ 语音通知系统 - 通过Google Home广播重要信息
✅ 自动化增强 - 为自动化场景添加语音反馈
✅ 灵活扩展 - 支持各种自定义场景和集成

无论您是智能家居新手还是资深玩家，Assistant Relay都能显著提升您的智能家居体验。开始集成吧，让您的家变得更加智能和便捷！✨

提示：在开始配置前，请确保您已备份现有的Home Assistant配置，并逐步测试每个功能，确保系统稳定运行。

---

本文基于Assistant Relay v3.4.0版本编写，配置路径参考：relay/routes/index.js 和 relay/helpers/assistant.js

【免费下载链接】assistant-relay A Node.js server that allows for sending commands to Google Home/Assistant from endpoints 项目地址: https://gitcode.com/gh_mirrors/as/assistant-relay