Konfigurasi

Bagian ini membahas opsi dasar untuk mengaktifkan dan menjalankan Kartu Vakum Dreame. Ini menjelaskan cara menghubungkan entitas vakum dan menyesuaikan pengaturan visual inti serta interaksi.

Konfigurasi Minimal (entity)

Kartu ini hanya membutuhkan parameter entity untuk berfungsi dan tidak memerlukan konfigurasi lain. Ini menentukan entitas utama Home Assistant untuk vakum, yang harus termasuk dalam integrasi dreame_vacuum seperti vacuum.l10s_gen2. Ini akan secara otomatis mendeteksi kemampuan perangkat berdasarkan parameter tunggal ini.

type: custom:dreame-vacuum-card
entity: vacuum.l10s_gen2

Konfigurasi Dasar

Parameter berikut dapat digunakan untuk mengubah gaya visual dan mode interaksi pada peta.

type: custom:dreame-vacuum-card
entity: vacuum.l10s_gen2
title: First Floor Vacuum
color_scheme: dreame_auto
icon_set: material
map_display: floor_plan
locked: only_touch

Judul (title)

Judul kustom opsional untuk bagian atas kartu. Secara default, menggunakan nama ramah perangkat dari Home Assistant.

Menyembunyikan Judul

Jika diinginkan, judul kartu dapat sepenuhnya dinonaktifkan menggunakan parameter konfigurasi hidden_card_objects. Ketika judul disembunyikan, status saat ini dari vakum akan ditampilkan menggantikannya di bagian atas kartu.

Skema Warna Peta (color_scheme)

Menentukan palet warna yang diterapkan pada berbagai elemen di peta, seperti ruangan, jalur, dan dinding.

Nilai Default

Jika parameter ini tidak disediakan dalam konfigurasi, maka akan menggunakan skema warna yang dipilih di pengaturan integrasi.

• Dreame Light (dreame_light): Tema resmi aplikasi Dreame.
• Dreame Dark (dreame_dark): Tema gelap eksklusif untuk integrasi dreame_vacuum.
• Dreame Auto (dreame_auto): Beralih otomatis antara dreame_light dan dreame_dark berdasarkan tema sistem.
• Mijia Light (mijia_light): Tema terang resmi aplikasi Xiaomi Mi Home.
• Mijia Dark (mijia_dark): Tema gelap resmi aplikasi Xiaomi Mi Home.
• Mijia Auto (mijia_auto): Beralih otomatis antara mijia_light dan mijia_dark berdasarkan tema sistem.
• Grayscale (grayscale): Tema peta monokrom tanpa warna.

Menimpa Warna

Jika skema warna yang sudah ditentukan tidak sesuai dengan kebutuhan Anda, warna individual dapat sepenuhnya disesuaikan menggunakan parameter konfigurasi override_colors.

Set Ikon Peta (icon_set)

Mengontrol gaya estetika ikon yang ditampilkan langsung di permukaan peta, termasuk ikon pengisi daya dan ikon ruangan.

Nilai Default

Jika parameter ini tidak disediakan dalam konfigurasi, secara default akan menggunakan set ikon yang dipilih di pengaturan integrasi.

• Dreame (dreame): Set ikon resmi dari aplikasi Dreame.
• Dreame Old (dreame_old): Set ikon lama dari aplikasi Dreame.
• Mijia (mijia): Set ikon resmi dari aplikasi Xiaomi Mi Home.
• Material (material): Ikon Material Design bawaan HA.

Menyembunyikan Ikon

Jika set ikon yang tersedia tidak sesuai dengan preferensi visual Anda, visibilitas ikon tertentu di peta dapat sepenuhnya dimatikan menggunakan parameter konfigurasi hidden_objects.

Tampilan Peta (map_display)

Mengontrol gaya tampilan peta, menentukan visibilitas peta yang dipindai robot, dinding fisik yang dapat diedit, dan tekstur lantai.

Hanya tersedia pada perangkat yang didukung

Mode tampilan Floor Plan hanya tersedia untuk perangkat yang mendukung 3D Map Display v2 atau lebih tinggi di Aplikasi resmi. Pada perangkat lama yang tidak mendukung fitur ini, properti konfigurasi khusus ini dinonaktifkan atau tidak berpengaruh karena data peta tidak akan berisi informasi dinding dan pintu yang dapat ditampilkan.

Untuk perangkat yang tidak didukung, sangat disarankan untuk menggunakan parameter konfigurasi Gambar Latar Belakang untuk mencapai efek visual denah lantai 2D atau 3D yang serupa.

Standar (standard)

Menampilkan tampilan peta persis seperti yang dipindai oleh robot.

Floor Plan (floor_plan)

Menggabungkan tampilan peta hasil pemindaian robot dengan tampilan dinding fisik yang dapat diedit.

Floor Plan Tanpa Tekstur (floor_plan_without_texture)

Identik dengan floor_plan, tetapi menyembunyikan tekstur untuk area yang belum dipindai di dalam dinding dan menampilkan semua bahan lantai ruangan.

Floor Plan Only (floor_plan_only)

Identik dengan floor_plan_without_texture, tetapi sepenuhnya menyembunyikan tampilan peta yang dipindai, hanya menampilkan dinding dan lantai internal. Tampilan ini sangat berguna untuk memotong dan memusatkan peta secara otomatis.

Pratinjau

Standar

Denah Lantai

Denah Lantai tanpa tekstur

Hanya Denah Lantai

Dinding yang Dapat Diedit

Dinding fisik dan batas yang ditampilkan dalam mode Denah Lantai sepenuhnya dapat diedit. Untuk lebih detail tentang cara menyesuaikannya, silakan merujuk ke bagian Dinding di bawah Manajemen Peta.

Mode Kunci Kartu (locked)

Pengaturan ini digunakan untuk mengunci pemindahan dan zoom peta di dalam kartu. Ini mencegah peta berpindah dan menghalangi pengguliran halaman saat menggulir dasbor menggunakan sentuhan atau roda mouse. Nilai awalnya adalah auto. Mekanisme ini dapat dikonfigurasi sesuai dengan opsi berikut:

Reset Peta dan Penguncian

Setiap kali peta tidak berada pada posisi reset awalnya, kartu tetap sepenuhnya tidak terkunci terlepas dari mode kunci yang ditentukan. Untuk mengunci peta lagi, harus dilakukan klik ganda atau ketukan ganda untuk mengembalikan peta ke tampilan awalnya.

Selain itu, terlepas dari mode kunci yang dikonfigurasi, peta selalu dapat dibuka kuncinya dengan mengklik ganda atau mengetuk ganda pada ruangan tertentu untuk memperbesar.

Otomatis (auto)

Kartu mendeteksi apakah ia berada di dalam kontrol yang dapat digulir dan secara dinamis mengunci peta sesuai kondisi.

• Interaksi Mouse: Peta tetap terkunci sampai mouse secara aktif digerakkan saat berada di atas kartu. Jika mouse berada di peta saat halaman digulir tetapi tidak digerakkan, peta tetap terkunci. Ketika tampilan peta direset melalui klik ganda, peta langsung terkunci lagi, memungkinkan halaman digulir segera setelah reset asalkan mouse tidak digerakkan.
• Interaksi Sentuh: Peta awalnya terkunci. Membuka kunci peta membutuhkan aksi sentuh-dan-tahan, dimana waktu tahan yang diperlukan ditentukan oleh pengaturan konfigurasi touch_lock. Geseran langsung akan menggulir halaman dasbor, sedangkan menahan sebentar akan membuka kunci peta untuk pergeseran dan menampilkan indikator. Selain itu, melakukan pergeseran dua jari, zoom dua jari, atau zoom ketuk ganda akan langsung membuka kunci peta. Setelah dibuka kunci melalui salah satu metode sentuh ini, peta tetap tidak terkunci sampai tampilan direset dengan ketukan ganda.

Hanya Sentuh (only_touch)

Peta terkunci secara eksklusif saat pergeseran satu sentuhan sambil tetap memungkinkan pengguliran roda mouse tanpa batas. Pergeseran atau zoom dua jari membuka kunci peta sampai tampilan direset dengan ketukan ganda, membuat mode ini direkomendasikan ketika pergeseran sering tidak diperlukan.

Tidak Pernah (never)

Peta tidak pernah terkunci dan pengguliran halaman selalu diblokir.

Selalu (always)

Peta terkunci secara paksa di mana-mana. Sementara zoom dan panning manual awalnya dinonaktifkan, zoom dengan ketukan ganda atau klik ganda tetap tersedia. Setelah diperbesar melalui ketukan ganda atau klik ganda, peta menjadi tidak terkunci untuk panning hingga tampilan direset dengan ketukan ganda atau klik ganda lainnya.