使い方

これはバックエンド統合であるため、ネイティブのフロントエンドUIコンポーネントは提供されません。その代わり、すべての視覚的な操作はHome AssistantのLovelaceダッシュボードに依存します。

組み込みのフロントエンドサポートはありませんが、この統合はプラットフォームエンティティ（例えばvacuum,camera,select,buttonのエンティティ）を包括的にエクスポートします。これらのエンティティをコミュニティ開発のカスタムLovelaceカードと組み合わせることで、ダッシュボード上に非常にインタラクティブなカスタムUIを構築することが完全に可能です。このアプローチにより、Home Assistant内で完全なアプリのような体験が提供されます。

さらに、この統合は専用のサービスを提供し、カスタムイベントをブロードキャストします。これにより、ロボット掃除機をバックグラウンドオートメーションを介して完全に制御でき、視覚的なインターフェースをまったく必要としない複雑なシナリオにも対応できます。

まずはこれを確認

もしまだHome Assistantに慣れていない場合は、以下の公式ドキュメントのページを確認することを強くお勧めします。この統合は標準的なアーキテクチャに厳密に従っているため、これらの基本概念をしっかり理解することが、この統合を最大限に活用するために不可欠です。

• 掃除機エンティティ: コアの掃除機コンポーネントについて説明します。これを理解することは、主デバイスエンティティとのやり取り、状態の解釈、標準的なサービス呼び出し（開始、一時停止、ホームへの戻りなど）を使用するために必要です。
• 選択, 数字, および ボタン エンティティ: 設定オプションやアクションがどのように公開されるかを詳しく説明します。この統合では、デバイス設定（例：吸引レベル、水量）を表すためや、アクションを実行するため（例：消耗品のリセット、ロボットの位置特定）に数十のエンティティが使用されます。
• サービス呼び出し: パラメータを使ったバックエンドアクションの実行方法について説明します。この概念は、部屋ごとのまたはゾーンベースの掃除など、統合のカスタムサービスをトリガーするために重要です。
• オートメーション: アクションを自動的にトリガーする方法を説明します。これは、カスタムイベントに基づいて家が空のときに掃除サイクルを開始するなどの背景ワークフローを作成する際に必要です。
• カスタムサービス 推奨: 標準機能を拡張する統合固有のサービス呼び出しの詳細を説明し、ゾーン別掃除やセグメント別掃除などの高度な操作を可能にします。このセクションでは、これらの機能を自動化するための実用的なサービス呼び出しの例やペイロードを提供します。