Servicios de Aspiradora

La integración expone varios servicios personalizados para acciones y funciones avanzadas que no se pueden controlar directamente a través de las entidades estándar. Estos servicios personalizados utilizan el dominio vacuum y proporcionan un control detallado sobre las funcionalidades específicas del dispositivo.

Limpiar habitación

dreame_vacuum.vacuum_clean_segment

Inicia la limpieza de la habitación seleccionada con parámetros de limpieza opcionales personalizados.

Nota

• Si estás utilizando la integración con la función de mapa, puedes obtener los identificadores de segmento de los atributos de la entidad del robot aspirador.
• Los parámetros de limpieza y la secuencia de limpieza son ignorados por el dispositivo cuando customized_cleaning o cleaning_sequence están habilitados.

Configuración del Modo de Limpieza

Este servicio no acepta un parámetro cleaning_mode. Para establecer el modo de forma dinámica antes de iniciar la limpieza, consulta Preguntas Frecuentes.

Ejemplos

• Limpiar habitación 3

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

• Limpiar habitaciones 3 y 5

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

• Limpiar habitaciones 3 y 5 dos veces

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

• Limpiar habitación 2 dos veces y 5 una vez

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

• Limpiar habitaciones 3 y 5 con alta velocidad del ventilador

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

• Limpiar habitación 3 con alta velocidad del ventilador y 5 con velocidad silenciosa del ventilador

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

Limpiar Zona

dreame_vacuum.vacuum_clean_zone

Iniciar limpieza de zona seleccionada con parámetros de limpieza personalizados opcionales.

Consejo

Puede obtener las coordenadas de la zona con Tarjeta de Mapa de Aspiradora Xiaomi.

Configuración del Modo de Limpieza: Este servicio no acepta un parámetro cleaning_mode. Para establecer el modo dinámicamente antes de iniciar una limpieza, consulte el Preguntas Frecuentes.

Ejemplos

• Limpiar zona seleccionada

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

• Limpiar múltiples zonas

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

• Limpiar zona seleccionada dos veces

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

• Limpiar primera zona dos veces, segunda zona tres veces

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

Limpiar Punto

dreame_vacuum.vacuum_clean_spot

Iniciar limpieza de punto seleccionado con parámetros de limpieza personalizados opcionales.

Nota

La función de limpieza de puntos solo está disponible para robots de marca Xiaomi/Mijia, pero también funciona con dispositivos Dreame.

Consejo

Puede obtener las coordenadas del punto con Tarjeta de Mapa de Aspiradora Xiaomi.

Configuración del Modo de Limpieza: Este servicio no acepta un parámetro cleaning_mode. Para establecer el modo dinámicamente antes de iniciar una limpieza, consulte el Preguntas Frecuentes.

Ejemplos

• Limpiar punto seleccionado

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

• Limpiar múltiples puntos

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

• Limpiar punto seleccionado dos veces

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

• Limpiar primer punto dos veces, segundo punto tres veces

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

Ir al Punto

dreame_vacuum.vacuum_goto

Enviar el robot a una sola coordenada en el mapa y detenerlo allí.

Nota

• En dispositivos con la función de crucero (aspiradoras con navegación LIDAR y transmisión de cámara) esto inicia un trabajo de crucero hasta el punto y el robot toma fotos alrededor del punto objetivo cuando llega. El trabajo se guarda en el historial de crucero. (Más sobre mapas históricos de recorridos)
• En otros dispositivos, el mismo comportamiento se emula con un trabajo de limpieza de zona pequeña alrededor del punto dado. El nivel de succión se establece en silencioso y se desactiva el fregado para ese trabajo, y la integración detiene el robot y restaura los ajustes de limpieza anteriores tan pronto como llega al punto.
• El nivel de batería debe ser al menos del 15% y la coordenada debe estar dentro del mapa actual.
• El dispositivo no responde a esta acción cuando el robot ya está sobre la coordenada seleccionada, la estación se está vaciando o la estación se está auto-reparando/probando.

Consejo

Puede obtener las coordenadas del punto con Tarjeta de Mapa de Aspiradora Xiaomi.

Ejemplo

• Ir a [819, -2235] y detenerse

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

Seguir ruta Experimental

dreame_vacuum.vacuum_follow_path

Iniciar un trabajo de ruta de crucero que visite las coordenadas dadas una por una y regrese al dock.

Advertencia

El dispositivo está restringido a realizar tareas de seguimiento de ruta solo mientras la transmisión en vivo de la cámara esté activa. A diferencia de Ir al Punto, este servicio está vinculado a la cámara y debe abrir la cámara desde la App oficial antes de llamarlo. De lo contrario, el robot ignora completamente la solicitud y no hace nada en absoluto.

Nota

• Este servicio solo está disponible en dispositivos con la función de crucero (aspiradoras con navegación lidar y transmisión de cámara).
• Solo se envían los primeros 20 puntos al dispositivo y cada coordenada debe estar dentro del mapa actual.
• Cuando se omite points, se utilizan los puntos de crucero guardados del mapa actual. Se requiere al menos una coordenada válida o guardada para iniciar el trabajo.
• El nivel de batería debe ser al menos del 15% y el dispositivo no responde a esta acción mientras la estación se está descargando o reparando/probando automáticamente.
• Puede obtener las coordenadas del punto con Tarjeta de Mapa de Aspiradora Xiaomi.

Ejemplos

• Seguir una ruta de tres puntos

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

• Seguir los puntos de crucero guardados del mapa actual

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

Iniciar acceso directo

dreame_vacuum.vacuum_start_shortcut

Iniciar una tarea de acceso directo creada en la App oficial.

Nota

• Los accesos directos solo están disponibles en dispositivos compatibles y puedes obtener los IDs de accesos directos del atributo shortcuts de la entidad de la aspiradora.
• Los IDs de accesos directos válidos están entre 25 y 128.
• La integración también crea una entidad de botón para cada acceso directo del dispositivo como button.{vacuum_name}_shortcut_{shortcut_id}, por lo que generalmente no es necesario usar este servicio.
• El dispositivo no responde a esta acción mientras la estación está drenando o realizando auto reparación/pruebas.

Ejemplo

• Iniciar acceso directo con ID 32

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

Renombrar acceso directo

dreame_vacuum.vacuum_rename_shortcut

Establecer nombre personalizado para un acceso directo.

Nota

• Puedes obtener los IDs de accesos directos del atributo shortcuts de la entidad de la aspiradora.
• Los nombres de los accesos directos deben ser únicos. Cuando el nuevo nombre ya está siendo usado por otro acceso directo, se le agrega un contador, tal como lo hace la aplicación oficial. (Por ejemplo: Mopping after sweeping se convierte en Mopping after sweeping2)
• El nombre de la entidad de botón de acceso directo generado sigue el nombre del acceso directo.
• Los accesos directos no se pueden renombrar mientras el robot está en funcionamiento.

Ejemplo

• Renombrar acceso directo con ID 32 a "Fregado después del barrido"

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

Eliminar atajo

dreame_vacuum.vacuum_delete_shortcut

Eliminar un acceso directo.

Nota

• Puedes obtener los IDs de accesos directos del atributo shortcuts de la entidad de la aspiradora.
• La entidad del botón del acceso directo eliminado se elimina automáticamente.
• No se puede eliminar un acceso directo mientras su propia tarea está en ejecución.
• Los accesos directos eliminados no se pueden restaurar y solo se pueden recrear desde la aplicación oficial.

Ejemplo

• Eliminar acceso directo con id 34

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

Instalar paquete de voz

dreame_vacuum.vacuum_install_voice_pack

Instalar un paquete de voz oficial.

Establecer secuencia de limpieza Soporte de Mapa

dreame_vacuum.vacuum_set_cleaning_sequence

Establecer secuencia de limpieza de habitaciones en el mapa actual.

Nota

Se debe pasar el número exacto de IDs de habitaciones como lista de secuencia

Ejemplo

• Establecer secuencia de limpieza de habitaciones en el mapa actual a 3, 5, 4, 2, 1

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

• Deshabilitar secuencia de limpieza personalizada en el mapa actual

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

Establecer limpieza personalizada Soporte de Mapa

dreame_vacuum.vacuum_set_custom_cleaning

Establecer parámetros de limpieza de habitaciones personalizados en el mapa actual.

Nota

Se deben pasar los ajustes de todas las habitaciones como lista

Ejemplos

• Establecer velocidad del ventilador de la habitación 1 en silencioso, nivel de agua en bajo, tiempos de limpieza a 2 y velocidad del ventilador de la habitación 5 en turbo, nivel de agua en medio, repeticiones a 1

  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

• Establecer nivel de humedad de la habitación 3 a 16

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

Restablecer consumible

dreame_vacuum.vacuum_reset_consumable

Reiniciar la vida útil de un consumible por tipo.

Valores posibles para consumible

• 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

Ejemplos

• Reiniciar vida útil del cepillo principal

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

• Reiniciar vida útil de la almohadilla de fregado

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

Control remoto No Recomendado

dreame_vacuum.vacuum_remote_control_move_step

Enviar comando de control remoto al aspirador.

Enviar comando No Recomendado

vacuum.send_command

El servicio de enviar comandos se puede usar para enviar solicitudes API sin procesar que no están disponibles con esta integración.

Solo para uso experimental

No se recomienda que los usuarios finales utilicen este servicio directamente. Si hay una acción que requiere el uso de este servicio porque aún no está implementada en la integración, por favor abrir una solicitud de función en su lugar.

Consejo

Más información sobre comandos y parámetros.

Ejemplos

• Iniciar vaciado automático

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

• Activar patrón de fregado ajustado y desactivar el aumento de potencia en alfombras

  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