インストールと使用方法
このガイドでは、Dreame VacuumカードをHome Assistantダッシュボードで動作させる方法について説明します。統合の前提条件、既存のダッシュボードにカードを追加する手順、および推奨されるパネルモードの設定方法について解説します。パネルモードは画面全体を活用することで、特にタブレットやデスクトップモニターでの体験を最大限に引き出します。
Dreame Vacuumカードは、Dreame Vacuum Home Assistant統合のコア部分として緊密に統合されています。これは、単体でインストールされるカードではありません。
このカードを使用するには、カードが組み込まれたdreame_vacuum統合バージョンv2.0.0以上をインストールする必要があります。
前提条件
もしDreame Vacuum統合が既にインストールされている場合、このステップは安全に無視できます。
まだインストールされていない場合、最も簡単な方法は HACS から入手することです。Dreame Vacuum の統合は HACS > Integrations で検索でき、バージョン v2.0.0 以上をダウンロードできます。ダウンロード後は Home Assistant を再起動する必要があります。統合が設定されると、カードはダッシュボードで自動的に利用可能になります。
エンティティの最適化
このカードは vacuum、sensor.cleaning_history、sensor.cruising_history、camera.map のエンティティのみを使用して動作するように設計されています。必要な情報はこれら4つのコアエンティティから直接取得されます。その結果、保存されたマップエンティティを含むデバイスページ上の他のすべてのエンティティは、Home Assistant をクリーンに保つために安全に無効化できます。
サーバーサイドの画像生成をオフにすることでHome Assistantの負荷をさらに軽減するために、camera.mapエンティティを無効化し、代わりにcamera.map_dataエンティティを有効化できます。カードはこれを自動的に検出し、すべての地図をブラウザ内で直接表示します。最低限、vacuumエンティティだけを有効にしてもカードは機能します。この状態では地図は描画されませんが、掃除設定、ドック操作、基本操作など、地図に関連しないすべての機能は引き続き完全にアクセス可能で使用可能です。
ダッシュボードへのカードの追加
Dreame Vacuum CardをHome Assistantのダッシュボードに追加するには：
- Home Assistantを開き、希望のダッシュボードに移動します。
- 右上のダッシュボードを編集（）アイコンをクリックします。
- 右下のカードを追加（）ボタンをクリックします。
- カードピッカーでカスタム: Dreame Vacuum Cardを検索して選択します。
- カードエディターでは、Dreame Vacuum エンティティ（例:
vacuum.l10s_gen2）が選択されます。 - 保存をクリックして、カードをダッシュボードに追加します。
パネルモードの使用（推奨）
Dreame Vacuum カードの広範なマップエディターや機能を考慮すると、Home Assistant の パネルモード の使用が強く推奨されます。パネルモードでは、1枚のカードがダッシュボードビュー全体を占有できます。
カードは自動的にパネルビューに配置されたことを検出し、背景色と外枠を取り除いてダッシュボードのテーマとシームレスに統合されます。さらに、すべての内部UI要素は完全にパネルに対応しており、拡張された画面スペースを活用するためにレイアウトが適応します。
単一カードパネルビュー設定
- 目的のダッシュボードを開き、右上の ダッシュボードを編集 () アイコンをクリックします。
- ダッシュボードビュータブの横にある ビューを追加 () アイコンをクリックします。
- 「ビューを追加」ダイアログで、パネル、単一カードのオプションを レイアウト ドロップダウンから選択します。
- 任意で タイトル（例：「掃除機」）および アイコン（例：
mdi:robot-vacuum）を指定します。 - 保存 をクリックします。
- 右下のカードを追加（）ボタンをクリックします。
- カードピッカーでカスタム: Dreame Vacuum Cardを検索して選択します。
- カードエディターでは、Dreame Vacuum エンティティ（例:
vacuum.l10s_gen2）が選択されます。 - 保存をクリックして、カードをダッシュボードに追加します。
ネイティブブラウザナビゲーション
パネルモードで使用する場合、またはビュー内で唯一のカードである場合、カードはブラウザナビゲーションをネイティブに処理します。デバイスの物理的な 戻るボタン やスワイプ操作で、ダイアログを閉じたり、メニューを閉じたり、前の画面に戻ったりでき、カード自身の戻るボタンと同じように動作します。これは特にモバイルデバイスで便利です。安定したユーザー体験を維持するために、カードは「戻る」操作のみを傍受し、「進む」ナビゲーションは処理しません。