Home Assistant 與 Hubitat：您的情境，不需手機也能執行

大多數整合都讓您的手機充當中間人：手機聽到指令、手機送出指令，而自動化只有在手機清醒且連上網路時才能運作。

AVR Maestro 不這樣做。它會將您的情境編譯成存放在中樞上的腳本，再由中樞將指令送到接收器的區域網路 IP。同步完成後，應用程式的工作就結束了。

• 本機優先：沒有任何內容經過 MiyaraHub 的伺服器。您的中樞與接收器直接彼此通訊。
• 不依賴手機：情境一旦發布，不論建立它的手機有沒有安裝應用程式，都能執行。
• 用您的助理，而不是我們的：Alexa、Google Assistant 與 Siri 捷徑，都是透過您信任的中樞來使用這些腳本。AVR Maestro 本身不加入任何語音層。

• 1. 請先將您的接收器新增至 Home Assistant。設定 › 裝置 & 服務 › 新增整合 › Denon AVR（或 HEOS），然後輸入接收器的本機 IP。Home Assistant 會為它建立一個媒體播放器實體。
• 2. 在 AVR Maestro 中開啟「設定 › 居家自動化」，並點選 Home Assistant 卡片。
• 3. 輸入您的 Home Assistant 位址，可以是區域網路位址如 http://192.168.1.150:8123，或您的外部 Nabu Casa URL。
• 4. 登入並授權。會開啟安全的應用程式內瀏覽器，顯示 Home Assistant 自己的登入頁面。您的憑證只會交給 Home Assistant，絕不會傳給我們。
• 5. 它會自動找到您的接收器。應用程式會掃描您的媒體播放器實體，依型號、名稱與環繞能力評分，然後自動為您填入正確的實體。
• 6. 同步。您的情境會被建置成腳本並上傳。之後編輯情境時，腳本會在背景自動更新，不需要記得按任何按鈕。

同步完成之後

打造一個值得一看的儀表板

Home Assistant 現在為接收器能接受的每項指令都提供了控制項，但對該怎麼排列完全沒有意見。儀表板範例就是一種附完整 YAML 的排列方式：成為使用中項目時會亮起的訊源與環繞磚、以真實 dB 顯示的音量、會讀取自己名稱的情境，以及一張誠實標示 Home Assistant 看得到與看不到什麼的地圖。

不只是情境

喇叭預設、Dirac 與 Audyssey 也包含在內

開啟同步進階控制項後，應用程式發布的腳本就遠不只您的情境：每個喇叭預設、每個 Dirac Live 濾波器槽位，以及每條 Audyssey 曲線都有。在 Cinema 30 上完整同步會產生七十多個腳本，所以儀表板按鈕或語音指令可以載入 Dirac 濾波器或切換房間曲線，就像叫出一個情境一樣。

不只寫入，也能讀取

Home Assistant 看得到目前啟用的是什麼

腳本只能執行，無法讀取，因此早期的儀表板雖然能切換 Audyssey 曲線或 Dirac 槽位，卻無法顯示目前是哪一個。應用程式已掌握的讀數，包括即時環繞模式、使用中的 Dirac 濾波器、喇叭預設、亮度和其他數十項，現在都會以屬性的形式發布在接收器的狀態感測器上，讓磚能為實際運作中的設定亮起。

Home Assistant 與 Hubitat 是將指令送到接收器。Webhook 則是反方向：當接收器有動作時，通知其他任何東西。開啟接收器，AVR Maestro 就會向您指定的位址送出一則小訊息，這則訊息就是 Webhook。

四種觸發器

縮小範圍才能讓它們有用而不吵雜。對每個輸入都啟用「使用中輸入已變更」就像消防水管；同一個觸發器若只鎖定投影機所在的那個輸入，就是一個電燈開關。

輸入清單是您自己的接收器所回報的，因此已反映您重新命名或隱藏的任何訊源。情境清單則是您自己的情境。

這是 Home Assistant 路線，也是大多數人想要的。請先完成 Home Assistant 那一半，因為應用程式需要有指向的目標。

在 Home Assistant 中

• 1. 設定 › 自動化 & 情境 › 建立自動化 › 建立新的自動化。
• 2. 新增觸發條件 › Webhook。Home Assistant 會為您產生一組冗長的隨機 Webhook ID。
• 3. 換成您認得出來的名稱，例如 avr-power-on、avr-movie-night。只要在您的 Home Assistant 上是唯一的，任何名稱都可以。請記下來，您要在 AVR Maestro 中輸入同一個。
• 4. 在 Webhook 的設定中，允許 POST。這是 AVR Maestro 送出的方式。僅限本機即可，因為應用程式就在您自己的網路上。
• 5. 加入您希望它執行的動作，例如調暗燈光、關上窗簾、啟動情境，然後儲存自動化。

在 AVR Maestro 中

• 1. 設定 › 居家自動化 › Webhook，然後點新增第一個觸發器，或在已有觸發器時點 + 按鈕。
• 2. 觸發事件：選擇要由什麼來觸發。選擇使用中輸入已變更或已叫出情境時，會多出第二個方塊供您縮小範圍。
• 3. 傳送目的地：保持在 Home Assistant。位址已經知道，因為您稍早已在這個畫面連結過。
• 4. Webhook ID：輸入與您在 Home Assistant 中使用的相同 ID。其他都不需要相符。下方應用程式會列出它將要送出的完整位址：Sends to http://your-ha:8123/api/webhook/avr-power-on，讓您在儲存前檢查。
• 5. 儲存。然後在清單中按下該觸發器的測試。您的 Home Assistant 自動化應該會立即執行。

傳送到 Home Assistant 以外的地方

將傳送目的地切換為其他，並在 Webhook URL 貼上完整的 URL。任何接受 POST 的東西都可以，例如 Node-RED 流程、IFTTT 小程式、NAS 上的腳本，或 Hubitat Maker API 端點。這條路線會原封不動地儲存您輸入的位址，因此目的地移動時，您需要編輯該觸發器。

一個小型 JSON 內容。同一畫面上的傳送內容卡片，會用白話描述您所選觸發器的內容，所以您不必猜測；以下是您的自動化會讀取的欄位名稱：

在 Home Assistant 自動化中，這些會以 {{ trigger.json.event }}、{{ trigger.json.source }} 等形式送達。您可以讀取它們，也可以完全忽略，只針對它已觸發這件事採取行動。大多數人都選後者。

如果您需要不同的格式（例如某個服務要求自己的格式），請在該卡片下方開啟改為傳送我自己的 JSON並在那裡撰寫。它是收合起來並標為進階的，因為幾乎沒有人需要，而不是因為不鼓勵使用。

請依序檢查，因為前兩項幾乎都是原因所在：

• 先按測試。它會把與真實觸發器相同的訊息送到相同的位址，並告訴您發生了以下三種情況的哪一種：已送達、未送達，或因為該觸發器自己的開關關閉而略過。如果測試成功送達而實際事件卻沒有，問題就出在觸發器，最常見的是使用中輸入已變更被縮小到一個您實際上並不會切換過去的輸入。
• 檢查 ID 是否完全相符。Home Assistant 的 Webhook ID 區分大小寫，也容不下多餘的空格。應用程式會在欄位下方列出它將要送出的完整位址，請與您自動化中的位址比對。
• 檢查自動化是否允許 POST。只允許 GET 的 Home Assistant Webhook 觸發器，會悄悄忽略 AVR Maestro 送出的內容。
• 檢查觸發器的開關是否已開啟。清單中每個觸發器都有自己的切換開關，已關閉的觸發器會被略過，而不是失敗。
• 觸發器屬於單一接收器。您目前看到的清單，是目前所選接收器的清單。另一台接收器有自己的清單，所以在這裡建立的規則不會對另一個房間觸發。
• 應用程式必須在監看。是 AVR Maestro 注意到接收器改變了，所以口袋裡的手機若沒有開啟應用程式，就不會觸發任何東西。這是本節開頭所說明的取捨，不是故障。
• Webhook 屬於居家自動化的一部分。未解鎖時，觸發器看得到但不會送出任何東西，而且測試會直接說明，而不是假裝成功。

開始使用 · 主畫面 · 場景 · 自訂圖示 · 音效 · 圖形等化器 · 喇叭 · 控制項為何被鎖定 · 助理 · Home Assistant 儀表板 · 分區 · 遙控器 · 廣播 (FM/AM) · 螢幕顯示 · 設定 · 語言 · 音量控制項 · 備份 & 還原 · 正在播放 & HEOS