שירותי מפה

שירותי עריכת מפה משתמשים גם בתחום השואב מכיוון שכל השירותים זמינים גם ללא חיבור לענן.

בקשת מפה

dreame_vacuum.vacuum_request_map

בקש מהמכשיר להעלות מפה חדשה לענן. (שירות זה שימושי כאשר לא משתמשים בחיבור ענן ושילוב אחר משמש לעיבוד הצגת המפה)

חשוב

המכשיר לא מגיב לפעולה זו כאשר:

• ניקוי נקודתי
• מיפוי מהיר
• בתהליך הזזה
• לאחר עריכת מפה עד שהמכשיר זז

בחירת מפה

dreame_vacuum.vacuum_select_map

שינוי המפה הנבחרת כרגע. (אפשרי רק כאשר מפה רב-קומות מופעלת)

הערה

• ניתן להשיג את מזהה המפה מ-attributים של ישות מצלמת המפה השמורה.
• הרובוט יסיים את העבודה הפעילה כאשר המפה הנבחרת משתנה.

דוגמה

• קבע את המפה הנוכחית כמפה עם מזהה 27

  service: dreame_vacuum.vacuum_select_map
  data:
      map_id: 27
  target:
      entity_id: vacuum.vacuum

מחיקת מפה

dreame_vacuum.vacuum_delete_map

מחיקת מפה קיימת.

הערה

• ניתן להשיג את מזהה המפה מ-attributים של ישות מצלמת המפה השמורה.
• כאשר תכונת המפות הרב-קומתיות מופעלת, אינדקסי המפות עשויים להשתנות לאחר מחיקה. (פרטים נוספים על תמיכה במפות רב-קומתיות)

דוגמה

• קבע מחיקת מפה עם מזהה 48

  service: dreame_vacuum.vacuum_delete_map
  data:
      map_id: 48
  target:
      entity_id: vacuum.vacuum

שינוי שם המפה

dreame_vacuum.vacuum_rename_map

משנה את שם המפה.

הערה

• ניתן להשיג את מזהה המפה מ-attributים של ישות מצלמת המפה השמורה.
• האפליקציה הרשמית לא מאפשרת להזין תווים מיוחדים בשם המפה אך שילוב זה מאפשר זאת, לכן השתמש בשירות זה בזהירות.

דוגמה

• שנה שם של מפה עם מזהה 14 ל"קומה שנייה"

  service: dreame_vacuum.vacuum_rename_map
  data:
      map_id: 14
      map_name: "Second Floor"
  target:
      entity_id: vacuum.vacuum

שחזור מפה תמיכה במפה

dreame_vacuum.vacuum_restore_map

שחזר מפה ממצב קודם שנוצר והועלה על ידי המכשיר.

הערה

• אין ערובה שהשחזור של המפה יהיה מוצלח. הענן לא שומר את הקבצים לנצח וקבצי השחזור בדרך כלל נמחקים מהענן לאחר 365 ימים מהגישה האחרונה.

דוגמאות

• שחזר מפה נבחרת למפת השחזור השנייה ברשימת מפות השחזור

  service: dreame_vacuum.vacuum_restore_map
  data:
      recovery_map_index: 2
  target:
      entity_id: vacuum.vacuum

• שחזר את המפה השמורה עם מזהה 14 למצב המקורי

  service: dreame_vacuum.vacuum_restore_map
  data:
      map_id: 14
      recovery_map_index: 1
  target:
      entity_id: vacuum.vacuum

שחזור מפה מקובץ

dreame_vacuum.vacuum_restore_map_from_file

שחזר מפה מקובץ מפת שחזור ששמור קודם.

הערה

• ניתן להשתמש בשירות זה לשחזור לא מקוון אם תוריד ותמקם את קובץ מפת השחזור בתיקיית /www/ של Home Assistant (השאיבה והשרת חייבים להיות באותה הרשת).
• מזהה המפה נדרש אם חיבור לענן לא מופעל.

דוגמאות

• שחזר מפה נבחרת מקובץ מפת שחזור שמורה

  service: dreame_vacuum.vacuum_restore_map_from_file
  data:
      file_url: http://192.168.1.10/local/2023-11-04-1724223415-423528451_284320462.1156.mb.tbz2
  target:
      entity_id: vacuum.vacuum

• שחזר את המפה השמורה עם מזהה 14 מקובץ מפת השחזור השמורה

  service: dreame_vacuum.vacuum_restore_map_from_file
  data:
      map_id: 14
      file_url: https://dreame-cn.oss-cn-shanghai.aliyuncs.com/iot/tmp/000000/ali_dreame/YR649291/648921668/101?Expires=1699189998&OSSAccessKeyId=LTAI5t96WkBXXNzQrX4HtQti&Signature=ttRrjg8p7aC650H3DwI3%2F2ngOOE%3D
  target:
      entity_id: vacuum.vacuum

גיבוי מפה

dreame_vacuum.vacuum_backup_map

הפעל העלאה של מפה שמורה כמפת שחזור לענן.

הערה

• הענן יכול לאחסן רק גיבוי אחד לכל מפה שנשמרה. שירות זה יחליף את מפה הגיבוי הקודמת אם קיימת.
• שואבים ללא מצלמה או חיישן ליידר אינם כוללים תכונה זו, הטריגר לגיבוי מפה פועל רק על מכשירים נתמכים.

דוגמאות

• הפעל גיבוי למפה שנבחרה

  service: dreame_vacuum.vacuum_backup_map
  target:
      entity_id: vacuum.vacuum

• הפעל גיבוי למפה עם מזהה 15

  service: dreame_vacuum.vacuum_backup_map
  data:
      map_id: 15
  target:
      entity_id: vacuum.vacuum

שמירת מפה זמנית

dreame_vacuum.vacuum_save_temporary_map

שמור מפה שנוצרה לאחרונה. (המכשיר מבקש ממך לעשות זאת כאשר המפה הראשונה נוצרה לאחר איפוס למפעל)

ביטול מפה זמנית

dreame_vacuum.vacuum_discard_temporary_map

ביטול מפה שנוצרה לאחרונה.

החלפת מפה זמנית

dreame_vacuum.vacuum_replace_temporary_map

החלף את המפה החדשה במפה ישנה.

הערה

• ניתן להשיג את מזהה המפה מ-attributים של ישות מצלמת המפה השמורה.
• כאשר תכונת מפת קומות מרובה מופעלת, אינדקסי המפות עשויים להשתנות לאחר החלפת המפה. המפה החדשה שהוחלפה תמיד תהיה באינדקס האחרון הזמין גם אם הוחלפה במפה עם אינדקס נמוך יותר. (פרטים נוספים על תמיכה במפות רב-קומתיות)

דוגמה

• החלף את המפה החדשה במפה עם מזהה 39

  service: dreame_vacuum.vacuum_replace_temporary_map
  data:
      map_id: 39
  target:
      entity_id: vacuum.vacuum

שנה שם חדר

dreame_vacuum.vacuum_rename_segment

הגדר שם מותאם אישית לחדר במפה הנוכחית.

הערה

• ניתן להשיג מזהי מפה ומקטעים מתכונות היישות של המצלמה במפה שנשמרה.
• האפליקציה הרשמית אינה מאפשרת להזין תווים מיוחדים בשם החדר אך אינטגרציה זו מאפשרת זאת, לכן השתמש בשירות זה בזהירות.

דוגמה

• שנה את שם החדר 3 ל"חדר אוכל"

  service: dreame_vacuum.vacuum_rename_segment
  data:
      segment_id: 3
      segment_name: "Dining Room"
  target:
      entity_id: vacuum.vacuum

הגדר התעלמות ממכשול תמיכה במפה

dreame_vacuum.vacuum_set_obstacle_ignore

קבע את מצב ההתעלמות מהמכשול שזוהה במפה הנוכחית כדי שהרובוט לא יימנע ממנו בעבודות הבאות.

הערה

• שירות זה זמין רק באבקות עם אפשרות זיהוי מכשולים מבוססת בינה מלאכותית ודורש חיבור לענן.
• ניתן להשיג את קואורדינאטות המכשול ואת מצב ההתעלמות הנוכחי שלו מהתכונה obstacles של ישות מצלמת המפה הנוכחית. (עוד על מכשולים)
• הקואורדינאטות חייבות להתאים במדויק למכשול קיים במפה הנוכחית, אחרת הפעולה תידחה.
• מכשולים שמתעלמים מהם אוטומטית על ידי המכשיר אינם ניתנים לשינוי עם שירות זה.
• מצב ההתעלמות מהמכשול אינו ניתן לשינוי בזמן שהרובוט פועל.

דוגמאות

• להתעלם מהמכשול ב-[819, -263]

  service: dreame_vacuum.vacuum_set_obstacle_ignore
  data:
      x: 819
      y: -263
      obstacle_ignored: true
  target:
      entity_id: vacuum.vacuum

• הפסק להתעלם מהמכשול ב-[819, -263]

  service: dreame_vacuum.vacuum_set_obstacle_ignore
  data:
      x: 819
      y: -263
      obstacle_ignored: false
  target:
      entity_id: vacuum.vacuum

שירותים נוספים תמיכה במפה

שירותי ניהול מפות נוספים נחשפים על ידי האינטגרציה. כמה מהפרמטרים הללו (כגון חומר הרצפה, נראות החדר וסוג המגב) כבר נחשפים וניתנים לתצורה ישירה דרך ישויות חדרים, מה שהופך את השימוש הישיר בשירותים אלו ללא הכרחי.

לא מיועד למשתמשי קצה

שירותים אלה נחשפים אך ורק לשימוש ה-כרטיס שואב Dreame. אין להם פרמטרים הנגישים בקלות למשתמשי קצה. אם נשלחים פרמטרים לא תקפים, הם עשויים להיות מועברים ישירות למכשיר, דבר שיכול לגרום לבעיות חמורות כגון מפות מקולקלות או כניסת המכשיר ללולאת אתחול. לכן, אין להשתמש בשירותים אלו אלא אם הפונקציונליות המדויקת ומבנה הפרמטרים מובנים במלואם. מסיבות בטיחותיות, שירותים אלה אינם כלולים ב-services.yaml ואינם כוללים מחרוזות תרגום.

• קבע אזור שטיח: dreame_vacuum.vacuum_set_carpet_area
• קבע סוג שטיח: dreame_vacuum.vacuum_set_carpet_type
• קבע וילון: dreame_vacuum.vacuum_set_curtain
• קבע ניקוי שטיח מותאם אישית: dreame_vacuum.vacuum_set_custom_carpet_cleaning
• קבע חומר רצפה: dreame_vacuum.vacuum_set_floor_material
• קבע רהיטים: dreame_vacuum.vacuum_set_furniture
• קבע קטעים מוסתרים: dreame_vacuum.vacuum_set_hidden_segments
• הגדר אזור נמוך: dreame_vacuum.vacuum_set_low_lying_area
• הגדר סוג מטאטא: dreame_vacuum.vacuum_set_mop_type
• הגדר נקודות מוגדרות מראש: dreame_vacuum.vacuum_set_predefined_points
• הגדר אזורים מוגבלים: dreame_vacuum.vacuum_set_restricted_zone
• הגדר מיקום נתב: dreame_vacuum.vacuum_set_router_position
• הגדר סוג קטע: dreame_vacuum.vacuum_set_segment_type
• הגדר סף: dreame_vacuum.vacuum_set_threshold
• הגדר סף וירטואלי: dreame_vacuum.vacuum_set_virtual_threshold
• הגדר קירות: dreame_vacuum.vacuum_set_walls
• מיזוג חדרים: dreame_vacuum.vacuum_merge_segments
• חלק חדר: dreame_vacuum.vacuum_split_segments