บริการเครื่องดูดฝุ่น

การรวมระบบนี้เปิดเผยบริการกำหนดเองต่าง ๆ สำหรับการดำเนินการและฟีเจอร์ขั้นสูงที่ไม่สามารถควบคุมได้โดยตรงผ่านเอนทิตีมาตรฐาน บริการกำหนดเองเหล่านี้ใช้โดเมน 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

ส่งหุ่นยนต์ไปยังพิกัดเดียวบนแผนที่และหยุดที่นั่น

หมายเหตุ

• บนอุปกรณ์ที่มีฟีเจอร์ครูสซิ่ง (เครื่องดูดฝุ่นที่มีการนำทางด้วยไลดาร์และการสตรีมกล้อง) การกระทำนี้จะเริ่มงาน ครูสไปยังจุด และหุ่นยนต์จะถ่ายภาพรอบ ๆ จุดเป้าหมายเมื่อไปถึง งานนี้จะถูกบันทึกในประวัติการครูสซิ่ง (เพิ่มเติมเกี่ยวกับแผนที่ประวัติการเดินทาง)
• บนอุปกรณ์อื่น ๆ พฤติกรรมเดียวกันนี้จะถูกจำลองด้วยงานทำความสะอาดโซนเล็ก ๆ รอบจุดที่กำหนด ระดับการดูดถูกตั้งค่าเป็นเงียบและการถูพื้นถูกปิดใช้งานสำหรับงานนั้น และหุ่นยนต์จะหยุดและการตั้งค่าการทำความสะอาดก่อนหน้าจะถูกคืนค่าโดยการรวมระบบทันทีที่หุ่นยนต์ไปถึงจุด
• ระดับแบตเตอรี่ต้องไม่น้อยกว่า 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 เป็น "Mopping after sweeping"

  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 ของเอนทิตีเครื่องดูดฝุ่น
• เอนทิตีปุ่มของทางลัดที่ถูกลบจะถูกลบโดยอัตโนมัติ
• ไม่สามารถลบทางลัดได้ในขณะที่งานของมันกำลังทำงานอยู่
• ทางลัดที่ถูกลบไม่สามารถกู้คืนได้และสามารถสร้างขึ้นใหม่ได้เฉพาะจากแอปอย่างเป็นทางการ

ตัวอย่าง

• ลบทางลัดที่มี id 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