خدمات نقشه

خدمات ویرایش نقشه همچنین از دامنه جاروبرقی استفاده می‌کند زیرا همه خدمات حتی بدون اتصال به ابر در دسترس هستند.

درخواست نقشه

dreame_vacuum.vacuum_request_map

درخواست از دستگاه برای بارگذاری نقشه جدید در ابر. (این سرویس زمانی مفید است که از اتصال به ابر استفاده نمی‌شود و یک ادغام دیگر برای مدیریت رندر نقشه استفاده می‌شود)

مهم

دستگاه به این اقدام پاسخ نمی‌دهد وقتی که:

تمیزکاری نقطه‌ای
نقشه‌برداری سریع
در حال جابجایی
بعد از ویرایش نقشه تا زمانی که حرکت کند

انتخاب نقشه

dreame_vacuum.vacuum_select_map

تغییر نقشه انتخاب‌شده فعلی. (فقط در صورتی که نقشه چندطبقه فعال باشد ممکن است)

توجه

شما می‌توانید شناسه نقشه را از ویژگی‌های موجود دوربین نقشه ذخیره شده به دست آورید.
ربات وقتی نقشه انتخاب‌شده تغییر می‌کند، کار فعال را متوقف خواهد کرد.

مثال

تعیین نقشه فعلی به عنوان نقشه با شناسه 27

yaml

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

حذف نقشه

dreame_vacuum.vacuum_delete_map

حذف یک نقشه.

توجه

شما می‌توانید شناسه نقشه را از ویژگی‌های موجود دوربین نقشه ذخیره شده به دست آورید.
هنگامی که ویژگی نقشه چندطبقه فعال است، شاخص‌های نقشه ممکن است بعد از حذف تغییر کنند. (اطلاعات بیشتر درباره پشتیبانی نقشه چندطبقه)

مثال

حذف نقشه با شناسه 48

yaml

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

تغییر نام نقشه

dreame_vacuum.vacuum_rename_map

تغییر نام یک نقشه.

توجه

شما می‌توانید شناسه نقشه را از ویژگی‌های موجود دوربین نقشه ذخیره شده به دست آورید.
برنامه رسمی اجازه نمی‌دهد تا کاراکترهای ویژه در نام نقشه وارد کنید اما این ادغام این امکان را می‌دهد، پس از این سرویس با احتیاط استفاده کنید.

مثال

تغییر نام نقشه با شناسه ۱۴ به «طبقه دوم»

yaml

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

بازیابی نقشه پشتیبانی از نقشه

dreame_vacuum.vacuum_restore_map

بازیابی نقشه‌ای از حالت قبلی که توسط دستگاه ایجاد و آپلود شده است.

توجه

تضمین نمی‌شود که بازیابی نقشه موفقیت‌آمیز باشد. ابر فایل‌ها را برای همیشه ذخیره نمی‌کند و فایل‌های بازیابی معمولاً ۳۶۵ روز پس از آخرین دسترسی از ابر حذف می‌شوند.

نمونه‌ها

بازیابی نقشه انتخاب‌شده به دومین نقشه بازیابی ذخیره‌شده در لیست نقشه‌های بازیابی
yaml
```
service: dreame_vacuum.vacuum_restore_map
data:
    recovery_map_index: 2
target:
    entity_id: vacuum.vacuum
```

بازیابی نقشه ذخیره‌شده با شناسه ۱۴ به حالت اصلی

yaml

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 قرار دهید (جاروبرقی و سرور باید در یک شبکه باشند).
شناسه نقشه در صورت فعال نبودن اتصال به ابر لازم است.

نمونه‌ها

بازیابی نقشه انتخاب‌شده از فایل نقشه بازیابی ذخیره‌شده

yaml

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

بازیابی نقشه ذخیره‌شده با فایل نقشه بازیابی ذخیره‌شده شناسه ۱۴

yaml

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

فعال‌سازی آپلود یک نقشه ذخیره‌شده به عنوان نقشه بازیابی در ابر.

توجه

ابر می‌تواند فقط یک نقشه پشتیبان برای هر نقشه ذخیره‌شده نگه دارد. این سرویس نقشه پشتیبان قبلی را در صورتی که موجود باشد، بازنویسی خواهد کرد.
جاروی رباتی بدون دوربین یا حسگر لیدار این قابلیت را ندارد، فعال‌سازی پشتیبان‌گیری نقشه فقط روی دستگاه‌های پشتیبانی‌شده کار می‌کند.

نمونه‌ها

فعال‌سازی پشتیبان‌گیری از نقشه انتخاب‌شده

yaml

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

فعال‌سازی پشتیبان‌گیری از نقشه با شناسه ۱۵

yaml

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

جایگزینی نقشه جدید با نقشه قدیمی.

توجه

شما می‌توانید شناسه نقشه را از ویژگی‌های موجود دوربین نقشه ذخیره شده به دست آورید.
زمانی که قابلیت نقشه چند طبقه فعال باشد، شاخص‌های نقشه ممکن است پس از جایگزینی نقشه تغییر کنند. نقشه جدید جایگزین شده همیشه در آخرین شاخص موجود قرار می‌گیرد حتی اگر با نقشه‌ای با شاخص پایین‌تر جایگزین شده باشد. (اطلاعات بیشتر درباره پشتیبانی نقشه چندطبقه)

مثال

جایگزینی نقشه جدید با نقشه با شناسه ۳۹

yaml

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

تغییر نام اتاق

dreame_vacuum.vacuum_rename_segment

تعیین نام دلخواه برای یک اتاق در نقشه فعلی.

توجه

شما می‌توانید شناسه‌های نقشه و بخش‌ها را از ویژگی‌های موجود در دوربین نقشه ذخیره‌شده به‌دست آورید.
اپلیکیشن رسمی اجازه نمی‌دهد تا کاراکترهای خاص در نام اتاق وارد کنید، اما این یکپارچگی چنین امکانی را می‌دهد، بنابراین از این سرویس با احتیاط استفاده کنید.

مثال

نام اتاق ۳ را به «سالن غذاخوری» تغییر دهید

yaml

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] را نادیده بگیرید

yaml

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

نادیده گرفتن مانع در [819, -263] را متوقف کنید

yaml

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

خدمات نقشه ​

درخواست نقشه ​

انتخاب نقشه ​

حذف نقشه ​

تغییر نام نقشه ​

بازیابی نقشه پشتیبانی از نقشه ​

بازیابی نقشه از فایل ​

پشتیبان‌گیری نقشه ​

ذخیره نقشه موقت ​

حذف نقشه موقت ​

جایگزینی نقشه موقت ​

تغییر نام اتاق ​

تنظیم نادیده‌گرفتن مانع پشتیبانی از نقشه ​

سایر سرویس‌ها پشتیبانی از نقشه ​

خدمات نقشه

درخواست نقشه

انتخاب نقشه

حذف نقشه

تغییر نام نقشه

بازیابی نقشه پشتیبانی از نقشه

بازیابی نقشه از فایل

پشتیبان‌گیری نقشه

ذخیره نقشه موقت

حذف نقشه موقت

جایگزینی نقشه موقت

تغییر نام اتاق

تنظیم نادیده‌گرفتن مانع پشتیبانی از نقشه

سایر سرویس‌ها پشتیبانی از نقشه