خدمات الخريطة

خدمات تعديل الخرائط تستخدم أيضًا مجال المكنسة لأن جميع الخدمات متاحة حتى بدون اتصال بالسحابة.

طلب خريطة

dreame_vacuum.vacuum_request_map

طلب من الجهاز رفع خريطة جديدة إلى السحابة. (تكون هذه الخدمة مفيدة عند عدم استخدام اتصال السحابة واستخدام تكامل آخر لمعالجة عرض الخريطة)

مهم

الجهاز لا يستجيب لهذا الإجراء عند:

• تنظيف بقعة
• رسم خرائط سريع
• النقل
• بعد تعديل الخريطة حتى يتحرك

تحديد الخريطة

dreame_vacuum.vacuum_select_map

تغيير الخريطة المحددة حاليًا. (وذلك ممكن فقط إذا تم تمكين خريطة متعددة الطوابق)

ملاحظة

• يمكنك الحصول على معرف الخريطة من خصائص كيان كاميرا الخريطة المحفوظة.
• سينهي الروبوت المهمة النشطة عند تغيير الخريطة المحددة.

مثال

• تعيين الخريطة الحالية كخريطة بالمعرف 27

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

حذف الخريطة

dreame_vacuum.vacuum_delete_map

حذف الخريطة.

ملاحظة

• يمكنك الحصول على معرف الخريطة من خصائص كيان كاميرا الخريطة المحفوظة.
• عند تمكين ميزة الخريطة متعددة الطوابق قد تتغير فهارس الخرائط بعد الحذف. (المزيد عن دعم الخريطة متعددة الطوابق)

مثال

• حذف الخريطة بالمعرف 48

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

إعادة تسمية الخريطة

dreame_vacuum.vacuum_rename_map

إعادة تسمية الخريطة.

ملاحظة

• يمكنك الحصول على معرف الخريطة من خصائص كيان كاميرا الخريطة المحفوظة.
• التطبيق الرسمي لا يسمح لك بإدخال رموز خاصة في اسم الخريطة ولكن هذا التكامل يسمح بذلك لذا استخدم هذه الخدمة بحذر.

مثال

• إعادة تسمية الخريطة بالمعرف 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

استبدال الخريطة الجديدة بأخرى قديمة.

ملاحظة

• يمكنك الحصول على معرف الخريطة من خصائص كيان كاميرا الخريطة المحفوظة.
• عند تمكين ميزة الخرائط متعددة الطوابق قد تتغير مؤشرات الخرائط بعد استبدال الخريطة. ستظل الخريطة الجديدة المستبدلة دائمًا في آخر مؤشر متاح حتى لو تم استبدالها بخريطة ذات مؤشر أقل. (المزيد عن دعم الخريطة متعددة الطوابق)

مثال

• استبدال الخريطة الجديدة بالخريطة ذات المعرف 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