設定

このセクションでは、Dreame Vacuum Cardをセットアップして起動するための基本オプションについて説明します。掃除機エンティティの接続方法や、主要なビジュアルおよびインタラクション設定のカスタマイズ方法が詳しく記載されています。

最小構成 (entity)

このカードは、entity パラメータだけで機能し、他の設定は不要です。これは掃除機の主要な Home Assistant エンティティを定義し、vacuum.l10s_gen2 のような dreame_vacuum インテグレーションに属している必要があります。この単一のパラメータに基づいて、デバイスの機能を自動的に検出します。

type: custom:dreame-vacuum-card
entity: vacuum.l10s_gen2

基本設定

次のパラメータを使用して、マップのビジュアルスタイルやインタラクションモードを変更できます。

type: custom:dreame-vacuum-card
entity: vacuum.l10s_gen2
title: First Floor Vacuum
color_scheme: dreame_auto
icon_set: material
map_display: floor_plan
locked: only_touch

タイトル (title)

カード上部の任意のカスタムタイトルです。デフォルトでは、Home Assistant から取得したデバイスのフレンドリ名が表示されます。

タイトルの非表示

必要に応じて、カードタイトルは hidden_card_objects 設定パラメータを使用して完全に無効にできます。タイトルが非表示の場合、カードの上部には掃除機の現在の状態が表示されます。

マップカラースキーム（color_scheme)

部屋、通路、壁などマップ上のさまざまな要素に適用されるカラーパレットを定義します。

デフォルト値

このパラメータが設定で提供されていない場合、統合設定で選択されたカラースキームがデフォルトになります。

• Dreame Light (dreame_light)：公式Dreameアプリのテーマ。
• Dreame Dark (dreame_dark)：dreame_vacuum統合専用のダークテーマ。
• Dreame Auto (dreame_auto)：システムテーマに基づきdreame_lightとdreame_darkを自動で切り替えます。
• Mijia Light (mijia_light)：公式Xiaomi Mi Homeアプリのライトテーマ。
• Mijia Dark (mijia_dark)：公式Xiaomi Mi Homeアプリのダークテーマ。
• Mijia Auto (mijia_auto)：システムテーマに基づきmijia_lightとmijia_darkを自動で切り替えます。
• グレースケール (grayscale)：無彩色のモノクロマップテーマ。

色の上書き

事前定義されたカラースキームがニーズに合わない場合は、override_colors設定パラメータを使用して個々の色を完全にカスタマイズできます。

マップアイコンセット(icon_set)

地図上に直接表示されるアイコン（充電器や部屋のアイコンを含む）の美的スタイルを制御します。

デフォルト値

このパラメータが設定に含まれていない場合、統合設定で選択されたアイコンセットがデフォルトとして使用されます。

• Dreame (dreame): 公式Dreameアプリのアイコンセット。
• Dreame Old (dreame_old): 旧Dreameアプリのアイコンセット。
• Mijia (mijia): 公式Xiaomi Mi Homeアプリのアイコンセット。
• Material (material): HA内蔵のMaterial Designアイコン。

アイコンの非表示

利用可能なアイコンセットが視覚的な好みに合わない場合、特定のアイコンの地図上での表示をhidden_objects設定パラメータを使って完全にオフにすることができます。

地図表示(map_display)

地図の表示スタイルを制御し、ロボットがスキャンした地図、編集可能な物理的な壁や床のテクスチャの表示可否を決定します。

対応デバイスでのみ利用可能

フロアプラン表示モードは、公式アプリで3Dマップ表示v2以上をサポートするデバイスでのみ使用可能です。この機能をサポートしていない古いデバイスでは、これらの特定の設定プロパティは無効になるか、効果がありません。これは、マップデータに表示可能な壁やドアの情報が含まれないためです。

サポートされていないデバイスの場合、類似した2Dまたは3Dのフロアプラン表示効果を得るために、背景画像設定パラメータの使用を強く推奨します。

標準 (standard)

ロボットによってスキャンされたマップビューをそのまま表示します。

フロアプラン (floor_plan)

ロボットがスキャンしたマップビューと編集可能な物理的な壁の表示を組み合わせます。

テクスチャなしフロアプラン (floor_plan_without_texture)

floor_planと同じですが、壁内部の未スキャン領域のテクスチャを非表示にし、部屋の床材全体を表示します。

フロアプランのみ (floor_plan_only)

floor_plan_without_textureと同じですが、スキャンしたマップビューを完全に非表示にし、壁と内部の床のみを表示します。このビューは、マップを自動的にトリミングおよびセンタリングする際に非常に便利です。

プレビュー

標準

間取り

テクスチャなしの間取り

間取りのみ

編集可能な壁

フロアプランモードで表示される物理的な壁と境界線は完全に編集可能です。調整方法の詳細については、マップ管理の壁セクションを参照してください。

カードロックモード（locked)

この設定は、カード内のマップのパンおよびズームをロックするために使用されます。タッチやマウスホイールでダッシュボードをスクロールする際に、マップのパンによってページスクロールが妨げられるのを防ぎます。初期値はautoです。この仕組みは、次のオプションに従って設定できます。

マップのリセットとロック

マップが初期リセット位置にない場合、カードは設定されたロックモードに関係なく完全にアンロックされたままになります。マップを再びロックするには、マップを初期ビューに戻すためにダブルクリックまたはダブルタップを行う必要があります。

さらに、設定されたロックモードに関係なく、特定の部屋をダブルクリックまたはダブルタップしてズームインすることで、マップを常にアンロックできます。

自動（auto)

カードは自身がスクロール可能なコントロール内にあるかを検知し、それに応じて動的にマップをロックします。

• マウス操作：マウスがカード上でアクティブに移動するまで、マップはロックされたままです。ページスクロール中にマップ上にマウスが移動していない場合、マップはロックされたままです。ダブルクリックによりマップビューがリセットされると、マップは直ちに再ロックされ、マウスが動かされない限り、リセット直後にページのスクロールが可能になります。
• タッチ操作: マップは最初はロックされています。マップのロックを解除するには、touch_lock構成設定で定義された時間だけタッチして保持する必要があります。即座にスワイプするとダッシュボードページがスクロールされ、短く保持するとマップのパン操作が可能になり、インジケーターが表示されます。さらに、二本指でのパンや二本指でのズーム、ダブルタップでのズームを行うと、マップは即座にロック解除されます。これらのタッチ操作でロック解除された後は、ビューがダブルタップでリセットされるまでマップはロック解除されたままです。

タッチ専用 (only_touch)

シングルタッチでのパン操作中のみマップはロックされ、マウスホイールのスクロールは制限されません。二本指でのパンやズームを行うと、ビューがダブルタップでリセットされるまでマップはロック解除されます。このモードは、頻繁にパン操作を行う必要がない場合に推奨されます。

無効 (never)

マップは決してロックされず、ページのスクロールは常にブロックされます。

常に (always)

地図はすべての場所で強制的にロックされています。手動でのズームやパンは最初は無効ですが、ダブルタップまたはダブルクリックによるズームは引き続き利用可能です。ダブルタップまたはダブルクリックでズームすると、次のダブルタップまたはダブルクリックでビューをリセットするまで、地図はパン操作が可能になります。