Instalace a použití

Tento průvodce vysvětluje, jak zprovoznit kartu Dreame Vacuum na hlavním panelu Home Assistant. Pokrývá předpoklady pro integraci, kroky k přidání karty na stávající panely a pokyny pro nastavení doporučeného režimu Panel. Režim Panel poskytuje nejlepší možný zážitek využitím celé obrazovky, což je obzvlášť výkonné na tabletech a stolních monitorech.

---

Dreame Vacuum Card je úzce integrována jako hlavní součást Integrace Dreame Vacuum Home Assistant. Není sama o sobě samostatnou kartou, která by se instalovala zvlášť.

Chcete-li tuto kartu používat, musí být nainstalována dreame_vacuumverze integrace v2.0.0 nebo vyšší, která kartu obsahuje.

Předpoklad

Pokud je integrace Dreame Vacuum již nainstalována, tento krok lze bezpečně přeskočit.

Pokud není ještě nainstalován, nejjednodušší způsob, jak jej získat, je přes HACS. Integrace Dreame Vacuum může být vyhledána pod HACS > Integrations a stažena verze v2.0.0 nebo vyšší. Po stažení je nutné restartovat Home Assistant. Jakmile je integrace nastavena, karta bude automaticky dostupná na dashboardech.

Optimalizace entit

Karta je navržena tak, aby fungovala pouze s entitami vacuum, sensor.cleaning_history, sensor.cruising_history a camera.map. Vše, co potřebuje, získává přímo z těchto čtyř základních entit. V důsledku toho mohou být všechny ostatní entity ze stránky zařízení, včetně entit uložených map, bezpečně deaktivovány, aby zůstal Home Assistant čistý.

Pro další snížení zatížení instance Home Assistantu vypnutím generování obrázků na straně serveru lze entitu camera.map deaktivovat a místo ní povolit entitu camera.map_data. Karta toto automaticky rozpozná a zobrazí všechny mapy přímo v prohlížeči. Minimálně může karta fungovat pouze s povolenou entitou vacuum. I když mapa v tomto stavu nebude kreslena, všechny nepřímé funkce mapy, jako jsou nastavení čištění, akce dokovací stanice a základní ovládání, zůstanou plně přístupné a použitelné.

Přidání karty na váš Dashboard

Chcete-li přidat Dreame Vacuum Card na dashboard Home Assistanta:

1. Otevře se Home Assistant a přejde se na požadovaný dashboard.
2. Klikne se na ikonu Upravit dashboard () v pravém horním rohu.
3. Klikne se na tlačítko Přidat kartu () v pravém dolním rohu.
4. V výběru karet se vyhledá a vybere Vlastní: Dreame Vacuum Card.
5. V editoru karet je vybrána entita Dreame Vacuum Entity, například vacuum.l10s_gen2.
6. Klikněte na Uložit pro přidání karty na dashboard.

Použití Panelového režimu (doporučeno)

Pro nejlepší uživatelský zážitek, zejména vzhledem k rozsáhlému editoru map a funkcím karty Dreame Vacuum, se důrazně doporučuje použít Panelový režim v Home Assistant. Panelový režim umožňuje jedné kartě zabírat celou obrazovku v zobrazení dashboardu.

Karta automaticky rozpozná, kdy je umístěna v panelovém zobrazení, a odstraní svou barvu pozadí a vnější okraje, aby se hladce sloučila s tématem dashboardu. Dále jsou všechny interní prvky UI plně připravené na panel a přizpůsobí své rozvržení tak, aby využily rozšířený prostor obrazovky.

Nastavení zobrazení jediné karty v panelu

1. Požadovaný přehled je otevřen a v pravém horním rohu je kliknuto na ikonu Upravit přehled ().
2. Vedle záložek pohledů přehledu nahoře je kliknuto na ikonu Přidat pohled ().
3. V dialogu "Přidat pohled" je pod rozbalovací nabídkou Rozvržení vybrána možnost Panel, tedy jedna karta.
4. Volitelně je zadán Název, například "Vysavač", a Ikona, například mdi:robot-vacuum.
5. Klikne se na Uložit.
6. Klikne se na tlačítko Přidat kartu () v pravém dolním rohu.
7. V výběru karet se vyhledá a vybere Vlastní: Dreame Vacuum Card.
8. V editoru karet je vybrána entita Dreame Vacuum Entity, například vacuum.l10s_gen2.
9. Klikněte na Uložit pro přidání karty na dashboard.

Nativní navigace v prohlížeči

Když se používá v režimu panelu nebo je-li jedinou kartou v pohledu, karta nativně zpracovává navigaci v prohlížeči. Fyzické tlačítko Zpět na zařízení nebo gesta přejetí mohou být použity k zavírání dialogů, zavrhování menu nebo návratu zpět a fungují přesně jako vlastní tlačítko zpět karty. To je zvláště užitečné na mobilních zařízeních. Aby byla zajištěna stabilní uživatelská zkušenost, karta zachycuje pouze akce "zpět" a nezpracovává navigaci "vpřed".