Вакуумные сервисы

Интеграция предоставляет различные пользовательские сервисы для выполнения расширенных действий и функций, которые нельзя напрямую контролировать с помощью стандартных сущностей. Эти пользовательские сервисы используют домен vacuum и обеспечивают детальный контроль над функционалом конкретных устройств.

Очистка комнаты

dreame_vacuum.vacuum_clean_segment

Начните уборку выбранной комнаты с возможностью настройки параметров уборки.

Примечание

• Если вы используете интеграцию с функцией карты, вы можете получить идентификаторы сегментов из атрибутов сущности пылесоса.
• Параметры уборки и последовательность уборки игнорируются устройством, когда включен customized_cleaning или cleaning_sequence.

Установка режима уборки

Этот сервис не принимает параметр cleaning_mode. Чтобы динамически установить режим перед началом уборки, смотрите ЧАВО.

Примеры

• Убирать комнату 3

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

• Убирать комнаты 3 и 5

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

• Убирать комнаты 3 и 5 два раза

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

• Убирать комнату 2 два раза и 5 один раз

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

• Убирать комнаты 3 и 5 на высокой скорости вентилятора

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

• Убирать комнату 3 на высокой скорости вентилятора и комнату 5 на тихой скорости вентилятора

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

Очистить зону

dreame_vacuum.vacuum_clean_zone

Запустите уборку выбранной зоны с параметрами уборки по желанию.

Советы

Вы можете получить координаты зоны с помощью Карты вакуумного робота Xiaomi.

Настройка режима уборки: Эта услуга не принимает параметр cleaning_mode. Чтобы динамически установить режим перед началом уборки, см. ЧАВО.

Примеры

• Убрать выбранную зону

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

• Убрать несколько зон

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

• Убрать выбранную зону дважды

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

• Сначала убрать первую зону дважды, вторую зону трижды

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

Очистить точку

dreame_vacuum.vacuum_clean_spot

Запустите уборку выбранного участка с параметрами уборки по желанию.

Примечание

Функция уборки участков доступна только для роботов брендов Xiaomi/Mijia, но также работает с устройствами Dreame.

Советы

Вы можете получить координаты точек с помощью Карты вакуумного робота Xiaomi.

Настройка режима уборки: Эта услуга не принимает параметр cleaning_mode. Чтобы динамически установить режим перед началом уборки, см. ЧАВО.

Примеры

• Убрать выбранную точку

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

• Убрать несколько точек

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

• Убрать выбранную точку дважды

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

• Сначала убрать первую точку дважды, вторую точку трижды

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

Перейти в Точку

dreame_vacuum.vacuum_goto

Отправьте робота к одной координате на карте и остановите его там.

Примечание

• На устройствах с функцией круизного движения (пылесосы с навигацией LIDAR и потоковой передачей с камеры) это запускает задание круиз к точке, и робот делает фотографии вокруг целевой точки по прибытии. Задание сохраняется в истории круизных маршрутов. (Подробнее о картах истории движения)
• На других устройствах такое же поведение имитируется с помощью небольшого задания по уборке зоны вокруг указанной точки. Уровень всасывания устанавливается на тихий режим, а функция влажной уборки отключена для этого задания, и интеграция останавливает робота и восстанавливает предыдущие настройки уборки, как только он достигает точки.
• Уровень заряда батареи должен быть не менее 15%, а координата должна находиться внутри текущей карты.
• Устройство не реагирует на это действие, если робот уже стоит на выбранной координате, станция разряжается или станция находится в процессе самовосстановления/тестирования.

Советы

Вы можете получить координаты точек с помощью Карты вакуумного робота Xiaomi.

Пример

• Перейти к [819, -2235] и остановиться

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

Следовать по пути Экспериментально

dreame_vacuum.vacuum_follow_path

Запустить задание по круизному маршруту, которое посещает указанные координаты по очереди и возвращается к док-станции.

Предупреждение

Устройство ограничено выполнением задач по следованию по маршруту только при активной трансляции с камеры в реальном времени. В отличие от Перейти в Точку, эта услуга привязана к камере, и вы должны открыть камеру через официальное приложение перед её вызовом. В противном случае робот полностью игнорирует запрос и ничего не делает.

Примечание

• Эта услуга доступна только на устройствах с функцией круиза (пылесосы с лидарами и потоковой передачей видео с камеры).
• На устройство отправляются только первые 20 точек, и каждая координата должна находиться внутри текущей карты.
• Когда points опущено, используются сохранённые точки круиза текущей карты. Для запуска задачи требуется хотя бы одна действительная или сохранённая координата.
• Уровень заряда батареи должен быть не менее 15%, а устройство не реагирует на это действие, пока станция разряжает батарею или проводит самопроверку/тестирование.
• Вы можете получить координаты точек с помощью Карты вакуумного робота Xiaomi.

Примеры

• Следовать маршруту из трёх точек

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

• Следовать сохранённым точкам круиза текущей карты

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

Запустить ярлык

dreame_vacuum.vacuum_start_shortcut

Запустить задачу ярлыка, созданную в официальном приложении.

Примечание

• Ярлыки доступны только на поддерживаемых устройствах, и вы можете получить идентификаторы ярлыков из атрибута shortcuts сущности пылесоса.
• Допустимые идентификаторы ярлыков находятся в диапазоне от 25 до 128.
• Интеграция также создает сущность кнопки для каждого ярлыка устройства как button.{vacuum_name}_shortcut_{shortcut_id}, поэтому использование этой службы обычно не требуется.
• Устройство не реагирует на это действие, пока станция сливает воду или выполняет самовосстановление/тестирование.

Пример

• Запустите ярлык с идентификатором 32

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

Переименовать ярлык

dreame_vacuum.vacuum_rename_shortcut

Установите собственное имя для ярлыка.

Примечание

• Вы можете получить идентификаторы ярлыков из атрибута shortcuts сущности пылесоса.
• Имена ярлыков должны быть уникальными. Когда новое имя уже используется другим ярлыком, к нему добавляется счетчик, как это делает официальное приложение. (Например: Mopping after sweeping становится Mopping after sweeping2)
• Имя создаваемой сущности кнопки ярлыка соответствует имени ярлыка.
• Ярлыки не могут быть переименованы, пока робот работает.

Пример

• Переименуйте ярлык с идентификатором 32 в "Мытьё после подметания"

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

Удалить ярлык

dreame_vacuum.vacuum_delete_shortcut

Удалите ярлык.

Примечание

• Вы можете получить идентификаторы ярлыков из атрибута shortcuts сущности пылесоса.
• Сущность кнопки удаленного ярлыка удаляется автоматически.
• Ярлык нельзя удалить, пока выполняется его собственная задача.
• Удаленные ярлыки не могут быть восстановлены и могут быть созданы заново только через официальное приложение.

Пример

• Удалить ярлык с идентификатором 34

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

Установить голосовой пакет

dreame_vacuum.vacuum_install_voice_pack

Установить официальный голосовой пакет.

Установить последовательность уборки Поддержка карт

dreame_vacuum.vacuum_set_cleaning_sequence

Установить последовательность уборки комнат на текущей карте.

Примечание

Необходимо передать точное количество идентификаторов комнат в виде списка последовательности

Пример

• Установить последовательность уборки комнат на текущей карте в порядке 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

• Отключить пользовательскую последовательность уборки на текущей карте

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

Установить пользовательскую уборку Поддержка карт

dreame_vacuum.vacuum_set_custom_cleaning

Установить параметры уборки для отдельных комнат на текущей карте.

Примечание

Настройки для всех комнат должны быть переданы в виде списка

Примеры

• Установить для комнаты 1 скорость вентилятора на «тихо», уровень воды на «низкий», количество уборок на 2 и для комнаты 5 скорость вентилятора на «турбо», уровень воды на «средний», повторов на 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

• Установить уровень влажности для комнаты 3 на 16

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

Сбросить расход аксессуаров

dreame_vacuum.vacuum_reset_consumable

Сбросить срок службы расходного материала по типу.

Возможные значения расходного материала

• 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

Примеры

• Сбросить срок службы основной щетки

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

• Сбросить срок службы насадки для швабры

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

Управление Не рекомендуется

dreame_vacuum.vacuum_remote_control_move_step

Отправить команду пульту управления для пылесоса.

Отправить команду Не рекомендуется

vacuum.send_command

Сервис отправки команд можно использовать для отправки необработанных API-запросов, которые недоступны через эту интеграцию.

Только для экспериментального использования

Не рекомендуется конечным пользователям использовать этот сервис напрямую. Если есть действие, которое требует использования этого сервиса, потому что оно еще не реализовано в интеграции, пожалуйста, отправить запрос на добавление функции вместо этого.

Советы

Подробнее о командах и параметрах.

Примеры

• Начать автоматическую очистку

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

• Включить плотный режим мытья и отключить функцию усиления на ковре

  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