Assistela Assistela 說明文件
支援的服務

Home Assistant

連接 Home Assistant、測試存取權,並針對每個實體決定 Assistela 只能讀取,還是也能控制。

連線後可使用的功能

Assistela 可讀取智慧家庭的目前狀態,並在收到明確要求後呼叫 Home Assistant 服務。它可以檢查溫度感測器、讀取燈光狀態、從獲准的攝影機擷取快照、執行情境,或控制特別獲准的裝置。

此連線有兩層保護:Home Assistant 存取權杖,以及 Assistela 中的實體允許清單。即使權杖允許更多操作,Assistela 仍會拒絕處理未加入允許清單的實體。

1. 建立長期存取權杖

1

開啟您的個人檔案

在 Home Assistant 中開啟您的使用者個人檔案,找到 Long-Lived Access Tokens

2

建立權杖

選擇建立新的權杖,並取一個容易辨識的名稱,例如 Assistela Mac

3

立即複製

Home Assistant 通常只會顯示一次權杖值。請複製它,並在儲存至 Assistela 前保持對話框開啟。

權杖是機密資訊

不要將它貼到「聊天」、「記憶」或一般備忘錄中。只在 Home Assistant 存取金鑰欄位中輸入。Assistela 會將它儲存為受保護的憑證;若懷疑已外洩,請在 Home Assistant 中撤銷權杖並建立新的權杖。

2. 與 Assistela 配對

1

開啟整合

在 Assistela 中選擇 Assistela → 設定 → 整合 → Home Assistant,再開啟配對分頁。

2

輸入位址

Home Assistant 位址中,輸入您在瀏覽器使用的相同 URL,包括 http://https:// 及任何連接埠。本機範例為 http://homeassistant.local:8123

3

貼上存取金鑰

將剛才建立的權杖貼入 Home Assistant 存取金鑰

4

儲存並測試

按一下儲存並測試連線。若使用本機位址,macOS 可能會要求區域網路存取權;請為此用途允許。

3. 只允許選取的實體

開啟允許的實體並重新整理項目。您可以搜尋列表並依類型篩選。每個實體都有兩個獨立選項:

  • 讀取:Assistela 可以取得其狀態與屬性。感測器及只需回報的裝置適合使用此選項。
  • 控制:Assistela 可以呼叫開燈或執行情境等動作。啟用「控制」也會啟用「讀取」。

一開始只加入少數無害的項目,例如溫度感測器與一盞測試燈。對於門鎖、警報器、車庫門、暖氣或其他攸關安全的裝置,請先不要啟用「控制」,直到您確定要使用哪些指示與核准規則。

首次測試

  1. 詢問:「客廳感測器目前的狀態是什麼?」
  2. 如果讀取正常,請嘗試操作獲准的測試燈:「短暫開啟辦公室測試燈。」
  3. 之後直接在 Home Assistant 中確認狀態。

若缺少某個實體,請重新整理列表。遺失狀態通常表示該實體已在 Home Assistant 中重新命名或刪除,您需要選取目前的實體 ID。