Externe Integration - Roborock

spenceur · 5. Oktober 2026 um 16:14

Hallo @Lokkye, ich habe einen PR erstellt, um ein Widget und Aktionen sowie Auslöser hinzuzufügen.

github.com/callemand/gladys-roborock

feat(vacuum): map dashboard widget + scene triggers and actions (#6)

main ← vincentBesseau:feat/vacuum-map

ouvert 11:53AM - 05 Oct 26 UTC

vincentBesseau

+4584 -30

## Résumé Deux ajouts pour l'intégration Roborock : 1. **Carte de l'aspirateur… en widget de dashboard** (SDK `0.14`, widgets Gladys `5.1`). 2. **Déclencheurs et actions de scène** (l'aspirateur dans l'éditeur de scènes). ## 1. Carte en widget - **Récupération** : `get_map_v1` (frame protocole `301`, déchiffrement AES‑128‑CBC + gunzip), transport local-first avec repli cloud. - **Parseur RRMap** : format binaire → objet structuré (segments, robot, base, trajet, zones interdites, murs virtuels…), réconcilié avec `get_room_mapping` pour les **noms de pièces**. - **Rendu PNG maison** (via `node:zlib`, sans dépendance) proche de l'app : pièces colorées, murs fins, zones interdites, murs virtuels, base/robot, **fond transparent** (s'adapte au thème clair/sombre). - **Widget « Aspirateur »** : tuiles batterie / surface, carte, bloc état (état, dernier nettoyage, durée, **% de chaque consommable**) et **4 boutons** — Démarrer + Retour base fixes, et **2 boutons configurables** via les réglages. - **Timestamp de début du dernier nettoyage** (`get_clean_summary`, mis en cache). ## 2. Scènes Déclaré dans le manifest (`scene_triggers` / `scene_actions`), branché sur les données déjà pollées et les commandes RPC existantes. **Déclencheurs** (émis sur transition via `publishSceneEvent`) : `cleaning_started`, `cleaning_finished` (durée, surface), `returned_to_dock`, `battery_low` (≤ 20 %), `charging_complete`, `robot_error` (code + libellé), `consumable_worn` (≤ 10 %, par consommable), `state_changed`. **Actions** (`onSceneAction`, chacune avec un champ `vacuum`) : `start_cleaning`, `pause_cleaning`, `stop_cleaning`, `return_to_dock`, `clean_rooms` (noms de pièces → `app_segment_clean`), `set_fan_power` (silencieux/équilibré/turbo/max), `run_routine` (nom de routine → `executeRoutine`). Les transitions sont détectées via un instantané par robot mis en cache entre deux polls (le premier poll ne fait qu'amorcer le cache). Les seuils sont gérés côté intégration (les filtres de scène sont à égalité seulement) et le niveau/pourcentage est exposé en variable de scène. ## Points d'attention - ⚠️ **`gladys_version` passe à `>=5.1.0`** : les widgets de dashboard nécessitent Gladys 5.1.0 (c'était `>=4.86.0` sur `main`). - **Bump de version patch** : `2.3.0` → `2.3.1`. - **Transport local QV35A** : silencieux en TCP local quand il est à la base (en charge) → repli automatique sur le cloud, documenté. ## Tests - `114` tests passent (`node --test`), `eslint` et `prettier --check` clean. ## Suite possible Demande de fonctionnalité pour une **carte interactive** (sélection de pièces au clic → nettoyage ciblé), qui nécessiterait un composant frontend côté cœur : https://community.gladysassistant.com/t/composant-carte-interactive-zones-cliquables-pour-les-widgets-dintegration-externe/10959 🤖 Generated with [Claude Code](https://claude.com/claude-code)

Ich habe auch eine Anfrage gestellt, um eines Tages auf der Karte die zu reinigenden Räume auszuwählen und dieses Widget weiterzuentwickeln

Thema		Antworten	Aufrufe
Développement service Ecovacs Développement	3	200	1. März 2024
Prise en charge des aspirateurs Roborock de Xiaomi Demandes livrées	45	1785	9. September 2026
Gladys Assistant 5 est disponible ! 🚀 Actualités	35	687	12. September 2026
Gladys Assistant 4.82 : Journal d'activité & refonte de l'intégration MQTT 🚀 Actualités	31	419	19. Juli 2026
Lancement de Gladys Assistant 4 ! 🚀 Actualités	59	4707	25. Januar 2021

Externe Integration - Roborock

Verwandte Themen