Konfigurasi Lanjutan

Bagian ini membahas opsi konfigurasi tambahan yang melampaui pengaturan dasar. Sementara pengaturan dasar menyediakan semuanya yang dibutuhkan untuk menjalankan kartu, parameter lanjutan ini memungkinkan Anda menyesuaikan perilaku dan tampilan secara mendalam.

Dengan menggunakan pengaturan ini, Anda dapat menyesuaikan dimensi tata letak agar sesuai sempurna dengan dasbor Anda, mengonfigurasi opsi aksesibilitas, mengelola visibilitas elemen UI tertentu, dan sepenuhnya mengganti warna peta default.

Tinggi Penuh (full_height)

Karena peta sepenuhnya dapat digeser dan diperbesar, kartu dirancang secara eksplisit agar tidak pernah dirender lebih tinggi dari layar dalam keadaan apapun. Ini memastikan seluruh tampilan peta selalu muat dalam viewport tanpa perlu menggulir halaman.

Jika Anda ingin mengganti desain yang dimaksud ini, Anda dapat mengatur parameter ini ke false. Saat dinonaktifkan, kartu akan selalu menyesuaikan skala untuk mengisi lebar maksimum yang tersedia, bahkan jika tingginya melebihi batas layar.

Tidak Disarankan

Mengatur parameter ini ke false umumnya tidak disarankan. Hal ini dapat berdampak negatif pada navigasi dan pengalaman pengguna secara keseluruhan dari dasbor dan mungkin menyebabkan penguncian fungsi panning peta yang tidak perlu kecuali dikonfigurasi sebaliknya dalam parameter konfigurasi locked.

Rasio Aspek (aspect_ratio)

Ini menentukan rasio aspek area tampilan peta. Misalnya, nilai 1.5 berarti lebar adalah 1,5 kali tinggi. Nilai ini dapat diatur antara 0.1 dan 100 tergantung pada bentuk denah.

Penting

Kecuali full_height diatur ke true, kartu tidak akan pernah ditampilkan lebih tinggi daripada tampilan, terlepas dari rasio aspek yang diberikan.

Mode Tangan Kiri (left_handed)

Mengatur parameter ini ke true menampilkan tombol aksi dan menu yang terkait di sisi kiri kartu, bukan sisi kanan, asalkan kartu cukup lebar agar konten dapat disejajarkan ke kanan.

Nonaktifkan Umpan Balik Haptic (disable_haptic)

Mengatur parameter ini ke true menonaktifkan getaran umpan balik haptik yang dipicu oleh kartu selama interaksi UI pada perangkat seluler dengan kemampuan haptik.

Penting

Umpan balik haptik untuk hasil keberhasilan dan kegagalan pemanggilan layanan tidak dapat dinonaktifkan. Ini memastikan konsistensi dengan perilaku standar Home Assistant untuk komponen interaktif seperti saklar dan pemilih yang memicu pemanggilan layanan.

Durasi Kunci Sentuh (touch_lock)

Mengesampingkan durasi tahan kunci sentuh default 100 ms yang digunakan dalam mode auto dan only_touch yang dijelaskan di bagian Mode Kunci Kartu. Nilai yang diterima antara 100 dan 400 ms.

Saklar Warisan (legacy_switches)

Mengatur parameter ini ke true mengembalikan saklar ke desain toggle Material lama, alih-alih menggunakan desain toggle baru yang diperkenalkan di Home Assistant 2026.5.

Peringatan

Jika versi Home Assistant yang terpasang lebih lama dari 2026.5, mengatur parameter ini ke true tidak berpengaruh, karena desain saklar warisan sudah digunakan secara asli.

Skrip (scripts)

Daftar Skrip Home Assistant entitas, seperti - script.sweep_living_room, yang ditambahkan langsung ke daftar Shortcuts vakum di layar beranda.

Daftar shortcuts menampilkan skrip ini dengan nama entitasnya di samping tombol Start (). Mereka dimasukkan di bagian paling atas daftar shortcuts, mempertahankan urutan persis seperti yang ditentukan dalam konfigurasi. Ini berarti skrip kustom ditampilkan sebelum shortcut bawaan robot.

Selain itu, jika perangkat vakum tidak mendukung shortcut secara native, mendefinisikan skrip di sini memaksa tombol aksi shortcut menjadi terlihat di layar beranda. Ini memungkinkan kartu memberikan fungsi shortcut serupa melalui Home Assistant untuk perangkat yang tidak didukung.

Contoh 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