獨立行動應用儀表板

您可以透過為 Dreame 吸塵卡建立專屬儀表板，並將其直接添加到手機主畫面並設置專屬應用圖示，來在行動裝置上創建一個類似「應用程式」的體驗。

步驟 1：建立新儀表板

為了保持整潔並全螢幕顯示，強烈建議專門為吸塵器建立一個完全獨立的儀表板。

1. 在 Home Assistant 中，進入 設定 > 儀表板 菜單。
2. 點擊右下角的 新增儀表板 按鈕。
3. 選擇 從零開始建立新儀表板。
4. 提供 標題（例如「L10s Gen2」）、圖示（例如 mdi:robot-vacuum）和 URL（例如 l10s-gen2）。
5. 選填項目：此儀表板可以新增到側邊選單或保持隱藏，因為它將直接從手機主畫面啟動。
6. 點擊 建立。

步驟 2：設置面板視圖

「面板」視圖會強制單張卡片橫跨整個畫面，非常適合這張高度詳細的地圖卡片。

1. 新建立的儀表板已打開。
2. 點擊右上角的 編輯儀表板 () 圖標。
3. 現代 Home Assistant 初始會建立一個 sections 類型的視圖，無法轉換成面板。點擊預設標籤旁的 編輯 () 圖示，從對話框中選擇 刪除視圖 並確認移除。
4. 點擊儀表板視圖標籤上方的 新增視圖 () 圖標。
5. 在「新增視圖」對話框中，選擇 面板，單卡選項，位於 佈局 下拉選單中。
6. 點擊 儲存。
7. 點擊右下角的 添加卡片 () 按鈕。
8. 在卡片選擇器中，搜尋並選擇 自訂：Dreame 真空卡片。
9. 在卡片編輯器中，選擇 Dreame 吸塵器的 實體，例如 vacuum.l10s_gen2。可以提供卡片的可選自訂 標題，並可參考 基本配置 部分設置更多針對行動裝置的詳細配置。
10. 點擊 保存 將卡片新增到儀表板。

步驟 3：隱藏標頭和側邊欄（攤位模式）

注意

這個步驟完全是可選的，但對於實現像原生應用程式般的體驗卻是絕對必要的。

為了讓它看起來像真正的獨立應用程式，必須隱藏 Home Assistant 的頂部標頭和側邊選單。

由於原本的自助服務模式插件已被存檔，社群現在維護一個積極支援的分支。強烈建議使用 NemesisRE/kiosk-mode 整合。

透過 HACS 安裝

1. 前往 HACS > 前端 區段。
2. 點擊右上角的 更多選單 ()，並選擇 自訂資源庫。
3. 將 https://github.com/NemesisRE/kiosk-mode 新增，類別設為 Lovelace。
4. 點擊 下載 以安裝整合。
5. 如果出現提示，請重新載入瀏覽器。

配置

安裝完成後，可編輯原始儀表板配置以完全隱藏 UI 元素。

1. 新建立的儀表板已打開。
2. 點擊右上角的 編輯儀表板 () 圖標。
3. 點擊右上角的 圖示，並選擇 原始配置編輯器。
4. 將以下行新增到配置的最頂部:

kiosk_mode:
  kiosk: true

提示

一旦標題被隱藏，編輯按鈕將不再可見。如果需要編輯卡片配置，?edit=1 可以簡單地添加到網頁瀏覽器儀表板 URL 的末尾，例如 http://homeassistant.local:8123/l10s-gen2?edit=1.

第4步：添加到手機主畫面

一旦全螢幕、無標題的儀表板準備好，就可以將其添加到移動設備作為專用主畫面捷徑。啟動此捷徑會立即打開全螢幕 Dreame 吸塵器控制面板，完全跳過正常的 Home Assistant 介面，且立即加載。返回按鈕的功能與官方 App 完全相同，可用於返回或關閉設定和對話框。

Android

必須從 Google Play 商店 下載官方 Home Assistant Companion App。

1. Home Assistant Companion App 已在手機設備上打開。
2. 對於首次使用者，初始設定是透過輸入 Home Assistant 伺服器 URL 並使用適當的憑證登入來完成。應用程式必須完全加載，直到正常的儀表板可見。
3. 打開側邊選單並進入 設定 > 夥伴應用程式。
4. 找到 捷徑（管理捷徑） 區段。
5. 從可用捷徑槽清單中，選擇未使用的槽，例如 捷徑 1。
6. 配置捷徑詳細資訊：
   • 標籤：提供捷徑在主畫面上的名稱，例如 "L10s Gen2"。
   • 描述：可以輸入可選的描述。
   • 伺服器：選擇目前活動的 Home Assistant 伺服器。
   • 捷徑類型：從可用選項中選擇 儀表板。
   • 儀表板：輸入新建立儀表板的確切 URL 路徑，例如 /l10s-gen2。
   • 圖示：選擇相關圖示，例如 mdi:robot-vacuum。
7. 新增快捷方式按鈕已被點擊。
8. 裝置可能會提示確認以新增該快捷方式。
9. 完全退出 Companion App，然後在主畫面上點擊新建立的 "L10s Gen2" 快捷方式。

注意

有關管理 Android 快捷方式的更多詳情，請參考官方文件 Home Assistant Companion App Android 快捷方式文件.

iOS

官方的 Home Assistant Companion App 必須從 Apple App Store 下載。在 iOS 裝置上，內建的 Apple 快捷指令 應用程式會與 Home Assistant URL 方案一起使用來建立主畫面圖示。

1. 在 iPhone 或 iPad 上打開 快捷指令 應用程式。
2. 點擊右上角的 新增快捷方式 () 按鈕。
3. 選擇 新增動作，然後搜尋並選擇 開啟 URL。
4. 在動作中輸入儀表板的深層連結 URL。它必須以 homeassistant://navigate 開頭，接著是儀表板路徑，例如 homeassistant://navigate/l10s-gen2。
5. 捷徑的名稱可以透過點擊上方的向下箭頭並選擇 重新命名 來設定，然後輸入像是 "L10s Gen2" 的名稱。
6. 圖示可以從同一個選單中自訂，方法是選擇 選擇圖示。
7. 點擊 分享 圖示，並選擇 加入主畫面。
8. 點擊 加入 以確認。
9. 點擊新建立在主畫面上的 "L10s Gen2" 捷徑。

注意

有關 iOS URL 方案的更多詳細資訊，請參閱官方文件。 Home Assistant URL Handler 文件.