Dịch vụ Robot Hút Bụi

Tích hợp này cung cấp các dịch vụ tùy chỉnh khác nhau cho các hành động và tính năng nâng cao mà không thể điều khiển trực tiếp thông qua các thực thể tiêu chuẩn. Các dịch vụ tùy chỉnh này sử dụng miền vacuum và cung cấp quyền kiểm soát chi tiết các chức năng cụ thể của thiết bị.

Dọn phòng

dreame_vacuum.vacuum_clean_segment

Bắt đầu dọn dẹp phòng đã chọn với các tham số dọn dẹp tùy chỉnh tùy chọn.

Lưu ý

• Nếu bạn đang sử dụng tích hợp với tính năng bản đồ, bạn có thể lấy các ID phân đoạn từ các thuộc tính thực thể của máy hút bụi.
• Các tham số dọn dẹp và thứ tự dọn dẹp sẽ bị thiết bị bỏ qua khi customized_cleaning hoặc cleaning_sequence được bật.

Thiết lập chế độ dọn dẹp

Dịch vụ này không chấp nhận tham số cleaning_mode. Để đặt chế độ động trước khi bắt đầu dọn dẹp, xem Câu hỏi Thường Gặp.

Ví dụ

• Dọn phòng 3

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

• Dọn phòng 3 và 5

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

• Dọn phòng 3 và 5 hai lần

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

• Dọn phòng 2 hai lần và 5 một lần

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

• Dọn phòng 3 và 5 với tốc độ quạt cao

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

• Dọn phòng 3 với tốc độ quạt cao và 5 với tốc độ quạt êm

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

Làm sạch vùng

dreame_vacuum.vacuum_clean_zone

Bắt đầu làm sạch khu vực được chọn với các tham số làm sạch tùy chỉnh tùy chọn.

Mẹo

Bạn có thể lấy tọa độ khu vực bằng Thẻ Bản đồ Robot Hút Bụi Xiaomi.

Cài đặt Chế độ Làm sạch: Dịch vụ này không chấp nhận tham số cleaning_mode. Để cài đặt chế độ một cách linh hoạt trước khi bắt đầu làm sạch, hãy xem Câu hỏi Thường Gặp.

Ví dụ

• Làm sạch khu vực được chọn

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

• Làm sạch nhiều khu vực

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

• Làm sạch khu vực được chọn hai lần

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

• Làm sạch khu vực đầu tiên hai lần, khu vực thứ hai ba lần

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

Làm sạch điểm

dreame_vacuum.vacuum_clean_spot

Bắt đầu làm sạch điểm được chọn với các tham số làm sạch tùy chỉnh tùy chọn.

Lưu ý

Tính năng làm sạch điểm chỉ có sẵn cho robot mang thương hiệu Xiaomi/Mijia nhưng cũng hoạt động với các thiết bị Dreame.

Mẹo

Bạn có thể lấy tọa độ điểm bằng Thẻ Bản đồ Robot Hút Bụi Xiaomi.

Cài đặt Chế độ Làm sạch: Dịch vụ này không chấp nhận tham số cleaning_mode. Để cài đặt chế độ một cách linh hoạt trước khi bắt đầu làm sạch, hãy xem Câu hỏi Thường Gặp.

Ví dụ

• Làm sạch điểm được chọn

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

• Làm sạch nhiều điểm

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

• Làm sạch điểm được chọn hai lần

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

• Làm sạch điểm đầu tiên hai lần, điểm thứ hai ba lần

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

Đi đến điểm

dreame_vacuum.vacuum_goto

Gửi robot đến một tọa độ duy nhất trên bản đồ và dừng nó tại đó.

Lưu ý

• Trên các thiết bị có tính năng du ngoạn (máy hút bụi với dẫn đường lidar và phát trực tiếp camera), việc này sẽ bắt đầu một tác vụ du ngoạn tới điểm và robot sẽ chụp ảnh xung quanh điểm mục tiêu khi đến nơi. Tác vụ được lưu trong lịch sử du ngoạn. (Thêm về bản đồ lịch sử di chuyển)
• Trên các thiết bị khác, cùng hành vi được mô phỏng với một tác vụ làm sạch khu vực nhỏ quanh điểm đã cho. Mức hút được đặt ở chế độ yên tĩnh và việc lau nhà bị tắt cho tác vụ đó, và robot sẽ dừng lại và các cài đặt làm sạch trước đó được khôi phục bởi tích hợp ngay khi nó đến điểm.
• Mức pin phải ít nhất là 15% và tọa độ phải nằm trong bản đồ hiện tại.
• Thiết bị không phản hồi hành động này khi robot đã đứng trên tọa độ đã chọn, trạm đang xả pin hoặc trạm đang tự sửa/chạy kiểm tra.

Mẹo

Bạn có thể lấy tọa độ điểm bằng Thẻ Bản đồ Robot Hút Bụi Xiaomi.

Ví dụ

• Đi tới tại [819, -2235] và dừng lại

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

Đi theo lộ trình Thử nghiệm

dreame_vacuum.vacuum_follow_path

Bắt đầu một tác vụ đường đi du ngoạn đi qua các tọa độ đã cho từng điểm một và quay trở lại trạm sạc.

Cảnh báo

Thiết bị chỉ bị giới hạn thực hiện các tác vụ theo dõi đường đi khi phát trực tiếp camera đang hoạt động. Khác với Đi đến điểm, dịch vụ này gắn liền với camera và bạn phải mở camera từ Ứng dụng chính thức trước khi gọi nó. Nếu không, robot sẽ hoàn toàn bỏ qua yêu cầu và không làm gì cả.

Lưu ý

• Dịch vụ này chỉ có sẵn trên các thiết bị có tính năng đi tuần (máy hút bụi có dẫn đường bằng lidar và phát trực tiếp camera).
• Chỉ có 20 điểm đầu tiên được gửi đến thiết bị và mọi tọa độ phải nằm trong bản đồ hiện tại.
• Khi points bị bỏ qua, các điểm tuần lưu trữ của bản đồ hiện tại sẽ được sử dụng thay thế. Cần ít nhất một tọa độ hợp lệ hoặc đã lưu để bắt đầu công việc.
• Mức pin phải ít nhất 15% và thiết bị sẽ không phản hồi hành động này khi trạm đang xả năng lượng hoặc tự sửa chữa/kiểm tra.
• Bạn có thể lấy tọa độ điểm bằng Thẻ Bản đồ Robot Hút Bụi Xiaomi.

Ví dụ

• Theo dõi đường đi gồm ba điểm

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

• Theo dõi các điểm tuần đã lưu trên bản đồ hiện tại

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

Bắt đầu phím tắt

dreame_vacuum.vacuum_start_shortcut

Bắt đầu một tác vụ phím tắt được tạo trên Ứng dụng chính thức.

Lưu ý

• Các phím tắt chỉ khả dụng trên các thiết bị được hỗ trợ và bạn có thể lấy ID phím tắt từ thuộc tính shortcuts của thiết bị hút bụi.
• Các ID phím tắt hợp lệ nằm trong khoảng từ 25 đến 128.
• Tích hợp cũng tạo một thực thể nút cho mỗi phím tắt của thiết bị dưới dạng button.{vacuum_name}_shortcut_{shortcut_id}, do đó việc sử dụng dịch vụ này thường không cần thiết.
• Thiết bị không phản hồi hành động này khi trạm đang xả nước hoặc tự sửa chữa/kiểm tra.

Ví dụ

• Bắt đầu phím tắt với ID 32

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

Đổi tên phím tắt

dreame_vacuum.vacuum_rename_shortcut

Đặt tên tùy chỉnh cho một phím tắt.

Lưu ý

• Bạn có thể lấy ID phím tắt từ thuộc tính shortcuts của thiết bị hút bụi.
• Tên phím tắt phải duy nhất. Khi tên mới đã được sử dụng bởi một phím tắt khác, một số được thêm vào như ứng dụng chính thức. (Ví dụ: Mopping after sweeping trở thành Mopping after sweeping2)
• Tên của thực thể nút phím tắt được tạo theo tên phím tắt.
• Không thể đổi tên phím tắt khi robot đang hoạt động.

Ví dụ

• Đổi tên phím tắt với ID 32 thành "Lau sàn sau khi quét"

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

Xóa phím tắt

dreame_vacuum.vacuum_delete_shortcut

Xóa một phím tắt.

Lưu ý

• Bạn có thể lấy ID phím tắt từ thuộc tính shortcuts của thiết bị hút bụi.
• Thực thể nút của phím tắt đã bị xóa sẽ được loại bỏ tự động.
• Một phím tắt không thể bị xóa khi nhiệm vụ của nó đang chạy.
• Các phím tắt đã xóa không thể được khôi phục và chỉ có thể được tạo lại từ ứng dụng chính thức.

Ví dụ

• Xóa phím tắt có id 34

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

Cài đặt gói giọng nói

dreame_vacuum.vacuum_install_voice_pack

Cài đặt gói giọng nói chính thức.

Cài đặt thứ tự làm sạch Hỗ trợ Bản đồ

dreame_vacuum.vacuum_set_cleaning_sequence

Thiết lập thứ tự dọn dẹp phòng trên bản đồ hiện tại.

Lưu ý

Số lượng chính xác các id phòng phải được truyền dưới dạng danh sách thứ tự

Ví dụ

• Thiết lập thứ tự dọn dẹp phòng trên bản đồ hiện tại theo 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

• Vô hiệu hóa thứ tự dọn dẹp tùy chỉnh trên bản đồ hiện tại

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

Cài đặt làm sạch tùy chỉnh Hỗ trợ Bản đồ

dreame_vacuum.vacuum_set_custom_cleaning

Thiết lập các thông số dọn dẹp phòng tùy chỉnh trên bản đồ hiện tại.

Lưu ý

Cài đặt cho tất cả các phòng phải được truyền dưới dạng danh sách

Ví dụ

• Thiết lập tốc độ quạt phòng 1 thành im lặng, mức nước thành thấp, số lần dọn dẹp thành 2 và tốc độ quạt phòng 5 thành turbo, mức nước thành trung bình, số lần lặp lại thành 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

• Thiết lập mức độ ẩm phòng 3 thành 16

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

Đặt lại vật tiêu hao

dreame_vacuum.vacuum_reset_consumable

Đặt lại tuổi thọ vật tiêu hao theo loại.

Giá trị có thể cho vật tiêu hao

• 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

Ví dụ

• Đặt lại tuổi thọ chổi chính

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

• Đặt lại tuổi thọ miếng lau

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

Điều khiển từ xa Không khuyến nghị

dreame_vacuum.vacuum_remote_control_move_step

Gửi lệnh điều khiển từ xa đến máy hút bụi.

Gửi lệnh Không khuyến nghị

vacuum.send_command

Dịch vụ gửi lệnh có thể được sử dụng để gửi các yêu cầu API thô mà tích hợp này không hỗ trợ.

Chỉ dành cho việc thử nghiệm

Không khuyến nghị người dùng cuối sử dụng dịch vụ này trực tiếp. Nếu có một hành động yêu cầu sử dụng dịch vụ này vì nó chưa được triển khai trong tích hợp, vui lòng mở yêu cầu tính năng thay vào đó.

Mẹo

Thông tin thêm về các lệnh và tham số.

Ví dụ

• Bắt đầu tự động làm trống

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

• Bật chế độ lau chặt và tắt tăng cường thảm

  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