نصب و استفاده

این راهنما توضیح می‌دهد که چگونه کارت Dreame Vacuum را روی داشبورد Home Assistant اجرا کنید. این شامل پیش‌نیازهای یکپارچگی، مراحل افزودن کارت به داشبوردهای موجود و دستورالعمل‌هایی برای تنظیم حالت پیشنهادی Panel Mode است. حالت پنل بهترین تجربه ممکن را با استفاده از تمام صفحه فراهم می‌کند و به‌ویژه روی تبلت‌ها و مانیتورهای دسکتاپ قدرتمند است.

---

کارت Dreame Vacuum به‌طور کامل به‌عنوان بخشی اصلی از یکپارچگی Dreame Vacuum با Home Assistant یکپارچه شده است. این کارت نیست یک کارت مستقل که به‌صورت جداگانه نصب شود.

برای استفاده از این کارت، نسخه dreame_vacuum یکپارچگی v2.0.0 یا بالاتر که کارت را به‌صورت داخلی شامل می‌شود، باید نصب شده باشد.

پیش‌نیاز

اگر یکپارچگی Dreame Vacuum قبلاً نصب شده باشد، این مرحله می‌تواند به‌طور امن نادیده گرفته شود.

اگر هنوز نصب نشده است، ساده‌ترین راه برای دریافت آن از طریق HACS است. می‌توان یکپارچه‌سازی Dreame Vacuum را تحت HACS > Integrations جستجو کرد و نسخه v2.0.0 یا بالاتر را دانلود نمود. پس از دانلود، باید Home Assistant راه‌اندازی مجدد شود. وقتی یکپارچه‌سازی راه‌اندازی شد، کارت به‌طور خودکار برای داشبوردها در دسترس خواهد بود.

بهینه‌سازی موجودیت

این کارت به‌گونه‌ای طراحی شده است که تنها از موجودیت‌های vacuum، sensor.cleaning_history، sensor.cruising_history و camera.map استفاده کند. همه چیز مورد نیاز خود را مستقیماً از این چهار موجودیت اصلی دریافت می‌کند. در نتیجه، سایر موجودیت‌ها در صفحه دستگاه، از جمله موجودیت‌های نقشه ذخیره شده، می‌توانند به‌طور ایمن غیرفعال شوند تا Home Assistant تمیز باقی بماند.

برای کاهش بیشتر بار روی نمونه Home Assistant با غیرفعال کردن تولید تصویر سمت سرور، موجودیت camera.map می‌تواند غیرفعال شود و به جای آن موجودیت camera.map_data فعال شود. کارت به‌طور خودکار این موضوع را تشخیص می‌دهد و همه نقشه‌ها را مستقیماً در مرورگر نمایش می‌دهد. حداقل، کارت می‌تواند فقط با فعال بودن موجودیت vacuum کار کند. اگرچه در این حالت نقشه ترسیم نخواهد شد، اما همه ویژگی‌های غیر مرتبط با نقشه مانند تنظیمات تمیزکاری، اقدامات داک و کنترل‌های پایه همچنان به‌طور کامل قابل دسترسی و استفاده خواهند بود.

افزودن کارت به داشبورد شما

برای افزودن کارت جاروبرقی Dreame به داشبورد Home Assistant:

1. Home Assistant باز می‌شود و به داشبورد مورد نظر هدایت می‌شوید.
2. روی نماد ویرایش داشبورد () در گوشه بالای سمت راست کلیک کنید.
3. روی دکمه افزودن کارت () در گوشه پایین سمت راست کلیک کنید.
4. در انتخابگر کارت، سفارشی: کارت جاروبرقی Dreame جستجو و انتخاب می‌شود.
5. در ویرایشگر کارت، موجودیت جاروبرقی Dreame Entity، مانند vacuum.l10s_gen2، انتخاب می‌شود.
6. روی ذخیره کلیک می‌شود تا کارت به داشبورد اضافه شود.

استفاده از حالت پنل (توصیه شده)

برای بهترین تجربه کاربری، به ویژه با توجه به ویرایشگر نقشه گسترده و ویژگی‌های کارت جاروبرقی Dreame، استفاده از حالت پنل در Home Assistant بسیار توصیه می‌شود. حالت پنل این امکان را می‌دهد که یک کارت کل صفحه نمای داشبورد را اشغال کند.

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

تنظیم نمای پنل کارت تکی

1. داشبورد مورد نظر باز می‌شود و روی نماد ویرایش داشبورد () در گوشه بالا سمت راست کلیک می‌شود.
2. روی نماد افزودن نما () کنار سربرگ‌های نما در بالای داشبورد کلیک می‌شود.
3. در پنجره گفتگوی "افزودن نما"، پنل، گزینه تک کارت، از منوی کشویی طرح‌بندی انتخاب می‌شود.
4. یک عنوان اختیاری، مانند "جاروبرقی"، و یک نماد، مانند mdi:robot-vacuum، ارائه می‌شود.
5. روی ذخیره کلیک می‌شود.
6. روی دکمه افزودن کارت () در گوشه پایین سمت راست کلیک کنید.
7. در انتخابگر کارت، سفارشی: کارت جاروبرقی Dreame جستجو و انتخاب می‌شود.
8. در ویرایشگر کارت، موجودیت جاروبرقی Dreame Entity، مانند vacuum.l10s_gen2، انتخاب می‌شود.
9. روی ذخیره کلیک می‌شود تا کارت به داشبورد اضافه شود.

ناوبری مرورگر بومی

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