Serviços de Aspirador

A integração expõe vários serviços personalizados para ações avançadas e funcionalidades que não são diretamente controláveis através de entidades padrão. Estes serviços personalizados utilizam o domínio vacuum e fornecem controlo detalhado sobre funcionalidades específicas dos dispositivos.

Limpar Sala

dreame_vacuum.vacuum_clean_segment

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

Nota

• Se estiver a utilizar a integração com funcionalidade de mapa, pode obter 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.

Definir o Modo de Limpeza

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

Exemplos

• Limpar sala 3

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

• Limpar salas 3 e 5

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

• Limpar salas 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 sala 5 uma vez

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

• Limpar salas 3 e 5 com velocidade alta do ventilador

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

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

  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

Pode obter as coordenadas da zona com Cartão de Mapa do Aspirador Xiaomi.

Definição do 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 e 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 um ponto selecionado com parâmetros de limpeza personalizados opcionais.

Nota

A funcionalidade de limpeza de pontos só está disponível para robots com marca Xiaomi/Mijia, mas também funciona com dispositivos Dreame.

Dica

Pode obter as coordenadas do ponto com Cartão de Mapa do Aspirador Xiaomi.

Definição do 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 e 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 robot para uma única coordenada no mapa e pare-o aí.

Nota

• Em dispositivos com a funcionalidade de cruzeiro (aspiradores com navegação por lidar e transmissão de vídeo da câmara), isto inicia um trabalho de cruzeiro para ponto e o robô tira fotos à volta do ponto alvo quando chega. O trabalho é armazenado no histórico de cruzeiro. (Mais sobre mapas de histórico de navegação)
• Em outros dispositivos, o mesmo comportamento é emulado com um pequeno trabalho de limpeza de zona à volta do ponto indicado. O nível de sucção é definido para silencioso e a função de passar pano é desativada para esse trabalho, e o robô é parado e as definições de limpeza anteriores são restauradas pela integração assim que 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á se encontra na coordenada selecionada, a estação está a drenar ou a estação está em auto reparação/teste.

Dica

Pode obter as coordenadas do ponto com Cartão de Mapa do Aspirador Xiaomi.

Exemplo

• Ir para [819, -2235] e parar

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

Seguir trajeto Experimental

dreame_vacuum.vacuum_follow_path

Iniciar um trabalho de caminho de cruzeiro que visite as coordenadas indicadas uma a uma e volte à doca.

Aviso

O dispositivo está restrito a executar tarefas de seguir caminho apenas enquanto a transmissão de vídeo ao vivo da câmara estiver ativa. Ao contrário de Ir para o Ponto, este serviço está ligado à câmara e deve abrir a câmara a partir da App oficial antes de a chamar. Caso contrário, o robô ignora completamente o pedido e não faz nada.

Nota

• Este serviço está disponível apenas em dispositivos com a funcionalidade de navegação (aspiradores com navegação lidar e transmissão de vídeo da câmara).
• Apenas os primeiros 20 pontos são enviados para o dispositivo e cada coordenada deve estar dentro do mapa atual.
• Quando points é omitido, são usados os pontos de cruzeiro guardados do mapa atual. É necessária pelo menos uma coordenada válida ou guardada para iniciar a tarefa.
• O nível da bateria deve ser pelo menos de 15% e o dispositivo não responde a esta ação enquanto a estação está a drenar ou a fazer auto-reparação/testes.
• Pode obter 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 guardados 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 que foi criada na App oficial.

Nota

• Os atalhos estão disponíveis apenas em dispositivos suportados e pode obter os IDs de atalho a partir do atributo shortcuts da entidade do aspirador.
• Os 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 está a drenar ou a realizar auto-reparação/testes.

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

• Pode obter os IDs de atalho a partir do atributo shortcuts da entidade do aspirador.
• Os nomes dos atalhos devem ser exclusivos. Quando o novo nome já estiver a ser usado por outro atalho, um contador é adicionado ao mesmo, tal como acontece na App oficial. (Por exemplo: Mopping after sweeping torna-se Mopping after sweeping2)
• O nome da entidade de botão do atalho gerado segue o nome do atalho.
• Os atalhos não podem ser renomeados enquanto o robô estiver em funcionamento.

Exemplo

• Renomear atalho com ID 32 para "Mopping after sweeping"

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

Excluir atalho

dreame_vacuum.vacuum_delete_shortcut

Eliminar um atalho.

Nota

• Pode obter os IDs de atalho a partir do atributo shortcuts da entidade do aspirador.
• A entidade de botão do atalho eliminado é removida automaticamente.
• Um atalho não pode ser eliminado enquanto a sua própria tarefa está em execução.
• Os atalhos eliminados não podem ser restaurados e só podem ser recriados a partir da App oficial.

Exemplo

• Eliminar 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 de Mapa

dreame_vacuum.vacuum_set_cleaning_sequence

Definir sequência de limpeza de salas no mapa atual.

Nota

Deve ser passado o número exato de IDs de salas como lista de sequência

Exemplo

• Definir sequência de limpeza de salas 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

• Desativar 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 de Mapa

dreame_vacuum.vacuum_set_custom_cleaning

Definir parâmetros personalizados de limpeza de salas no mapa atual.

Nota

As definições para todas as salas devem ser passadas como lista

Exemplos

• Definir velocidade do ventilador da sala 1 para silencioso, nível de água para baixo, número de limpezas para 2 e velocidade do ventilador da sala 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 humidade da sala 3 para 16

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

Redefinir consumível

dreame_vacuum.vacuum_reset_consumable

Reiniciar 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

• Reiniciar Vida Útil da Escova Principal

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

• Reiniciar Vida Útil da Mopa

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

Controle remoto Não Recomendado

dreame_vacuum.vacuum_remote_control_move_step

Enviar comando de controlo remoto para o aspirador.

Enviar Comando Não Recomendado

vacuum.send_command

O serviço de enviar comandos pode ser usado para enviar pedidos de API em bruto que não estão disponíveis com esta integração.

Apenas para Uso Experimental

Não é recomendado que os utilizadores finais usem este serviço diretamente. Se houver uma ação que exija a utilização deste serviço porque ainda não está implementada na integração, por favor abrir um pedido de funcionalidade 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 esfregagem rigoroso e desativar aumento de potência em tapetes

  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