解鎖 YAML 潛力：精準監控電源狀態並自動化服務呼叫

深入探討如何利用 YAML 定義電源屬性，實現智慧化 ON/OFF 監控與服務連動，提升自動化效率。

在現代智慧化應用中，透過設定檔來監控裝置狀態並觸發相應操作已成為一種趨勢。YAML (YAML Ain't Markup Language) 以其人類可讀的特性，在設定管理和自動化流程中扮演著關鍵角色。本指南將詳細解析如何運用 YAML 來定義電源 (Power ON/OFF) 的相關屬性，並根據這些屬性變化來呼叫指定的服務 (Service)，特別聚焦於其實際應用場景與配置方法。

核心亮點

YAML 的直觀性： 了解 YAML 如何以簡潔、易讀的語法定義複雜的設定，特別是電源狀態的 ON/OFF 表示。
自動化整合： 探索在 Home Assistant 等平台中，如何透過 YAML 設定觸發器 (Triggers) 和動作 (Actions) 來監控電源並呼叫服務。
靈活的腳本控制： 除了平台整合，學習如何透過通用程式語言（如 Python）讀取 YAML 設定，實現客製化的電源監控與服務呼叫邏輯。

YAML 與電源狀態管理基礎

要有效地使用 YAML 進行電源監控，首先需要理解 YAML 的基本概念以及如何用它來表示電源的開啟與關閉狀態。

YAML 概覽：為何選擇它？

YAML 是一種資料序列化語言，其設計宗旨在於提升人類可讀性與編寫便利性。它使用空白縮排來表示資料的層次結構，而非像 XML 或 JSON 那樣大量使用括號或標籤。這使得 YAML 設定檔在視覺上更為清晰，特別適合用於撰寫設定檔、自動化腳本以及應用程式間的資料交換。YAML 支援多種基本資料類型，包括字串、數字、布林值、列表（序列）和鍵值對集合（映射或字典）。

在 YAML 中表示電源 ON/OFF 狀態

表示電源的「開」(ON) 或「關」(OFF) 狀態時，YAML 提供了幾種方式：

字串表示： 最直觀的方式是使用字串，例如 "ON" 或 "OFF"。在許多自動化平台（如 Home Assistant）中，狀態值通常以小寫字串 'on' 或 'off' 表示。
```
power_status: 'on'
device_mode: 'off'
```
布林值表示： 也可以使用布林值 true (代表 ON) 和 false (代表 OFF)。
```
is_powered_on: true
active: false
```

重要注意事項：根據 YAML 1.2 規範，未加引號的 on 和 off 預設會被視為字串，而不是布林值 true 和 false。這與舊版 YAML 的行為可能不同。因此，在定義狀態時，建議明確使用引號（如 'on'）或標準布林關鍵字 (true/false)，以避免歧義，確保跨平台和解析器的一致性。

實體電源開關，其 ON/OFF 狀態可在智慧系統中被監控。

實現電源監控與服務呼叫的策略

定義了電源狀態後，下一步是設定監控機制，並在狀態變化時觸發服務呼叫。以下將介紹幾種常見的實現方式。

核心概念：觸發器 (Triggers) 與動作 (Actions)

無論在哪個平台或系統中，基於狀態變化的自動化通常遵循「觸發-動作」模式：

觸發器 (Trigger)： 定義了自動化流程啟動的條件。在電源監控的情境下，觸發器通常是監測特定裝置的電源屬性，當其狀態從一個值（例如 'off'）變為另一個值（例如 'on'）時被觸發。
動作 (Action)： 當觸發器被激活後，系統執行的具體操作。這可能包括呼叫一個服務來開啟/關閉另一個裝置、發送通知、執行腳本等。

範例情境：Home Assistant 自動化

Home Assistant 是一個廣受歡迎的開源家庭自動化平台，它廣泛使用 YAML 來定義自動化規則。以下是如何在 Home Assistant 中使用 YAML 監控電源狀態並呼叫服務的範例：

定義監控電源狀態的觸發器

假設我們要監控一個名為 switch.smart_plug 的智慧插座。我們可以設定一個觸發器，在該插座的狀態變為 'on' 或 'off' 時啟動自動化。

trigger:
  - platform: state
    entity_id: switch.smart_plug
    to: 'on'  # 當狀態變為 'on' 時觸發
  - platform: state
    entity_id: switch.smart_plug
    to: 'off' # 當狀態變為 'off' 時觸發

在此配置中，platform: state 指示 Home Assistant 監控實體的狀態變化。entity_id 指定了要監控的目標實體，而 to: 則定義了觸發自動化的目標狀態。

定義呼叫服務的動作

當觸發器被觸發後，我們可以定義相應的動作。例如，當智慧插座開啟時，同時開啟一盞燈 light.living_room_lamp；當插座關閉時，也關閉該燈。

action:
  - choose:
      - conditions:
          - condition: state
            entity_id: switch.smart_plug
            state: 'on'
        sequence:
          - service: light.turn_on
            target:
              entity_id: light.living_room_lamp
            data:
              brightness_pct: 80 # 同時設定亮度
      - conditions:
          - condition: state
            entity_id: switch.smart_plug
            state: 'off'
        sequence:
          - service: light.turn_off
            target:
              entity_id: light.living_room_lamp
    default: [] # 如果沒有條件符合，則不執行任何操作

這裡，service: light.turn_on 和 service: light.turn_off 是 Home Assistant 提供的服務，用於控制燈光的開關。target: {entity_id: ...} 指定了服務作用的對象。data 則可以傳遞額外的參數給服務。

完整的 Home Assistant 自動化範例

將觸發器和動作結合，一個完整的自動化 YAML 可能如下所示：

automation:
  - alias: 'Smart Plug Sync with Living Room Lamp'
    description: '當智慧插座開關時，同步控制客廳燈的開關狀態'
    trigger:
      - platform: state
        entity_id: switch.smart_plug
        to: 'on'
      - platform: state
        entity_id: switch.smart_plug
        to: 'off'
    action:
      - choose:
          - conditions:
              - condition: state
                entity_id: switch.smart_plug
                state: 'on'
            sequence:
              - service: light.turn_on
                target:
                  entity_id: light.living_room_lamp
                data:
                  brightness_pct: 80
          - conditions:
              - condition: state
                entity_id: switch.smart_plug
                state: 'off'
            sequence:
              - service: light.turn_off
                target:
                  entity_id: light.living_room_lamp
        default: []

通用方法：使用腳本語言讀取 YAML 設定

除了依賴特定平台，您也可以使用通用的程式語言（如 Python）來讀取 YAML 設定檔，並根據其中的屬性執行自訂邏輯來呼叫服務（例如執行命令、呼叫 API 或控制硬體）。

在 YAML 中定義電源屬性

一個簡單的 YAML 設定檔 (例如 power_config.yaml) 可能如下：

device_settings:
  target_device_id: "MyDevice001"
  monitor_power: true
  current_power_status: "OFF" # 這個狀態可以被外部程序更新

services_to_call:
  on_power_on: "start_monitoring_script.sh"
  on_power_off: "stop_monitoring_script.sh"

使用 Python 腳本讀取 YAML 並執行操作

以下是一個 Python 範例，展示如何讀取上述 YAML 檔案，並根據 current_power_status 執行相應操作：

import yaml
import subprocess # 用於執行外部腳本或命令
import time

def read_yaml_config(file_path):
    with open(file_path, 'r', encoding='utf-8') as f:
        config = yaml.safe_load(f)
    return config

def call_service_script(script_path):
    try:
        print(f"執行服務腳本: {script_path}...")
        subprocess.run([script_path], check=True) # 假設是可執行的腳本
        print(f"腳本 {script_path} 執行完畢。")
    except FileNotFoundError:
        print(f"錯誤: 腳本 {script_path} 未找到。")
    except subprocess.CalledProcessError as e:
        print(f"錯誤: 腳本 {script_path} 執行失敗: {e}")

def monitor_power_from_config(config_file):
    # 實際應用中，狀態的變化可能由外部事件觸發更新YAML檔案
    # 或腳本定期檢查某個來源來更新YAML中的狀態
    # 此處為簡化範例，僅讀取一次
    config = read_yaml_config(config_file)
    
    device_id = config.get('device_settings', {}).get('target_device_id')
    power_status = config.get('device_settings', {}).get('current_power_status')
    services = config.get('services_to_call', {})

    print(f"監控裝置 {device_id} 的電源狀態: {power_status}")

    if power_status == "ON":
        service_script = services.get('on_power_on')
        if service_script:
            call_service_script(service_script)
        else:
            print("未定義 ON 狀態的服務腳本。")
    elif power_status == "OFF":
        service_script = services.get('on_power_off')
        if service_script:
            call_service_script(service_script)
        else:
            print("未定義 OFF 狀態的服務腳本。")
    else:
        print(f"未知的電源狀態: {power_status}")

# 假設 YAML 檔案與 Python 腳本在同一目錄
# 實際監控循環可能需要更複雜的邏輯，例如監聽檔案變化或定期輪詢
if __name__ == "__main__":
    monitor_power_from_config('power_config.yaml')
    # 為了演示持續監控，可以加入一個循環
    # while True:
    #     monitor_power_from_config('power_config.yaml')
    #     time.sleep(10) # 每10秒檢查一次

這個 Python 腳本使用 PyYAML 函式庫來解析 YAML 檔案，並使用 subprocess 模組來執行外部腳本作為「服務呼叫」的示例。在實際應用中，服務呼叫可能是更複雜的操作，如發送 HTTP 請求到 API、與硬體接口通訊等。

YAML 語法與最佳實踐

為了確保 YAML 設定檔的正確性和可維護性，遵循一些基本的語法規則和最佳實踐至關重要。

縮排： YAML 對縮排極其敏感，它使用空格（通常是2個或4個空格）來表示層次結構。絕對不要使用 Tab 字元進行縮排，這會導致解析錯誤。同一層級的元素必須具有相同的縮排量。
鍵值對： 映射（字典）由鍵值對組成，格式為 key: value。冒號後面必須有一個空格。
列表： 序列（列表）中的每個項目都以一個連字號和一個空格 (- ) 開頭。
註解： 以 # 字元開頭的行被視為註解，會被解析器忽略。
字串引號： 當字串中包含特殊字元（如 :, {, }, [, ], ,, &, *, #, ?, |, -, <, >, =, !, %, @, `）或者希望明確表示為字串時（例如 'on', 'off', 'true'），建議使用單引號 ' ' 或雙引號 " " 將其括起來。
錨點與別名： 對於重複的資料區塊，可以使用錨點 (&anchor_name) 來標記，然後使用別名 (*anchor_name) 來引用，以提高可讀性和減少冗餘。

電源狀態表示方式比較

下表比較了在不同情境下表示電源狀態的常見 YAML 寫法及其考量：

特性	YAML 表示方式範例	常見平台/情境	注意事項
電源開啟 (字串)	`state: 'on'`	Home Assistant	`'on'` 通常被視為字串，符合 Home Assistant 狀態慣例。
電源關閉 (字串)	`state: 'off'`	Home Assistant	`'off'` 通常被視為字串。
電源開啟 (布林)	`power_enabled: true`	通用腳本, 部分應用程式設定	`true` 是標準的 YAML 布林值。
電源關閉 (布林)	`power_enabled: false`	通用腳本, 部分應用程式設定	`false` 是標準的 YAML 布林值。
監控的實體/裝置	`entity_id: switch.living_room_fan`	Home Assistant	用於指定自動化規則所針對的特定裝置或服務。
觸發條件 (狀態變為)	`trigger: - platform: state to: 'on'`	Home Assistant	定義當受監控實體的狀態變為指定值時觸發。
服務名稱	`action: - service: script.turn_on_heating`	Home Assistant, 自訂服務	指定在觸發條件滿足時要執行的具體服務或腳本。
服務目標/參數	`target: entity_id: climate.thermostat data: temperature: 22`	Home Assistant	為呼叫的服務提供目標實體和額外的參數。

不同 YAML 應用策略的比較

下方的雷達圖比較了幾種使用 YAML 進行電源監控和服務呼叫策略在不同方面的特性。這些評估是基於一般情況，實際效果可能因具體實施和工具而異。

圖表解讀：

可讀性： YAML 本身具有較高可讀性，但整體方案的可讀性也取決於腳本或平台特定語法的複雜度。
功能強度： 自訂腳本通常提供最強大的功能，因為可以完全控制邏輯；平台則提供特定領域的強大功能。
靈活性： 自訂腳本最為靈活，可以適應各種需求；平台提供的靈活性則在其生態系統範圍內。
平台依賴性： Home Assistant 或 Power Fx 等方案高度依賴其平台；自訂腳本的 YAML 設定檔則較為通用，但腳本本身仍有環境依賴。
學習曲線： 簡單的 YAML 易學，但掌握特定平台的自動化語法或編寫複雜腳本則需要更多時間。

視覺化流程：YAML 電源監控與服務呼叫

下方的思維導圖展示了使用 YAML 監控電源狀態並呼叫服務的典型流程：從 YAML 中定義屬性，到監控機制偵測狀態變化，再到觸發相應的服務呼叫。

mindmap root["YAML監控電源與服務呼叫流程"] id1["1. YAML 設定檔定義"] id1_1["定義電源相關屬性
(例如: power_status, entity_id)"] id1_2["指定目標裝置或監控對象"] id1_3["定義狀態值
(例如: 'on', 'off', true, false)"] id1_4["定義服務呼叫參數
(例如: service_name, target_entity)"] id2["2. 監控機制啟動"] id2_1["平台內建監控
(例如: Home Assistant 事件匯流排)"] id2_2["自訂腳本輪詢或監聽"] id2_3["硬體信號/感測器"] id3["3. 電源狀態發生變化"] id3_1["裝置實際電源開啟 (ON)"] id3_2["裝置實際電源關閉 (OFF)"] id3_3["狀態由外部更新至 YAML 或系統"] id4["4. 觸發條件判斷"] id4_1["監控機制偵測到狀態變化"] id4_2["比對 YAML 中定義的觸發條件
(例如: state == 'on')"] id5["5. 服務呼叫執行"] id5_1["若條件滿足，執行預定義動作"] id5_2["呼叫指定的服務
(例如: switch.turn_on, notify.send_message)"] id5_3["傳遞 YAML 中設定的參數給服務"] id5_4["執行自訂腳本或 API 請求"] id6["(回饋/記錄)"] id6_1["(選擇性) 記錄操作日誌"] id6_2["(選擇性) 更新狀態或提供使用者回饋"]

此思維導圖清晰地展示了從配置到執行的完整鏈路，突顯了 YAML 在整個自動化流程中的核心配置作用。

相關影片：Home Assistant 全屋能源監控

以下影片展示了 Home Assistant 在全屋能源監控方面的應用，雖然不完全是關於 YAML 語法教學，但它展示了類似本文討論的電源監控概念在實際智慧家庭中的強大功能。您可以從中了解如何整合各種裝置並利用 Home Assistant 的能力來追蹤和管理能源使用，而這些自動化和整合的背後，許多都是透過 YAML 設定來驅動的。

這類系統通常允許使用者透過 YAML 或圖形化介面設定複雜的自動化規則，例如：當特定裝置的功耗超過某個閾值時（表示已開啟並運行），觸發一個通知；或者，當主要電源關閉時，自動關閉所有非必要的智慧插座以節省能源。

常見問題 (FAQ)

YAML 中的 on/off 一定是布林值嗎？

不一定。根據 YAML 1.2 規範，未加引號的 on 和 off 通常被解析為字串，而不是布林值 true 和 false。如果您需要它們被明確視為布林值，應該直接使用 true 或 false。在某些特定平台（如舊版 Home Assistant 或特定解析器設定）中，它們可能被非標準地轉換為布林值，但最佳實踐是明確使用標準布林關鍵字或用引號將 'on'/'off' 標示為字串，以避免混淆。

如何確保我的 YAML 縮排正確？

YAML 對縮排極為敏感，因為縮排定義了資料的層次結構。請遵循以下原則：

使用空格，而非 Tab： 這是最重要的規則。Tab 字元在不同編輯器中寬度可能不同，會導致 YAML 解析錯誤。
保持一致性： 同一層級的元素必須有完全相同的縮排空格數。常見的縮排是2個或4個空格。
使用好的編輯器： 許多文字編輯器（如 VS Code, Sublime Text, Atom）都有 YAML 語法高亮和自動縮排輔助功能，有些還能即時檢測縮排錯誤。
利用線上驗證工具： 在部署或執行前，可以使用 YAML Lint 或 Online YAML Parser 等工具來檢查語法和縮排是否正確。

除了 Home Assistant，YAML 還能用在哪些地方監控電源狀態？

雖然 Home Assistant 是個典型例子，但 YAML 的應用遠不止於此：

自訂應用程式： 您可以開發自己的應用程式（例如使用 Python, Node.js, Java），將電源狀態等設定儲存在 YAML 檔案中，程式讀取這些設定來控制硬體或執行邏輯。
物聯網 (IoT) 平台： 一些 IoT 平台或框架可能允許使用 YAML 來定義裝置行為、規則或裝置描述檔案 (device twin) 中的屬性，包括電源狀態。
系統管理與自動化工具： 如 Ansible，雖然主要用於 IT 自動化，但其 Playbook 也使用 YAML。如果管理的是帶有電源控制介面的伺服器或裝置，理論上可以編寫 Playbook 來監控和操作。
Microsoft Power Platform： 如 Power Apps，可以使用 YAML (結合 Power Fx) 來定義元件屬性和行為，這可以間接用於表示和響應 UI 元素模擬的「電源」狀態。
雲端設定： 例如 AWS CloudFormation 或 Azure Resource Manager (ARM) 模板（雖然 ARM 主要用 JSON，但概念相似），YAML 也被用於定義基礎設施資源，其中可能包括具有電源管理功能的虛擬機器或服務。

核心思想是：任何能夠解析 YAML 檔案並與硬體或軟體服務互動的系統，都可以利用 YAML 來管理和響應電源狀態的變化。

「呼叫服務 (service call)」具體是什麼意思？

「呼叫服務」(Service Call) 是一個廣泛的術語，指的是請求某個已定義的功能或程序執行一個特定的操作。在本文討論的 YAML 電源監控情境下，它可以指：

在 Home Assistant 中： 呼叫一個內建或自訂的服務，如 light.turn_on（開啟燈光）、notify.mobile_app_john（發送通知給 John 的手機 App）、script.run_cleanup（執行一個名為 run_cleanup 的腳本）。每個服務都有特定的域名 (domain, 如 light) 和服務名稱 (service name, 如 turn_on)，並且通常可以接受參數 (如 entity_id, brightness)。
在自訂腳本中： 可能意味著執行一個函式、啟動一個子程序 (subprocess)、發送一個 HTTP API 請求到遠端伺服器、向硬體裝置發送一個命令，或與資料庫互動等。例如，Python 腳本中呼叫一個 send_email() 函式，或執行一個 shell 命令 /usr/local/bin/restart_service.sh。
在 Microsoft Power Fx 中： 可能指執行一個 Power Fx 公式，該公式觸發了某個連接器 (Connector) 的動作，例如向 SharePoint列表寫入資料，或呼叫一個 Power Automate 流程。