Serviços do Aspirador

A integração expõe vários serviços personalizados para ações avançadas e recursos que não são controláveis diretamente via entidades padrão. Esses serviços personalizados utilizam o domínio vacuum e fornecem controle detalhado sobre funcionalidades específicas do dispositivo.

Limpar Sala

dreame_vacuum.vacuum_clean_segment

Inicia a limpeza da sala selecionada com parâmetros de limpeza personalizados opcionais.

Nota

• Se você estiver usando a integração com recurso de mapa, pode adquirir os IDs de segmento a partir dos atributos da entidade do aspirador.
• Os parâmetros de limpeza e a sequência de limpeza são ignorados pelo dispositivo quando customized_cleaning ou cleaning_sequence estão ativados.

Configurando o Modo de Limpeza

Este serviço não aceita um parâmetro cleaning_mode. Para definir o modo dinamicamente antes de iniciar a limpeza, veja FAQ.

Exemplos

• Limpar sala 3

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

• Limpar sala 3 e 5

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

• Limpar sala 3 e 5 duas vezes

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

• Limpar sala 2 duas vezes e 5 uma vez

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

• Limpar sala 3 e 5 com alta velocidade do ventilador

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

• Limpar sala 3 com alta velocidade do ventilador e 5 com velocidade do ventilador silenciosa

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

Limpar zona

dreame_vacuum.vacuum_clean_zone

Inicie a limpeza da zona selecionada com parâmetros de limpeza personalizados opcionais.

Dica

Você pode adquirir as coordenadas da zona com Cartão de Mapa do Aspirador Xiaomi.

Configurando o Modo de Limpeza: Este serviço não aceita um parâmetro cleaning_mode. Para definir o modo dinamicamente antes de iniciar a limpeza, consulte o FAQ.

Exemplos

• Limpar zona selecionada

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

• Limpar várias zonas

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

• Limpar zona selecionada duas vezes

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

• Limpar primeira zona duas vezes, segunda zona três vezes

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

Limpar ponto

dreame_vacuum.vacuum_clean_spot

Inicie a limpeza de ponto selecionado com parâmetros de limpeza personalizados opcionais.

Nota

O recurso de limpeza de ponto está disponível apenas para robôs da marca Xiaomi/Mijia, mas também funciona com dispositivos Dreame.

Dica

Você pode adquirir as coordenadas do ponto com Cartão de Mapa do Aspirador Xiaomi.

Configurando o Modo de Limpeza: Este serviço não aceita um parâmetro cleaning_mode. Para definir o modo dinamicamente antes de iniciar a limpeza, consulte o FAQ.

Exemplos

• Limpar ponto selecionado

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

• Limpar vários pontos

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

• Limpar ponto selecionado duas vezes

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

• Limpar primeiro ponto duas vezes, segundo ponto três vezes

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

Ir para o Ponto

dreame_vacuum.vacuum_goto

Envie o robô para uma única coordenada no mapa e pare-o lá.

Nota

• Em dispositivos com a função de cruzeiro (aspiradores com navegação lidar e transmissão de câmera), isso inicia um trabalho de cruzeiro até o ponto e o robô tira fotos ao redor do ponto de destino quando chega. O trabalho é armazenado no histórico de cruzeiro. (Mais sobre mapas de histórico de passeio)
• Em outros dispositivos, o mesmo comportamento é simulado com um pequeno trabalho de limpeza em zona ao redor do ponto indicado. O nível de sucção é ajustado para silencioso e a função de esfregão é desativada para esse trabalho, e o robô é parado e as configurações de limpeza anteriores são restauradas pela integração assim que ele alcança o ponto.
• O nível de bateria deve ser de pelo menos 15% e a coordenada deve estar dentro do mapa atual.
• O dispositivo não responde a esta ação quando o robô já está sobre a coordenada selecionada, a estação está drenando ou a estação está se auto-reparando/testando.

Dica

Você pode adquirir as coordenadas do ponto com Cartão de Mapa do Aspirador Xiaomi.

Exemplo

• Vá para [819, -2235] e pare

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

Seguir trajeto Experimental

dreame_vacuum.vacuum_follow_path

Inicie um trabalho de caminho de cruzeiro que visite as coordenadas fornecidas uma por uma e retorne à base.

Aviso

O dispositivo está restrito a executar tarefas de seguir caminho apenas enquanto a transmissão ao vivo da câmera estiver ativa. Ao contrário de Ir para o Ponto, este serviço está vinculado à câmera e você deve abrir a câmera pelo App oficial antes de chamá-lo. Caso contrário, o robô ignora completamente a solicitação e não faz nada.

Nota

• Este serviço está disponível apenas em dispositivos com a função de cruzeiro (vassouras robô com navegação por lidar e transmissão de câmera).
• Apenas os primeiros 20 pontos são enviados para o dispositivo e cada coordenada deve estar dentro do mapa atual.
• Quando points é omitido, os pontos de cruzeiro salvos do mapa atual são usados. Pelo menos uma coordenada válida ou salva é necessária para iniciar a tarefa.
• O nível da bateria deve ser de pelo menos 15% e o dispositivo não responde a esta ação enquanto a estação estiver drenando energia ou se auto-reparando/testando.
• Você pode adquirir as coordenadas do ponto com Cartão de Mapa do Aspirador Xiaomi.

Exemplos

• Seguir um caminho de três pontos

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

• Seguir os pontos de cruzeiro salvos do mapa atual

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

Iniciar atalho

dreame_vacuum.vacuum_start_shortcut

Iniciar uma tarefa de atalho criada no App oficial.

Nota

• Atalhos estão disponíveis apenas em dispositivos compatíveis e você pode obter IDs de atalho a partir do atributo shortcuts da entidade do aspirador.
• IDs de atalho válidos estão entre 25 e 128.
• A integração também cria uma entidade de botão para cada atalho do dispositivo como button.{vacuum_name}_shortcut_{shortcut_id}, portanto, geralmente não é necessário usar este serviço.
• O dispositivo não responde a esta ação enquanto a estação estiver drenando ou se auto-reparando/testando.

Exemplo

• Iniciar atalho com ID 32

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

Renomear atalho

dreame_vacuum.vacuum_rename_shortcut

Definir nome personalizado para um atalho.

Nota

• Você pode obter IDs de atalho a partir do atributo shortcuts da entidade do aspirador.
• Nomes de atalhos devem ser únicos. Quando o novo nome já estiver sendo usado por outro atalho, um contador é adicionado a ele, como faz o aplicativo oficial. (Por exemplo: Mopping after sweeping se torna Mopping after sweeping2)
• O nome da entidade de botão de atalho gerada segue o nome do atalho.
• Atalhos não podem ser renomeados enquanto o robô estiver em funcionamento.

Exemplo

• Renomear atalho com ID 32 para "Passar pano após varrer"

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

Eliminar atalho

dreame_vacuum.vacuum_delete_shortcut

Excluir um atalho.

Nota

• Você pode obter IDs de atalho a partir do atributo shortcuts da entidade do aspirador.
• A entidade de botão do atalho excluído é removida automaticamente.
• Um atalho não pode ser excluído enquanto sua própria tarefa estiver em execução.
• Atalhos excluídos não podem ser restaurados e só podem ser recriados a partir do aplicativo oficial.

Exemplo

• Excluir atalho com id 34

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

Instalar pacote de voz

dreame_vacuum.vacuum_install_voice_pack

Instalar um pacote de voz oficial.

Definir sequência de limpeza Suporte a Mapas

dreame_vacuum.vacuum_set_cleaning_sequence

Configurar sequência de limpeza de cômodos no mapa atual.

Nota

O número exato de ids de cômodos deve ser passado como lista de sequência

Exemplo

• Configurar sequência de limpeza de cômodos no mapa atual para 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

• Desabilitar sequência de limpeza personalizada no mapa atual

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

Definir limpeza personalizada Suporte a Mapas

dreame_vacuum.vacuum_set_custom_cleaning

Definir parâmetros de limpeza personalizados para os cômodos no mapa atual.

Nota

Configurações para todos os cômodos devem ser passadas como lista

Exemplos

• Definir velocidade do ventilador do cômodo 1 para silenciosa, nível de água para baixo, número de limpezas para 2 e velocidade do ventilador do cômodo 5 para turbo, nível de água para médio, repetições para 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

• Definir nível de umidade do cômodo 3 para 16

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

Repor consumível

dreame_vacuum.vacuum_reset_consumable

Redefinir a vida útil de um consumível por tipo.

Valores possíveis para consumível

• 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

Exemplos

• Redefinir vida útil da escova principal

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

• Redefinir vida útil do pano de limpeza

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

Controlo remoto Não Recomendado

dreame_vacuum.vacuum_remote_control_move_step

Enviar comando de controle remoto para o aspirador.

Enviar Comando Não Recomendado

vacuum.send_command

O serviço de enviar comando pode ser usado para enviar solicitações de API brutas que não estão disponíveis com esta integração.

Uso experimental apenas

Não é recomendado que os usuários finais usem este serviço diretamente. Se houver uma ação que exija o uso deste serviço porque ainda não está implementada na integração, por favor, abrir uma solicitação de recurso em vez disso.

Dica

Mais informações sobre comandos e parâmetros.

Exemplos

• Iniciar esvaziamento automático

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

• Ativar padrão de esfregamento apertado e desativar aumento de potência em carpetes

  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