首页 › 用户指南 › 家庭自动化
Home Assistant · Hubitat · Webhook

Home Assistant 与 Hubitat:你的场景,无需手机即可运行

将 AVR Maestro 关联到 Home Assistant 或 Hubitat,你创建的每个场景都会成为中枢上的原生脚本。此后,中枢直接通过你自己的网络与接收机通信,所以“Alexa,观影之夜”在你的手机关机、休眠,甚至身在另一个国家时依然有效。

为什么无需应用也能运行

大多数集成都让手机充当中间人:手机听到指令,手机发送指令,自动化只有在手机处于唤醒状态并联网时才能工作。

AVR Maestro 不这样做。它会把你的场景编译成存放在中枢上的脚本,由中枢向接收机的本地 IP 发送指令。同步完成后,应用的任务就结束了。

Home Assistant 全流程

同步完成之后

打造一个值得一看的仪表盘

Home Assistant 现在为接收机能接受的每项指令都提供了一个控制项,但对如何排列它们毫无主张。仪表盘示例就是其中一种排列,并附有完整的 YAML:当前生效时会点亮的输入源和环绕声磁贴、以真实 dB 显示的音量、读取自己名称的场景,以及一份如实说明 Home Assistant 能看到什么、看不到什么的清单。

由 AVR Maestro 同步的控制项构建的 Home Assistant 仪表盘
不只是场景

扬声器预设、Dirac 和 Audyssey 也一样

开启同步高级控制后,应用发布的脚本远不止场景:每个扬声器预设、每个 Dirac Live 滤波器插槽、每条 Audyssey 曲线都会发布。在 Cinema 30 上完整同步会生成七十多个脚本,因此仪表盘按钮或语音指令可以像调用场景一样加载 Dirac 滤波器或切换房间曲线。

AVR Maestro 的 Home Assistant 界面,已开启同步高级控制
不只写入,还能读取

Home Assistant 能看到当前生效的是什么

脚本只能运行,不能读取,所以早期的仪表盘可以切换 Audyssey 曲线或 Dirac 插槽,却无法显示当前是哪一个。应用已掌握的读数,包括实时环绕声模式、当前的 Dirac 滤波器、扬声器预设、调光以及另外几十项,现在都会作为属性发布到接收机的状态传感器上,因此磁贴可以为真正在运行的设置点亮。

AVR Maestro 向 Home Assistant 发布扬声器预设、Dirac Live 和 Audyssey 控制脚本
每个房间

同一个仪表盘控制你的其他分区

分区 2 和分区 3 的电源、音量和静音会发布为各自独立的脚本,因此露台或另一个房间也能像主分区一样响应仪表盘或语音助手。只有接收机实际报告的分区才会有按钮,所以双分区的接收机不会凭空多出一个分区 3。

如果你用旧版本同步过

你的脚本 ID 会变一次

脚本过去以场景和接收机来命名,因此重命名其中任何一个,都会留下旧脚本并悄悄创建出第二个。现在它们以场景和接收机的 MAC 地址命名,正是这一点让重命名能更新原有脚本,而不是另起一个。

这次变更之后的首次同步会用新脚本替换旧脚本。凡是基于旧 ID 搭建的内容,都需要重新指向一次,例如仪表盘按钮、自动化和语音别名。请在 Home Assistant 中打开该脚本,查看它的新实体 ID。

实体现在也以接收机命名,形如 cinema30,而不再是三十二个字符的机器标识符,所以列表清晰易读,自动补全也能找到它们。早期版本的 ID 仍可继续使用。

Hubitat

Hubitat 通过其 Maker API 获得支持,在应用中标记为 BETA,是因为它比 Home Assistant 方案更新,而不是因为尚未完成。

  • 集线器 IP:你的 Hubitat 在局域网中的地址。
  • Maker API 应用 ID:Maker API 应用自身 URL 中的数字。
  • 访问令牌:启用 Maker API 时由其颁发。

请先在中枢上启用 Maker API(应用 › 添加内置应用 › Maker API),它会给你这三项信息。粘贴进来后,AVR Maestro 会发现你的接收机,把你的场景发布为命令序列,并回传实时状态,这样 Hubitat 仪表盘反映的就是接收机实际正在做的事,而不是它上一次被告知的内容。

Hubitat 设置界面,包含集线器 IP、Maker API 应用 ID 和访问令牌

Webhook

Home Assistant 和 Hubitat 是把指令发给接收机。Webhook 则反方向工作:接收机一有动作,就通知其他任何东西。打开接收机,AVR Maestro 就会向你选定的地址发送一条小消息,这条消息就是 Webhook。

这是唯一不独立于手机的部分。你同步的场景会变成中枢上的脚本,无论应用在不在附近都能运行。Webhook 则不同:监视接收机的是 AVR Maestro,所以触发器只会在应用于一台能连到接收机的设备上打开时才会触发。如果你希望在没有任何应用运行时也能触发,请围绕接收机实体在中枢上搭建。

四种触发器

触发事件触发时机可限定为
接收机开机接收机退出待机-
接收机关机接收机进入待机-
输入源变更所选输入源发生变化单个输入源,位于仅针对此输入源触发下
场景已调用某个场景被应用单个场景,位于选择场景下

限定条件才能让它们有用而不是吵闹。对每个输入源都启用“输入源变更”就像消防水龙头;而把同一个触发器限定在投影仪所接的那一个输入源上,它就是一个电灯开关。

输入源列表就是你自己的接收机所报告的那一份,因此已经反映了你重命名或隐藏过的输入源。场景列表则是你自己的场景。

逐步设置

这是 Home Assistant 方案,也是大多数人想要的。请先完成 Home Assistant 这一半,应用需要有个目标可以指向。

在 Home Assistant 中

在 AVR Maestro 中

走 Home Assistant 方案时,你永远不需要输入 URL。应用会根据你关联的 Home Assistant 构建它,并且每次触发器触发时都会重新查找该地址。把 Home Assistant 换到新端口、新主机名或 Nabu Casa 地址,你已创建的所有 Webhook 都会随之更新。无需重新同步,也没有按钮要按。
如果面板上显示尚未关联 Home Assistant,请先完成本页顶部的 Home Assistant 卡片。Webhook 方案需要一个地址作为基础。

发送到 Home Assistant 以外的地方

把发送目的地切换为其他,并将完整 URL 粘贴到 Webhook URL。任何能接收 POST 的东西都可以:Node-RED 流程、IFTTT 小程序、NAS 上的脚本、Hubitat Maker API 端点。这种方式会原样保存你输入的地址,所以如果目的地变了,你需要编辑触发器。

实际发送的内容

一个小型 JSON 正文。同一界面上的发送内容卡片会针对你选的触发器用通俗的语言说明,所以你无需猜测。下面是你的自动化会读取的字段名称:

触发器消息中的字段
接收机开机 / 关机event, timestamp
输入源变更…另外还有 source
场景已调用…另外还有 sceneId 和 sceneName

在 Home Assistant 自动化中,这些字段会以 {{ trigger.json.event }}、{{ trigger.json.source }} 等形式到达。你可以读取它们,也可以完全忽略,只对“已触发”这件事作出响应。大多数人选择后者。

如果你需要不同的格式,比如某个服务要求自己的格式,请打开该卡片下方的改为发送我自己的 JSON,在那里编写。它被折叠起来并标记为高级,是因为几乎没有人需要它,而不是因为不鼓励使用。

这个界面叫Webhook,因为它就是 Webhook。如果你要找的是在中枢上运行的自动化,那是上方的 Home Assistant 和 Hubitat 卡片:同步后的场景在那里是脚本,而不是这里的 Webhook。

Webhook 没有送达时

按值得检查的顺序排列,因为前两项几乎总是原因所在:

哪些付费,哪些不付费

家庭自动化是唯一的解锁项。AI 助手是免费的。

家庭自动化(专业版),包括 Home Assistant、Hubitat 和出站 Webhook,是一次性解锁。AVR Maestro 中的其他所有功能,包括设备端 AI 助手,都已包含在应用内。

语音控制是通过家庭自动化,经由你的中枢来控制接收机的。AVR Maestro 本身不运行语音识别。

常见问题

家庭自动化常见问题解答

语音控制需要保持手机开机吗?
不需要。AVR Maestro 会把你的场景编译为原生 Home Assistant 脚本。Home Assistant 直接通过本地网络与接收机通信,所以你的手机可以关机、休眠,甚至身在另一个国家。
哪些语音助手可以控制我的接收机?
你已经在用的任何一个。AVR Maestro 不会添加自己的语音层,它只是把脚本发布到 Home Assistant 或 Hubitat,再由你信任的这个中枢开放给 Alexa、Google Assistant 或 Siri 快捷指令。
AI 助手属于付费解锁内容吗?
不属于。设备端 AI 助手是免费的。家庭自动化,包括 Home Assistant、Hubitat 和出站 Webhook,是 AVR Maestro 中唯一的付费解锁项。
有任何内容会离开我的家庭网络吗?
控制不会。应用通过你自己的网络与接收机和中枢通信,任何内容都不会经过 MiyaraHub 的服务器。Webhook 会发往你指定的地址,这由你自己决定。
指南的更多内容

其他 AVR Maestro 指南

快速入门 · 主屏幕 · 场景 · 自定义图标 · 声音 · 图形 EQ · 扬声器 · 控制项为何被锁定 · 助手 · Home Assistant 仪表板 · 分区 · 遥控 · 收音机 (FM/AM) · 屏幕显示 · 设置 · 语言 · 音量控制 · 备份 & 恢复 · 正在播放 & HEOS

你的场景,无需手机即可运行

家庭自动化是一次性解锁。应用中的其他所有功能,包括 AI 助手,均已包含在内。

在 Google Play 获取 在 App Store 下载 在 Mac App Store 下载 在 Microsoft Store 获取

返回完整用户指南 →