マップサポート
公式アプリで提供されるすべての機能をサポートするライブおよび複数の保存済みマップ用に、マップデータの処理、デコード、レンダリングを完全にリバースエンジニアリングしました。


- パフォーマンス向上のためにレイヤーキャッシュを使用した高解像度画像レンダリング。
- すべてのアイコン位置およびカラーインデックス検索アルゴリズムは、公式アプリの外観と操作感に一致するように独立してリバースエンジニアリングされました。
- すべてのマップ操作は、低遅延の更新のためにデバイスに送信される前にメモリ上で処理されます。
- マップ編集および部分マップの操作のための、完全機能で高度に最適化された統合マップマネージャ。
- マップの種類、デバイスの状態、最終アクセス時間によって決定される動的リフレッシュレート。
低遅延での高リフレッシュレート
統合機能は高度な地図デコード機能を備えており、公式アプリのパフォーマンスに近い低遅延で高いリフレッシュレートを提供します。受信データストリームをシームレスに処理し、ほとんどのデバイスで見られる標準の3秒リフレッシュレートだけでなく、2026年以降の新しいモデルで導入された1秒の高速リフレッシュレートにも対応します。


地図デコードの複雑さ
最新のデバイスは部分的な地図更新(Pフレーム)を送信し、前のフレームとの差分のみを含みます。これらの差分フレームをデコードすることは非常に複雑なプロセスですが、リアルタイム更新を実現するために必要です。このロジックを独立して処理することで、統合機能はフルマップを継続的にリクエストする際の重い負荷や任意の時間制限を回避します。
カラー スキーム
この統合は複数の組み込みカラースキームを提供し、ユーザーはライブマップと保存済みマップの両方の視覚スタイルをダッシュボードのデザインに最適に合わせてカスタマイズできます。


Dreameライト


Dreameダーク


Mijiaライト


Mijiaダーク


グレースケール
特定のデバイスのアクティブなカラースキームは、いつでも カラースキーム の設定オプションから変更できます。
部屋とカスタマイズされた清掃アイコン
マップレンダラーは部屋ごとのアイコン、ラベル、バッジの包括的なセットを動的に生成してオーバーレイし、デバイスの現在のカスタマイズされた清掃設定をリアルタイムで反映します。これらの動的にレンダリングされた要素には以下が含まれます:
- 部屋の色
- 部屋のアイコン
- 部屋の名前
- 部屋の名前背景
- 部屋の順番
- 部屋の吸引レベル
- 部屋の水量
- 部屋の清掃時間
- 部屋の清掃モード
- 部屋のモップモード
これらの部屋固有の要素は、隠しマップオブジェクト 設定オプションを使用して、いつでも生成されたマップから選択的に非表示にすることができます。
ジョブタイプに応じた動的オブジェクトレンダリング
部屋の色、アクティブアイコン、その他のオブジェクトを含むマップ上に表示される視覚要素は、ロボットの現在のジョブタイプ(例:部屋掃除とゾーン掃除)に応じて動的に変化し、実行中のタスクを正確に反映します。




高速マッピングおよびスポット清掃
この統合は、未保存の一時マップをリアルタイムで解析してレンダリングすることができます。これには、高速マッピング操作中や、ロボットの物理ボタンから直接開始されたスポット清掃タスク中に動的に描画されるマップが含まれます。
一時マップの処理
ロボットが高速マッピングまたはスポットクリーニングを行っているとき、メモリ内に新しい一時マップを作成し、ローカルのmap_request APIアクションには応答しません。これらの新しく作成されたマップにはまだオブジェクト名がないため、クラウドのmap_dataプロパティを通じてのみアクセスできます。新しいマップデータは、まったく異なるデコードおよびレンダリングルールを必要とするため、この統合はこのタイプのマップデータを処理するために特に対応しています。




マッピング作業が完了したが、デバイスが最大保存マップ数に達した場合、ロボットは一時停止し、既存のマップを上書きするか、新しく生成されたマップを破棄するかの判断を待ちます。この統合は、一時マップが発見され、アクションを待っているときに警告する専用の通知を提供します。
ロボットの状態
デバイスの状態を表示する掃除機アイコンのオーバーレイで、公式アプリの慣例に従います。
スリープ | 待機中 | アクティブ | 充電中 | エラー |
|---|---|---|---|---|
![]() ![]() | ![]() ![]() | ![]() ![]() | ![]() ![]() | ![]() ![]() |
ヒント
警告は通知またはマップ上のロボット状態を復元するためのclear_warningサービスを通じてクリアできます。
部屋エンティティ


この統合は、部屋の名前、床材、カスタマイズされた清掃設定など、部屋のすべてのカスタマイズ可能なプロパティを管理するための動的な部屋エンティティを公開します。これらのエンティティは保存されたマップから動的に生成され、選択されたマップが変更されると自動的に更新されます。




