Staubsaugendienste

Die Integration stellt verschiedene benutzerdefinierte Dienste für erweiterte Aktionen und Funktionen bereit, die nicht direkt über Standard-Entities steuerbar sind. Diese benutzerdefinierten Dienste verwenden die vacuum-Domain und bieten eine granulare Kontrolle über gerätespezifische Funktionen.

Raum reinigen

dreame_vacuum.vacuum_clean_segment

Starten Sie die Reinigung des ausgewählten Raums mit optionalen, angepassten Reinigungsparametern.

Hinweis

• Wenn Sie die Integration mit Kartenfunktion verwenden, können Sie Segment-IDs aus den Attributen der Saugroboter-Entity abrufen.
• Reinigungsparameter und Reinigungsreihenfolge werden vom Gerät ignoriert, wenn customized_cleaning oder cleaning_sequence aktiviert ist.

Reinigungsmodus einstellen

Dieser Dienst akzeptiert keinen cleaning_mode-Parameter. Um den Modus vor dem Start einer Reinigung dynamisch festzulegen, siehe FAQ.

Beispiele

• Raum 3 reinigen

  service: dreame_vacuum.vacuum_clean_segment
  data:
    segments: 3
  target:
    entity_id: vacuum.vacuum

• Raum 3 und 5 reinigen

  service: dreame_vacuum.vacuum_clean_segment
  data:
    segments:
      - 3
      - 5
  target:
    entity_id: vacuum.vacuum

• Raum 3 und 5 zwei Mal reinigen

  service: dreame_vacuum.vacuum_clean_segment
  data:
    segments:
      - 3
      - 5
    repeats: 2
  target:
    entity_id: vacuum.vacuum

• Raum 2 zwei Mal und Raum 5 einmal reinigen

  service: dreame_vacuum.vacuum_clean_segment
  data:
    segments:
      - 3
      - 5
    repeats: 
      - 2
      - 1
  target:
    entity_id: vacuum.vacuum

• Raum 3 und 5 mit hoher Lüftergeschwindigkeit reinigen

  service: dreame_vacuum.vacuum_clean_segment
  data:
    segments:
      - 3
      - 5
    suction_level: "high"
  target:
    entity_id: vacuum.vacuum

• Raum 3 mit hoher Lüftergeschwindigkeit und Raum 5 mit leiser Lüftergeschwindigkeit reinigen

  service: dreame_vacuum.vacuum_clean_segment
  data:
    segments:
      - 3
      - 5
    suction_level: 
      - "high"
      - "quiet"
  target:
    entity_id: vacuum.vacuum

Bereich reinigen

dreame_vacuum.vacuum_clean_zone

Starten Sie die Reinigung der ausgewählten Zone mit optionalen benutzerdefinierten Reinigungsparametern.

Tipp

Sie können Zonenkoordinaten mit der Xiaomi Staubsauger-Kartenkarte abrufen.

Einstellen des Reinigungsmodus: Dieser Dienst akzeptiert keinen cleaning_mode-Parameter. Um den Modus dynamisch vor dem Start einer Reinigung festzulegen, siehe FAQ.

Beispiele

• Ausgewählte Zone reinigen

  service: dreame_vacuum.vacuum_clean_zone
  data:
    zone: 
      - 819
      - -263
      - 4424
      - 2105
  target:
    entity_id: vacuum.vacuum

• Mehrere Zonen reinigen

  service: dreame_vacuum.vacuum_clean_zone
  data:
    zone: 
      - - 819
        - -263
        - 4424
        - 2105
      - - 2001
        - -3050
        - 542
        - 515
  target:
    entity_id: vacuum.vacuum

• Ausgewählte Zone zweimal reinigen

  service: dreame_vacuum.vacuum_clean_zone
  data:
    zone: 
      - 819
      - -263
      - 4424
      - 2105
    repeats: 2
  target:
    entity_id: vacuum.vacuum

• Erste Zone zweimal, zweite Zone dreimal reinigen

  service: dreame_vacuum.vacuum_clean_zone
  data:
    zone: 
      - - 819
        - -263
        - 4424
        - 2105
      - - 2001
        - -3050
        - 542
        - 515
    repeats: 
      - 2
      - 3
  target:
    entity_id: vacuum.vacuum

Punktreinigung

dreame_vacuum.vacuum_clean_spot

Starten Sie die Reinigung eines ausgewählten Punktes mit optionalen benutzerdefinierten Reinigungsparametern.

Hinweis

Die Punktreinigungsfunktion ist nur für Roboter der Marken Xiaomi/Mijia verfügbar, funktioniert aber auch mit den Geräten von Dreame.

Tipp

Sie können Punktkoordinaten mit der Xiaomi Staubsauger-Kartenkarte abrufen.

Einstellen des Reinigungsmodus: Dieser Dienst akzeptiert keinen cleaning_mode-Parameter. Um den Modus dynamisch vor dem Start einer Reinigung festzulegen, siehe FAQ.

Beispiele

• Ausgewählten Punkt reinigen

  service: dreame_vacuum.vacuum_clean_spot
  data:
    points: 
      - 819
      - -263
  target:
    entity_id: vacuum.vacuum

• Mehrere Punkte reinigen

  service: dreame_vacuum.vacuum_clean_spot
  data:
    points: 
      - - 819
        - -263
      - - 2001
        - -3050
  target:
    entity_id: vacuum.vacuum

• Ausgewählten Punkt zweimal reinigen

  service: dreame_vacuum.vacuum_clean_spot
  data:
    points: 
      - 819
      - -263
    repeats: 2
  target:
    entity_id: vacuum.vacuum

• Ersten Punkt zweimal, zweiten Punkt dreimal reinigen

  service: dreame_vacuum.vacuum_clean_spot
  data:
    points: 
      - - 819
        - -263
      - - 2001
        - -3050
    repeats: 
      - 2
      - 3
  target:
    entity_id: vacuum.vacuum

Gehe zu Punkt

dreame_vacuum.vacuum_goto

Senden Sie den Roboter zu einer einzelnen Koordinate auf der Karte und stoppen Sie ihn dort.

Hinweis

• Bei Geräten mit der Kreuzfahrtfunktion (Staubsauger mit Lidar-Navigation und Kamera-Streaming) startet dies einen Cruise-to-Point-Job, und der Roboter macht Fotos rund um den Zielpunkt, wenn er ankommt. Der Job wird im Kreuzfahrtverlauf gespeichert. (Mehr über Verlaufskarten für die Fahrt)
• Bei anderen Geräten wird das gleiche Verhalten durch einen kleinen Bereichsreinigungsjob um den angegebenen Punkt herum emuliert. Der Saugmodus wird auf leise gestellt und das Wischen für diesen Job deaktiviert. Sobald der Roboter den Punkt erreicht, wird er von der Integration gestoppt und die vorherigen Reinigungseinstellungen werden wiederhergestellt.
• Der Batteriestand muss mindestens 15 % betragen und die Koordinate muss innerhalb der aktuellen Karte liegen.
• Das Gerät reagiert auf diese Aktion nicht, wenn der Roboter bereits auf der ausgewählten Koordinate steht, die Station entlädt oder die Station sich selbst repariert/testet.

Tipp

Sie können Punktkoordinaten mit der Xiaomi Staubsauger-Kartenkarte abrufen.

Beispiel

• Gehe zu [819, -2235] und stoppe

  service: dreame_vacuum.vacuum_goto
  data:
    x: 819
    y: -2235
  target:
    entity_id: vacuum.vacuum

Pfad folgen Experimentell

dreame_vacuum.vacuum_follow_path

Starte einen Kreuzfahrtpfad-Job, der die angegebenen Koordinaten nacheinander besucht und zur Ladestation zurückkehrt.

Warnung

Das Gerät ist darauf beschränkt, nur Aufgaben zum Folgen eines Pfads auszuführen, während das Live-Kamera-Streaming aktiv ist. Im Gegensatz zu Gehe zu Punkt ist dieser Dienst an die Kamera gebunden, und Sie müssen die Kamera über die offizielle App öffnen, bevor Sie ihn aufrufen. Andernfalls ignoriert der Roboter die Anfrage vollständig und unternimmt nichts.

Hinweis

• Dieser Dienst ist nur auf Geräten mit der Kreuzfahrt-Funktion verfügbar (Staubsauger mit Lidar-Navigation und Kamera-Streaming).
• Es werden nur die ersten 20 Punkte an das Gerät gesendet, und jede Koordinate muss innerhalb der aktuellen Karte liegen.
• Wenn points weggelassen wird, werden stattdessen die gespeicherten Kreuzfahrtpunkte der aktuellen Karte verwendet. Mindestens eine gültige oder gespeicherte Koordinate ist erforderlich, um den Auftrag zu starten.
• Der Batteriestand muss mindestens 15 % betragen, und das Gerät reagiert auf diese Aktion nicht, während die Station entlädt oder sich selbst repariert/testet.
• Sie können Punktkoordinaten mit der Xiaomi Staubsauger-Kartenkarte abrufen.

Beispiele

• Folge einem Pfad von drei Punkten

  service: dreame_vacuum.vacuum_follow_path
  data:
    points:
      - - 819
        - -263
      - - 2001
        - -3050
      - - 542
        - 515
  target:
    entity_id: vacuum.vacuum

• Folge den gespeicherten Kreuzfahrtpunkten der aktuellen Karte

  service: dreame_vacuum.vacuum_follow_path
  target:
    entity_id: vacuum.vacuum

Kurzbefehlsstart

dreame_vacuum.vacuum_start_shortcut

Starte eine Shortcut-Aufgabe, die in der offiziellen App erstellt wurde.

Hinweis

• Shortcuts sind nur auf unterstützten Geräten verfügbar und Sie können Shortcut-IDs aus dem shortcuts-Attribut des Saugroboters erhalten.
• Gültige Shortcut-IDs liegen zwischen 25 und 128.
• Die Integration erstellt auch für jeden Shortcut des Geräts eine Schaltflächen-Entität als button.{vacuum_name}_shortcut_{shortcut_id}, daher ist die Verwendung dieses Dienstes normalerweise nicht erforderlich.
• Das Gerät reagiert nicht auf diese Aktion, während die Station entleert oder sich selbst repariert/testet.

Beispiel

• Shortcut mit der ID 32 starten

  service: dreame_vacuum.vacuum_start_shortcut
  data:
    shortcut_id: 32
  target:
    entity_id: vacuum.vacuum

Verknüpfung umbenennen

dreame_vacuum.vacuum_rename_shortcut

Benutzerdefinierten Namen für einen Shortcut festlegen.

Hinweis

• Sie können Shortcut-IDs aus dem shortcuts-Attribut des Saugroboters erhalten.
• Shortcut-Namen müssen eindeutig sein. Wenn der neue Name bereits von einem anderen Shortcut verwendet wird, wird ein Zähler wie in der offiziellen App angehängt. (Zum Beispiel: Mopping after sweeping wird zu Mopping after sweeping2)
• Der Name der erstellten Shortcut-Schaltflächen-Entität folgt dem Shortcut-Namen.
• Shortcuts können nicht umbenannt werden, während der Roboter läuft.

Beispiel

• Shortcut mit der ID 32 in "Mop nach dem Kehren" umbenennen

  service: dreame_vacuum.vacuum_rename_shortcut
  data:
    shortcut_id: 32
    shortcut_name: "Mopping after sweeping"
  target:
    entity_id: vacuum.vacuum

Verknüpfung löschen

dreame_vacuum.vacuum_delete_shortcut

Einen Shortcut löschen.

Hinweis

• Sie können Shortcut-IDs aus dem shortcuts-Attribut des Saugroboters erhalten.
• Die Schaltflächen-Entität der gelöschten Verknüpfung wird automatisch entfernt.
• Eine Verknüpfung kann nicht gelöscht werden, während ihre eigene Aufgabe läuft.
• Gelöschte Verknüpfungen können nicht wiederhergestellt werden und können nur über die offizielle App neu erstellt werden.

Beispiel

• Verknüpfung mit der ID 34 löschen

  service: dreame_vacuum.vacuum_delete_shortcut
  data:
    shortcut_id: 34
  target:
    entity_id: vacuum.vacuum

Sprachpaket installieren

dreame_vacuum.vacuum_install_voice_pack

Offizielles Sprachpaket installieren.

Reihenfolge der Reinigung festlegen Kartenunterstützung

dreame_vacuum.vacuum_set_cleaning_sequence

Reinigungsreihenfolge für Räume auf der aktuellen Karte festlegen.

Hinweis

Exakte Anzahl der Raum-IDs muss als Sequenzliste übergeben werden

Beispiel

• Reinigungsreihenfolge auf der aktuellen Karte auf 3, 5, 4, 2, 1 festlegen

  service: dreame_vacuum.vacuum_set_cleaning_sequence
  data:
      cleaning_sequence: 
        - 3
        - 5
        - 4
        - 2
        - 1
  target:
      entity_id: vacuum.vacuum

• Benutzerdefinierte Reinigungsreihenfolge auf der aktuellen Karte deaktivieren

  service: dreame_vacuum.vacuum_set_cleaning_sequence
  data:
      cleaning_sequence: []
  target:
      entity_id: vacuum.vacuum

Benutzerdefinierte Reinigung festlegen Kartenunterstützung

dreame_vacuum.vacuum_set_custom_cleaning

Benutzerdefinierte Raumreinigungsparameter auf der aktuellen Karte festlegen.

Hinweis

Einstellungen für alle Räume müssen als Liste übergeben werden

Beispiele

• Raum 1: Lüftergeschwindigkeit auf leise, Wasserstand auf niedrig, Reinigungsanzahl auf 2 und Raum 5: Lüftergeschwindigkeit auf Turbo, Wasserstand auf mittel, Wiederholungen auf 1 festlegen

  service: dreame_vacuum.vacuum_set_custom_cleaning
  data:
      segment_id: 
        - 1
        - 5
      suction_level: 
        - 0
        - 3
      water_volume: 
        - 1
        - 2
      repeats: 
        - 2
        - 1
  target:
      entity_id: vacuum.vacuum

• Luftfeuchtigkeitsstufe von Raum 3 auf 16 einstellen

  service: dreame_vacuum.vacuum_set_custom_cleaning
  data:
      segment_id: 
        - 3
      wetness_level: 
        - 16
  target:
      entity_id: vacuum.vacuum

Verbrauchsmaterial zurücksetzen

dreame_vacuum.vacuum_reset_consumable

Verbrauchsmaterialien-Lebensdauer nach Typ zurücksetzen.

Mögliche Werte für Verbrauchsmaterial

• main_brush
• side_brush
• filter
• tank_filter
• sensor
• mop_pad
• silver_ion
• detergent
• squeege
• dirty_water_channel
• onboard_dirty_water_tank
• deodorizer
• wheel
• scale_inhibitor
• fluffing_roller
• rollermop_filter
• water_outlet_filter

Beispiele

• Hauptbürsten-Lebensdauer zurücksetzen

  service: dreame_vacuum.vacuum_reset_consumable
  data:
      consumable: "main_brush"
  target:
      entity_id: vacuum.vacuum

• Wischpad-Lebensdauer zurücksetzen

  service: dreame_vacuum.vacuum_reset_consumable
  data:
      consumable: "mop_pad"
  target:
      entity_id: vacuum.vacuum

Fernsteuerung Nicht empfohlen

dreame_vacuum.vacuum_remote_control_move_step

Fernbedienungsbefehl an Staubsauger senden.

Befehl senden Nicht empfohlen

vacuum.send_command

Der Send-Befehlsdienst kann verwendet werden, um rohe API-Anfragen zu senden, die mit dieser Integration nicht verfügbar sind.

Nur für experimentellen Gebrauch

Es wird nicht empfohlen, dass Endbenutzer diesen Dienst direkt verwenden. Wenn es eine Aktion gibt, die die Nutzung dieses Dienstes erfordert, weil sie in der Integration noch nicht implementiert ist, bitte stattdessen Eine Funktionsanfrage eröffnen.

Tipp

Weitere Informationen zu Befehlen und Parametern.

Beispiele

• Automatisches Entleeren starten

  service: vacuum.send_command
  data:
      entity_id: vacuum.vacuum
      command: action
      params: 
          did: "15.1"
          siid: 15
          aiid: 1
          in: []

• Enges Wischmuster aktivieren und Teppich-Boost deaktivieren

  service: vacuum.send_command
  data:
      entity_id: vacuum.vacuum
      command: set_properties
      params: 
        - did: "4.29"
          siid: 4
          piid: 29
          value: 1
        - did: "4.12"
          siid: 4
          piid: 12
          value: 0