設定オプション
Home Assistantでは、正常に構成された各ロボット掃除機は、個別の統合エントリとして保存されます。それに対応するデバイスが自動的に作成され、このエントリにリンクされ、掃除機のエンティティ、サービス、およびマップデータを公開します。構成オプションを使用すると、デバイスごとの設定にアクセスでき、それぞれの統合エントリの動作を独立してカスタマイズできます。
これらの設定は、選択した接続タイプの構成を完了した後、デバイスがHome Assistantに追加される直前の最終ステップとして、初期セットアップ時にすぐにアクセスできます。また、後からいつでもHome Assistantの統合ページで、デバイスカードの右上にある 設定ボタンをクリックすることで変更可能です。
Dreame Vacuum Card キー
オプションのフィールドで、Dreame 掃除機カード ライセンスキー用です。有効なキーが入力されると、統合機能は組み込みカスタムカードを自動的に有効化し、ダッシュボードのカスタムカードの中で利用可能にします。無効なキーが入力された場合、カードはダッシュボードでプレビューモードのままになります。
単一デバイスでの有効化
各ライセンスキーは厳密に1台のデバイスに限定されています。一度キーが有効化されると、その特定のデバイスに永久に紐づけられ、他のデバイスでカードを有効化することはできません。
注意
このフィールドは完全に任意です。空白のままでも、組み込みカスタムカードはダッシュボードに追加可能ですが、プレビューモードで動作します。有効なキーは、プレビューモードのカードのインターフェースから後でいつでも取得できます。
通知
統合機能がこのデバイス向けに作成を認める持続的な通知のカテゴリを選択します。カテゴリのチェックを外すと、基礎となるデバイスイベントが発生しても、そのカテゴリは完全に無効になります。
- クリーンアップ完了 (
cleanup_completed)：クリーン作業が正常に終了するたびに生成されます。 - 消耗品 (
consumable)：消耗品の寿命が短くなっている場合、またはコンポーネントのメンテナンスが必要な場合に生成されます。 - 情報 (
information)：一般的な情報イベントやステータス更新のために生成されます。 - 警告 (
warning)：デバイスがクリア可能なエラーや軽微な問題に直面した場合に生成されます。 - エラー (
error)：デバイスが重大な障害やハードウェアエラーを経験した場合に生成されます。
コンパニオンアプリ
デフォルトでは、永続通知は Home Assistant ダッシュボード内でのみ表示されます。特定の通知デバイスIDが必要なため、モバイルデバイスの Home Assistant Companion アプリに直接プッシュすることはできません。モバイルデバイスでプッシュ通知を受信するには、統合の イベント を監視するか生成された永続通知を監視し、それを特定のモバイルデバイスに転送する カスタム自動化 を作成する必要があります。
マップ表示オプション マップサポート
以下の設定は、すべてマップデータに依存するため、クラウドアカウント（DreameHome、MovaHome、TROUVER、または Xiaomi Home）で構成されたデバイスでのみ利用可能です。
Dreame 掃除機カード
以下の設定は生成されたマップカメラエンティティにのみ適用されます。Dreame 掃除機カード はネイティブに自身のマップを表示し、カラースキーム および アイコンセット を独自に 高度な設定 から上書きすることができます。正方形マップ画像 および 低解像度マップ画像 のオプションはカスタムカードには影響しないため、メモリ節約のために 低解像度マップ画像 を有効にすることを強くおすすめします。
カラースキーム
マップ画像生成時に使用されるカラーパレットを選択します。
- Dreame Light (
dreame_light): 公式Dreameアプリのテーマ。 - Dreame Dark (
dreame_dark):dreame_vacuum統合専用のダークテーマ。 - Mijia Light (
mijia_light): 公式Xiaomi Mi Homeアプリのライトテーマ。 - Mijia Dark (
mijia_dark): 公式Xiaomi Mi Homeアプリのダークテーマ。 - グレースケール (
grayscale): 無彩色の単一色マップテーマ。 - 透明 (
transparent): 床、壁、部屋の塗りつぶしを完全に透明で生成し、カスタム背景の上にマップを重ねる際に便利です。
アイコンセット
ロボット、充電器、家具などのマップマーカーに使用されるアイコンスタイルを選択し、公式アプリのアイコンセットに合わせます。
- Dreame (
dreame): 公式Dreameアプリのアイコンセット。 - Dreame Old (
dreame_old): 旧Dreameアプリのアイコンセット。 - Mijia (
mijia): 公式Xiaomi Mi Homeアプリのアイコンセット。 - Material (
material): Home Assistantの組み込みMaterialデザインアイコン。
隠しマップオブジェクト
生成されるマップ画像から除外するマップ要素を選択します。これはマップを簡素化したり、特定のダッシュボードに不要な情報を隠したりするのに便利です。
利用可能なオブジェクト
- Room Colors (
color): 各部屋の個別カラーの塗りつぶし。 - Room Icons (
icon): 部屋の種類に応じたアイコン。 - Room Names (
name): 部屋名のテキストラベル。 - Room Name Background (
name_background): 部屋名の背後に表示されるカプセル形状の背景とその関連する色。 - 部屋の順序 (
order): 清掃順序を示す番号入りバッジ。 - 部屋の吸引レベル (
suction_level): 部屋に設定された吸引レベルを示すアイコン。 - 部屋の水量 (
water_volume): 部屋に設定された水量を示すアイコン。 - 部屋の清掃回数 (
cleaning_times): 部屋が何回清掃されるかを示すバッジ。 - 部屋の清掃モード (
cleaning_mode): 部屋に設定された清掃モード（掃き掃除、拭き掃除、または両方）を示すアイコン。（対応デバイスのみ） - 部屋のモップモード (
mopping_mode): 部屋に設定されたモップパッドの種類を示すアイコン。（対応デバイスのみ） - 経路 (
path): ロボットが清掃した場所を示す経路。 - 立ち入り禁止ゾーン (
no_go): 制限区域。 - モップ禁止ゾーン (
no_mop): 拭き掃除の制限区域。 - バーチャルウォール (
virtual_wall): ロボットが越えないように追加された仮想の壁。 - バーチャルしきい値 (
pathway): ロボットが慎重に越える必要がある定義済みのしきい値。(対応デバイスのみ) - アクティブエリア (
active_area): ゾーン清掃中に描かれる境界ボックス。 - アクティブポイント (
active_point): 1.5m²の範囲を示すスポット清掃ポイント。 - 充電器アイコン (
charger): ベースステーションのアイコン。 - ロボットアイコン (
robot): ロボット自身を表すアイコン。 - 清掃方向 (
cleaning_direction): 現在ロボットが清掃している方向を示す矢印。 - AI障害物 (
obstacle): 靴や電線などAIが検出した障害物のアイコン。(対応デバイスのみ) - ペット (
pet): ペットとして検出された障害物。(対応デバイスのみ) - カーペットエリア (
carpet): カーペットのテクスチャ。(対応デバイスのみ) - 床材 (
material): 木材やタイルなどの部屋の床材テクスチャ。(対応デバイスのみ) - 低地エリア (
low_lying_area)：ロボットがLiDARスキャナーを下げて入る低地。(対応デバイスのみ) - 家具 (
furniture)：3Dまたは2Dの家具。(対応デバイスのみ) - スロープ (
ramp)：環境に設置されたスロープ。(対応デバイスのみ) - カーテン (
curtain)：カーテン。(対応デバイスのみ) - クルーズポイント (
cruise_point)：操作ポイントに移動。(対応デバイスのみ)
正方形マップ画像
生成されたマップカメラ画像をマップの自然な境界ボックスではなく、1:1の正方形のアスペクト比に強制することができ、正方形画像を想定するダッシュボードレイアウトで役立ちます。
低解像度マップ画像
メモリ使用量を減らし、更新を高速化するために、マップカメラ画像を低解像度で生成します。
メモリ制約
大きなマップを生成するには、かなりの量のメモリが必要になることがあります。デバイスページに移動したときやマップカメラエンティティにアクセスしたときにHome Assistantがクラッシュして再起動する場合、メモリ不足が原因である可能性が高いです。このオプションを有効にすると、通常、問題は解決されます。
注意
このオプションを有効にすると、低解像度では使用できないため、保存されたWiFiマップカメラエンティティも無効になります。
クラウドを優先
この設定は、Xiaomi Homeアカウントで構成されたデバイスでのみ利用可能です。この設定では、初期設定ステップで最初に選択した優先設定の更新が可能になります。
- 有効にすると: すべての通信をクラウド経由で強制します。これは、Xiaomiがローカルアクセス機能を無効にした新しいデバイスや、デバイスとHome Assistantが異なるサブネットにある場合に必要です。
- 無効にした場合（サポートされているセットアップでは推奨）： この統合は、デバイスとの直接的なローカル接続を確立します（クラウドからのトークンおよびIPの更新は自動的に処理されます）。これにより、マップデータを除くすべての通信が完全にローカルで行われます。
ローカルAPIの可用性をテストする
このオプションは、ローカル接続をテストする非常に便利な方法を提供します。初期デバイス設定がエラーなく成功することを確認するために、クラウド優先 を設定フロー中に有効のままにしておくことができます。デバイスがHome Assistantに正常に追加された後、このオプションをここで無効にして、デバイスが実際にローカルAPIをサポートしているかどうかを確認できます。無効にした後にデバイスが利用できなくなった場合は、単に再度有効にしてクラウド接続に戻してください。
YAML 参考用
yaml
dreame_vacuum:
# Local connection
host: 192.168.1.100
token: b2a1c3d4e5f6a7b8c9d0e1f2a3b4c5d6
# Cloud connection
username: your@email.com
password: your_password
country: de
prefer_cloud: true # Only available on Xiaomi Home
# Options available regardless of connection type
dvc_key: 123e4567-e89b-42d3-a456-426614174000
notify:
- information
- warning
- error
# Options available only with map support (Cloud)
color_scheme: dreame_dark
icon_set: dreame_old
hidden_map_objects:
- name_background
- name
- order
square: true
low_resolution: true