マップエンティティ マップサポート
この統合により、マップの可視化および管理に特化したさまざまなエンティティが自動的に公開されます。これには、ライブおよび保存されたマップのレンダリング用の動的カメラエンティティ、複数階のレイアウトやマップの回転を管理するための選択エンティティ、新しいマッピングタスクをトリガーするためのボタンエンティティ、履歴データや現在の部屋追跡を提供するセンサーエンティティが含まれます。
これらのエンティティの利用可能性は、デバイスのマップサポート能力およびアクティブな接続方法に依存します。
多層マップサポート
複数階のマップ管理のために自動生成されたカメラおよび選択エンティティを使用して、最大三つの保存済みマップがサポートされます。
注意
保存されたマップは、[original map id][version] を map_id フォーマット（例: 46）として使用します。そのため、マップIDは常に変化しており、エンティティIDには使用できません。代わりに、マップカメラエンティティはインデックスシステムを使用します。マップインデックスは、マップID順に並んだ保存済みマップリストから作成され、カスタム名のないマップの命名に使用されます。したがって、map_2 がリストから削除されると、map_3 が代わりに削除され、map_3 が map_2 になります（公式アプリでの処理と同様です）。複数の保存されたマップが存在する場合にマルチフロアマップが無効になっている場合、map_1 は常に選択されたマップになり、他のマップは削除されません。
カメラ
| 名前 | 説明 | 注意事項 |
|---|---|---|
map | ライブマップ | ライブマップ画像 |
map_data | valetudo-card用ライブマップデータ | デフォルトで無効 |
map_1 | 最初に保存されたマップ | インデックス1の保存マップ |
map_2 | 2番目に保存されたマップ | インデックス2の保存マップ、マルチフロアマップが有効で、マップリストに少なくとも2つの保存マップがある場合に利用可能 |
map_3 | 3番目に保存されたマップ | インデックス3の保存マップ、マルチフロアマップが有効で、マップリストに少なくとも3つの保存マップがある場合に利用可能 |
map_4 | 四番目に保存された地図 | インデックス4に保存された地図。マルチフロアマップが有効で、地図リストに少なくとも4つの保存済み地図がある場合に使用可能（WiFiマップを搭載した掃除機のみで使用可能） |
wifi_map_1 | 一番目に保存された地図のWiFiマップ | WiFiマップを搭載した掃除機で利用可能 |
wifi_map_2 | 二番目に保存された地図のWiFiマップ | WiFiマップを搭載した掃除機で利用可能 |
wifi_map_3 | 三番目に保存された地図のWiFiマップ | WiFiマップを搭載した掃除機で利用可能 |
wifi_map_4 | 四番目に保存された地図のWiFiマップ | WiFiマップを搭載した掃除機で利用可能 |
カメラエンティティはクラウド接続を使用している場合にのみ利用可能です。すべてのカメラエンティティは、最後のリクエスト時刻と現在のデバイス状態により決定される動的な更新レートで動作します。マップは画像リクエストが行われたときにのみレンダリングされ、画像の変更された部分だけが更新されます。
保存された地図のカメラ名は、インデックスまたはカスタム名に基づいて動的に生成されます。マルチフロア設定の場合、保存された地図のエンティティはマップIDの代わりにインデックスシステムを使用します。 詳細情報
ライブマップは直接編集できません。編集を行った後、ロボットが新しい清掃タスクを開始するまで保存された地図がレンダリングされます。
注意
map_1エンティティは、マルチフロアマップ機能が無効の場合、常に現在選択されているマップの保存されたマップを表示します。
マップ機能の詳細については
ボタン
| 名前 | 説明 | 注意事項 |
|---|---|---|
start_fast_mapping | 高速マッピングの開始 | 最大マップ数に達すると利用できません |
start_mapping | フロア全体を掃除して新しいマップを作成 | 最大マップ数に達すると利用できません |
backup_saved_map | 現在保存されているマップのバックアップを作成 | マップバックアップ機能があるデバイスで利用可能 |
選択
| 名前 | 説明 | 注意事項 |
|---|---|---|
map_rotation | 選択されたマップの回転を設定 | マップ機能で利用可能。現在のマップが選択されたマップの一つでない場合は利用できません（保存されたマップには異なるマップ回転を設定できますが、このエンティティで編集できるのは選択されたマップのみです） |
selected_map | 現在選択されているマップ | マップ機能で利用可能。マルチフロアマップが無効または利用できない場合は利用できません（選択されたマップが変更されるとロボットは作業を終了します） |
ルーム用のエンティティを選択
ルーム選択エンティティは保存されたマップから動的に生成され、部屋ごとのカスタマイズされた掃除設定を編集するために使用されます。
カスタマイズされた清掃機能の詳細について
センサー
| 名前 | 説明 | 注意事項 |
|---|---|---|
cleaning_history | 前回の清掃作業の詳細を属性として | マップ機能で利用可能 |
cruising_history | 前回の巡回作業の詳細を属性として | マップ機能で利用可能 |
current_room | 掃除機が現在いる部屋 | マップ機能で利用可能 |