自適應燈光 Blueprint

Home Assistant 自動化藍圖，根據一天中的 6 個可設定時段，自動調整燈光亮度和色溫。

功能特色

• 6 個時段：早晨、白天、傍晚、晚上、睡前、夜間
• 多燈支援：可選擇多個燈光，每個燈光獨立控制
• 漸變過渡：可設定過渡時間，平滑切換
• 全域條件：可選的額外執行條件
• 星期篩選：僅在選定的星期執行
• 燈光範圍控制：
  • 開燈觸發：僅調整被開啟的燈光
  • 時間觸發：僅調整目前亮著的燈光

系統需求

• Home Assistant 2024.6.0 或更新版本
• 支援亮度和色溫調整的燈光

安裝方式

方式一：透過 URL 匯入

1. 前往 設定 > 自動化與場景 > 藍圖
2. 點選 匯入藍圖
3. 貼上網址：https://github.com/WOOWTECH/HA_blueprint_adalight/blob/main/adalight.yaml

方式二：手動安裝

1. 將 adalight.yaml 複製到 /config/blueprints/automation/woowtech/
2. 重新啟動 Home Assistant 或重新載入自動化

設定說明

必填項目

項目	說明
燈光實體	選擇要控制的燈光（支援多選）

時段設定

每個時段有 4 個可設定選項：

設定	說明	範圍
開始時間	該時段的開始時間	HH:MM:SS
色溫	目標色溫（Kelvin）	2000-6500K
亮度	目標亮度百分比	1-100%
漸變時間	過渡持續時間	0-300 秒

預設值

時段	時間	色溫	亮度
早晨	07:00	6410K	100%
白天	10:00	4291K	100%
傍晚	18:00	2890K	100%
晚上	20:00	2237K	57%
睡前	22:00	2000K	35%
夜間	00:00	2000K	4%

選填設定

設定	說明
全域條件	必須滿足的額外條件
星期篩選	選擇自動化執行的星期

運作行為

開燈觸發

當選定的燈光被開啟時：

1. 自動化檢查目前時段
2. 將亮度和色溫套用到該燈光
3. 其他選定的燈光維持不變

定時過渡

在每個時段開始時：

1. 自動化檢查是否有任一選定燈光亮著
2. 將新設定套用到目前亮著的燈光
3. 關閉的燈光維持關閉狀態

疑難排解

燈光在排定時間沒有變化

• 確認燈光在觸發時間是亮著的
• 檢查自動化追蹤記錄是否有條件失敗
• 確認星期條件包含今天

設定沒有套用到所有燈光

這是預期的行為：

• 開燈觸發只調整被開啟的燈光
• 時間觸發只調整目前亮著的燈光

藍圖沒有出現

• 確認檔案在正確路徑：/config/blueprints/automation/woowtech/adalight.yaml
• 重新載入藍圖：設定 > 藍圖 > 三點選單 > 重新載入

更新紀錄

v2.0.0 (2026-01-26)

• 更新為 HA 2026.1 相容語法
• 將 kelvin 改為 color_temp_kelvin
• 將 service 改為 action
• 將 trigger 改為 triggers
• 移除 LINE 通知功能
• 重大變更：燈光範圍行為改變
  • 開燈觸發現在只針對被開啟的燈光（原本：所有燈光）
  • 時間觸發現在只針對亮著的燈光（原本：所有燈光）
• 為多燈狀態條件加入 match: any
• 加入 source_url 以支援藍圖分享
• 加入 min_version: 2024.6.0 版本要求

v1.0.0

• 初始版本

授權條款

MIT License - 渥屋科技股份有限公司