پیکربندی پیشرفته

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

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

ارتفاع کامل (full_height)

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

اگر مایل به بازنویسی این طراحی موردنظر هستید، می‌توانید این پارامتر را روی false تنظیم کنید. هنگامی که غیرفعال است، کارت همیشه به‌طور کامل عرض موجود را پر می‌کند، حتی اگر ارتفاع آن از حاشیه‌های صفحه فراتر رود.

توصیه نمی‌شود

تنظیم این پارامتر روی false عموماً توصیه نمی‌شود. این می‌تواند بر ناوبری و تجربه کلی کاربری داشبورد تأثیر منفی بگذارد و ممکن است باعث قفل شدن غیرضروری عملکرد حرکت نقشه شود مگر اینکه به طور متفاوت در پارامتر پیکربندی locked تنظیم شود.

نسبت تصویر (aspect_ratio)

این نسبت تصویر ناحیه نمایش نقشه را تعریف می‌کند. برای مثال، مقدار 1.5 به این معناست که عرض ۱.۵ برابر ارتفاع است. این مقدار می‌تواند بین 0.1 و 100 بسته به شکل نقشه طبقه تنظیم شود.

مهم

مگر اینکه full_height روی true تنظیم شود، کارت هرگز بلندتر از نمای نمایش داده نخواهد شد، بدون توجه به نسبت تصویری که ارائه شده است.

حالت چپ‌دست (left_handed)

تنظیم این پارامتر روی true دکمه‌های عملیاتی و منوهای مرتبط با آن‌ها را در سمت چپ کارت به جای سمت راست نمایش می‌دهد، به شرطی که کارت به اندازه کافی عرض داشته باشد تا محتوا به سمت راست چیده شود.

غیرفعال کردن بازخورد لمسی (disable_haptic)

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

مهم

بازخورد لمسی برای نتیجه موفق یا شکست تماس‌های سرویس قابل غیرفعال شدن نیست. این اطمینان را می‌دهد که رفتار با اجزای تعاملی استاندارد Home Assistant مانند سوئیچ‌ها و انتخاب‌کننده‌ها که تماس سرویس را فعال می‌کنند، سازگار باشد.

مدت زمان قفل لمسی (touch_lock)

مدت زمان پیش‌فرض 100 میلی‌ثانیه نگه داشتن برای باز کردن لمسی را که در حالت‌های auto و only_touch در بخش حالت قفل کارت توضیح داده شده است، جایگزین می‌کند. این مقدار می‌تواند بین 100 و 400 میلی‌ثانیه قرار گیرد.

سوئیچ‌های قدیمی (legacy_switches)

تنظیم این پارامتر روی true سوئیچ‌ها را به طراحی قدیمی Material toggle باز می‌گرداند و از استفاده از طراحی جدید toggle که در Home Assistant 2026.5 معرفی شده است جلوگیری می‌کند.

هشدار

اگر نسخه نصب‌شده Home Assistant قدیمی‌تر از 2026.5 باشد، تنظیم این پارامتر روی true هیچ تأثیری ندارد، زیرا طراحی سوئیچ قدیمی به‌طور طبیعی استفاده شده است.

اسکریپت‌ها (scripts)

لیستی از موجودیت‌های اسکریپت Home Assistant، مانند - script.sweep_living_room، که مستقیماً به لیست میان‌برها جارو برقی در صفحه اصلی اضافه می‌شوند.

لیست میان‌برها این اسکریپت‌ها را با نام موجودیت‌هایشان به همراه دکمه شروع () نمایش می‌دهد. آنها در بالای لیست میان‌برها وارد می‌شوند و دقیقاً ترتیب تعیین‌شده در پیکربندی را حفظ می‌کنند. این بدان معناست که اسکریپت‌های سفارشی قبل از میان‌برهای اصلی ربات نمایش داده می‌شوند.

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

مثال YAML

type: custom:dreame-vacuum-card
entity: vacuum.l10s_gen2
aspect_ratio: 1.5
full_height: true
touch_lock: 200
disable_haptic: true
left_handed: true
legacy_switches: true
scripts:
  - script.sweep_living_room
  - script.mop_kitchen