約一小時，打造 Home Assistant 投影機儀表板

• Projector Pilot 已與 Home Assistant 連結。設定指南涵蓋了登入與開啟傳送投影機狀態。在其上建立任何內容之前，您應該先在 Home Assistant 中看到您的投影機以感測器形式出現。
• 您至少已同步過一次。設定 › 居家自動化 › Home Assistant › 與 HA 同步，且已先將 App 的複製區塊貼入 configuration.yaml 並重新啟動 Home Assistant。這一步會建立下方每顆控制按鈕所呼叫的指令碼。
• 建置期間請保持投影機開機。下方的畫質屬性在投影機待機時大多是空白的。

這個儀表板由兩個來源提供資料，下面每個步驟都會用到兩者的差異。

這四張都在 HACS 預設商店中。在 Home Assistant 中：HACS › 前端 › 探索 & 下載儲存庫，搜尋名稱、按下載，然後重新載入瀏覽器。

本頁的每段程式碼都會用到兩個預留位置。只要找出一次，其餘都是複製貼上。

• sensor.YOUR_PROJECTOR → 在 Home Assistant 的開發者工具 › 狀態中，以 projector_pilot 篩選。結果會類似 sensor.projector_pilot_epson_qb1000b_qb1000w。
• YOURSERIAL → 開啟 App，進入設定 › 居家自動化 › Home Assistant。由序號衍生的 ID 就顯示在那裡，也是每個同步指令碼名稱的中間部分：script.projpilot_YOURSERIAL_power_on、script.projpilot_YOURSERIAL_input_hdmi1 等。

完成步驟 1 的複製區塊與同步後，您也可以在開發者工具 › 狀態中以 projpilot 篩選，一次看到完整的同步控制清單。

1. 設定 › 儀表板 › 新增儀表板 › 從頭開始建立新儀表板。取名為 Projector Pilot。
2. 開啟它，再點選右上角的鉛筆圖示進行編輯。
3. 新增一個檢視。兩種版面配置都可以；實際使用的面板採用預設的卡片堆疊，也就是一張接一張往下排，最容易貼上。
4. 若要貼上 YAML，請使用卡片上的三點選單並選擇在 YAML 中編輯，或使用儀表板上的三點選單選擇原始設定編輯器，一次貼上整個檢視。

檢視本身的設定，如果您想自己輸入：

title: Projector Pilot
views:
- title: Projector Pilot
  path: projector-pilot
  icon: mdi:projector
  cards: []

先從只讀取資料的項目開始，這樣在動手傳送任何指令之前，就能確認您的實體 ID 正確。這個方塊在投影機感測器存在的那一刻就是即時的，不需要複製區塊，也不用同步。新增卡片，在 YAML 中編輯，然後貼上：

type: custom:mushroom-template-card
primary: Brightness
secondary: '{{ state_attr(''sensor.YOUR_PROJECTOR'',''brightness'') }}'
icon: mdi:brightness-6
icon_color: green
layout: vertical
fill_container: true
card_mod:
  style: 'ha-card { background: rgba(18,26,20,0.60); border: 1px solid rgba(61,220,107,0.20);
    border-radius: 16px; box-shadow: 0 6px 22px rgba(0,0,0,0.32); backdrop-filter: blur(8px);
    min-height: 104px; }'

同樣的寫法可以讀取感測器所帶的約 80 個屬性中的任何一個：把 brightness 換成 contrast、gamma、color_temp、hdr_pq、lamp_hours，或任何您想放在方塊上的屬性。

儲存它。如果出現真實的數字或文字，就代表您的實體 ID 正確，下方所有內容都能運作。如果顯示空白，請回到步驟 2。

單純的標題只是浪費空間。這是一張 markdown 卡片，搭配 card-mod 的漸層背景，它能讓一堆方塊變成有名稱的區段。面板上的每個區段都以這樣的卡片開頭，只是標籤與表情符號不同。

type: markdown
content: '🔌    **POWER & SOURCE**'
card_mod:
  style: 'ha-card { background: linear-gradient(135deg, rgba(61,220,107,0.30), rgba(16,120,60,0.30));
    border: 1px solid rgba(61,220,107,0.45); border-radius: 14px; box-shadow: 0 6px 20px rgba(0,0,0,0.3); }
    ha-markdown { padding: 12px 20px !important; } ha-markdown p { margin: 0 !important;
    letter-spacing: 3px; color: #eafff0; font-size: 14px; font-weight: 700; }'

更改表情符號代碼與標籤文字即可；card-mod 區塊在每個區段都完全相同。

這顆按鈕是傳送指令，而不只是讀取數值，因此必須先有指令碼存在。它會呼叫 script.projpilot_YOURSERIAL_power_on，而這個指令碼是在您把 App 的複製區塊貼入 configuration.yaml、重新啟動 Home Assistant 並點選與 HA 同步之後，才由 App 寫入的。

type: custom:mushroom-template-card
primary: Power On
icon: mdi:power
icon_color: green
layout: vertical
fill_container: true
tap_action:
  action: call-service
  service: script.projpilot_YOURSERIAL_power_on
card_mod:
  style: 'ha-card { background: linear-gradient(135deg, rgba(61,220,107,0.16), rgba(16,90,46,0.20));
    border: 1px solid rgba(61,220,107,0.34); border-radius: 16px; box-shadow: 0 6px 22px rgba(0,0,0,0.32);
    min-height: 92px; }'

同一張卡片也能用於關機、螢幕遮蔽、HDMI 1、HDMI 2、A/V 靜音、某個色彩模式或鏡頭記憶：只要更改標籤、圖示與 service 即可。

面板頂端的主視覺區塊是一個 button-card：顯示大大的電源狀態、一行由多個屬性組成的摘要，並讓整張卡片都有綠色玻璃質感，而不只是邊框。

type: custom:button-card
entity: sensor.YOUR_PROJECTOR
name: Epson QB1000
show_state: true
show_label: true
size: 48px
state_display: '[[[ return entity.state==''on'' ? ''Powered on'' : ''Standby''; ]]]'
label: '[[[ var a=entity.attributes; return (a.input||''-'')+''  •  ''+(a.color_mode||''-'')+
  ''  •  ''+(a.video_range||''-'')+''  •  ''+(a.lamp_hours||0)+''  h''; ]]]'
styles:
  card:
  - height: 176px
  - background: linear-gradient(135deg, rgba(61,220,107,0.32), rgba(11,64,34,0.6))
  - border: 1px solid rgba(61,220,107,0.5)
  - border-radius: 22px
  - box-shadow: 0 12px 36px rgba(0,0,0,0.42)
  - padding: 20px
  state:
  - color: '[[[ return entity.state==''on'' ? ''#3ddc6b'' : ''#8a9'' ]]]'

這裡只保留每次安裝會不同的部分。完整的卡片還會設定圖示、名稱與標籤的格線位置；全部內容請見步驟 10 的下載檔。

偏好更精簡的橫條嗎？mushroom-chips-card 可以用一排小標籤完成相同的工作：電源狀態、輸入、色彩模式、視訊範圍與燈泡使用時數，每個都是讀取 state_attr('sensor.YOUR_PROJECTOR', ...) 的範本。面板頂端請擇一使用，不要兩者並用。

您在 App 中儲存的每個場景，在同步後都會成為名為 script.projpilot_YOURSERIAL_scene_<id> 的指令碼，而對應的方塊就是步驟 6 的控制按鈕卡片，只要換上場景名稱與圖示。

type: custom:mushroom-template-card
primary: Movie Night
icon: mdi:movie-open
icon_color: green
layout: vertical
fill_container: true
tap_action:
  action: call-service
  service: script.projpilot_YOURSERIAL_scene_YOURSCENE1
card_mod:
  style: 'ha-card { background: linear-gradient(135deg, rgba(61,220,107,0.16), rgba(16,90,46,0.20));
    border: 1px solid rgba(61,220,107,0.34); border-radius: 16px; box-shadow: 0 6px 22px rgba(0,0,0,0.32);
    min-height: 92px; }'

把 YOURSCENE1 換成 App 同步控制清單中該場景所顯示的 ID。每個場景一個方塊，放在 horizontal-stack 裡。

Home Assistant 會像記錄其他感測器一樣記錄投影機感測器，因此 lamp_hours 自然就有歷程可用。不需額外的感測器、不需輔助實體，也不用事先設定，放在維護區段下即可。

type: custom:mini-graph-card
entities:
- entity: sensor.YOUR_PROJECTOR
  attribute: lamp_hours
  name: Laser hours
name: Laser hours
icon: mdi:lightbulb-on-outline
line_color: '#3ddc6b'
line_width: 4
hours_to_show: 336
points_per_hour: 0.5
height: 96
animate: true
card_mod:
  style: 'ha-card { background: rgba(18,26,20,0.60); border: 1px solid rgba(61,220,107,0.20);
    border-radius: 16px; box-shadow: 0 6px 22px rgba(0,0,0,0.32); backdrop-filter: blur(8px); }'

336 小時就是兩週。雷射與燈泡使用時數會穩定上升，而不會忽高忽低，因此兩週的視窗通常足以看出趨勢，圖表也不會顯得平坦。

完整的檢視，包含本頁頂端截圖中的每個區段與每張卡片，並以預留位置取代實體 ID。

1. 下載檢視 YAML。
2. 用任何文字編輯器開啟，並在所有出現的地方替換：把 YOUR_PROJECTOR 換成步驟 2 中您的投影機感測器實體 ID，把 YOURSERIAL 換成步驟 2 中由序號衍生的 ID。
3. 在靠近底部的場景區段，把 YOURSCENE1、YOURSCENE2 與 YOURSCENE3 換成您自己的三個場景 ID，或依實際場景數量新增、移除方塊。
4. 在 Home Assistant 中開啟您的儀表板，點選鉛筆圖示與三點選單，選擇原始設定編輯器，並以檢視的形式貼上。