Konfigurasi Peta Kustom

Posisi, skala, dan gambar latar dapat dikonfigurasi secara independen untuk setiap peta yang disimpan di perangkat.

Pengaturan ini dapat dikonfigurasi di editor visual dengan memilih peta dari daftar peta, atau dengan menggunakan properti map_config dalam konfigurasi YAML.

Opsi Konfigurasi Peta

Pengaturan di dalam map_config diterapkan per indeks peta menggunakan kunci seperti map_1, map_2, dll. Salah satu dari opsi berikut dapat didefinisikan di bawah peta tertentu:

Peringatan

Indeks peta diberikan berdasarkan urutan pembuatannya, dengan peta tertua menerima indeks terendah, mulai dari 1. Namun, jika fitur peta multi-lantai dinonaktifkan pada perangkat yang memiliki beberapa peta dan konfigurasinya, peta yang saat ini aktif secara otomatis dialokasikan ke indeks 1. Ini berarti peta yang sebelumnya dikonfigurasi di bawah indeks berbeda akan tiba-tiba mengadopsi konfigurasi dari map_1.

• rotation: Menimpa rotasi yang dikonfigurasi dalam data peta untuk menggambar peta dengan rotasi khusus yang spesifik untuk kartu ini, menerima nilai 0, 90, 180, atau 270.
• scale: Menimpa perhitungan skala otomatis berdasarkan perbedaan antara ukuran asli peta dan ukuran kartu, menerima nilai antara 0.1 dan 20.
• object_scale: Menimpa ukuran objek peta yang dihitung secara otomatis, seperti ikon ruangan dan rintangan, memungkinkan mereka muncul lebih besar atau lebih kecil.
• opacity: Transparansi global dari peta yang digambar. Nilai awal adalah 1 dan menerima nilai hingga 0.
• object_opacity: Transparansi objek yang digambar di peta, seperti ikon ruangan atau rintangan. Nilai awal adalah 1 dan menerima nilai hingga 0.
• font_size: Ukuran font untuk balon teks yang ditampilkan di atas objek yang diaktifkan. Menerima nilai antara 0 dan 12.
• hidden_objects: Menimpa objek peta tersembunyi yang didefinisikan di Konfigurasi Lanjutan global untuk peta tertentu ini.

Pusat dan Skala

Parameter di bawah ini digunakan untuk menimpa ukuran dan koordinat pusat yang secara otomatis dihitung oleh kartu untuk menggambar peta.

Peringatan

Nilai yang diberikan untuk parameter ini relatif terhadap dimensi mentah peta yang belum diskalakan, bukan piksel absolut di layar. Karena menghitung koordinat relatif ini secara manual sangat kompleks, nilai yang tepat dapat diambil menggunakan bagian Informasi Peta Langsung dari editor visual.

• left: Menimpa pusat horizontal peta yang dihitung secara otomatis. Sebagai contoh, mengatur nilai ini ke 0 menempatkan koordinat 0 peta pada sumbu X tepat di tengah horizontal kartu. Titik ini biasanya terletak tepat di depan dermaga.
• top: Menimpa pusat vertikal peta yang dihitung secara otomatis. Sebagai contoh, mengatur nilai ini ke 0 menempatkan koordinat 0 peta pada sumbu Y tepat di tengah vertikal kartu. Titik ini biasanya terletak tepat di depan dermaga.
• width: Mengganti lebar sebenarnya dari peta yang digunakan untuk perhitungan kecocokan. Karena kartu menskalakan peta berdasarkan dimensi terbesar yang sesuai, memasukkan nilai yang lebih besar dari lebar sebenarnya peta akan mengecilkan peta di dalam kartu, sementara nilai yang lebih kecil akan membesarkannya.
• height: Mengganti tinggi sebenarnya dari peta yang digunakan untuk perhitungan kecocokan. Mirip dengan properti width, memasukkan nilai yang lebih besar dari tinggi sebenarnya peta akan mengecilkan peta di dalam kartu, sementara nilai yang lebih kecil akan membesarkannya.

Contoh YAML

type: custom:dreame-vacuum-card
entity: vacuum.l10s_gen2
map_config:
  map_1:
    rotation: 90
    scale: 1.2
    object_scale: 1.5
    left: 10
    top: -20
    hidden_objects:
      - name
      - virtual_wall
  map_2:
    rotation: 180
    opacity: 0.8

Gambar Latar dan Overlay

Kartu mendukung perenderan gambar latar khusus di belakang peta, yang sangat berguna untuk membuat dasbor denah lantai 3D yang imersif. Perilaku ini dikonfigurasi menggunakan properti background_image.

Untuk lebih meningkatkan efek 3D, overlay_image opsional juga dapat disediakan. Gambar overlay digambar langsung di atas jalur pembersihan robot dan tujuan utamanya adalah untuk secara visual menutupi jalur yang melewati belakang dinding fisik atau furnitur di denah lantai. Menggabungkan gambar latar belakang dan gambar overlay sangat dianjurkan untuk mencapai rasa kedalaman yang realistis pada dasbor 3D.

Mendesain Denah Lantai 3D

Saat membuat grafik kustom untuk denah lantai 3D, desain harus diekspor sebagai dua gambar terpisah dengan latar belakang transparan: lapisan dasar yang berisi lantai dan furnitur rendah, serta lapisan atas yang berisi hanya dinding atas.

Gambar contoh di bawah ini, ditampilkan di atas pola papan catur untuk menyoroti area transparannya, dibuat menggunakan aplikasi desain interior gratis Sweet Home 3D dan kemudian diproses di perangkat lunak pengedit gambar standar untuk menghapus area lantai dan membuat bagian transparan yang dibutuhkan.

Gambar Latar Belakang

Gambar Hamparan

background_image dan overlay_image mendukung properti berikut untuk menyelaraskan denah lantai:

• url: Jalur gambar, seperti /local/first_floor_bg.
• opacity: Transparansi gambar. Nilai awal adalah 1 dan menerima nilai hingga 0.

Memusatkan dan Mengubah Skala Gambar

Properti left, top, width, dan height untuk gambar beroperasi menggunakan logika koordinat relatif yang sama persis seperti konfigurasi Pusat dan Skala peta itu sendiri. Properti ini sepenuhnya opsional.

Bahkan jika gambar kustom cocok sempurna dengan ukuran peta, sangat disarankan untuk menyediakan setidaknya nilai top dan left. Ini memastikan bahwa jika ukuran total peta berubah di masa depan, gambar kustom tetap terpasang dengan aman pada lokasi relatif yang sama.

Nilai Default

Ketika nilai-nilai ini tidak diberikan, kartu secara otomatis menyamakan ukuran dan posisi tengah gambar kustom dengan data peta. Properti ini sepenuhnya bersifat opsional dan ada semata-mata untuk menggantikan perilaku ini, mencegah gambar kustom bergeser atau skalanya berubah jika peta meluas atau menyusut seiring waktu.

• left: Menentukan posisi tengah horizontal gambar relatif terhadap pusat peta. Sebagai contoh, mengatur nilai ini ke 0 menempatkan koordinat 0 peta pada sumbu X tepat di tengah horizontal gambar. Titik ini biasanya terletak tepat di depan dermaga.
• top: Menentukan posisi tengah vertikal gambar relatif terhadap pusat peta. Sebagai contoh, mengatur nilai ini ke 0 menempatkan koordinat 0 peta pada sumbu Y tepat di tengah vertikal gambar. Titik ini biasanya terletak tepat di depan dermaga.
• width: Menentukan lebar gambar relatif terhadap sistem koordinat asli peta yang tidak diskalakan, bukan piksel layar absolut. Sebagai contoh, mengatur nilai ini agar sesuai dengan lebar mentah peta memastikan gambar diskalakan secara proporsional untuk menutupi area horizontal yang persis sama dengan data peta.
• height: Menentukan tinggi gambar relatif terhadap sistem koordinat asli peta yang tidak diskalakan. Sebagai contoh, mengatur nilai ini agar sesuai dengan tinggi mentah peta memastikan gambar diskalakan secara proporsional untuk menutupi area vertikal yang persis sama dengan data peta.

Rotasi Asli

Gambar kustom tidak memiliki properti rotasi independen sendiri; rotasinya secara inheren terkait dengan rotasi peta. Untuk memastikan keselarasan di semua tampilan, orientasi dasar dari gambar yang dirancang harus persis sesuai dengan orientasi awal peta saat disetel ke 0 derajat.

Rasio Piksel Perangkat (DPR)

Kartu menampilkan peta sesuai dengan rasio piksel layar perangkat. Untuk mencegah gambar latar belakang dan overlay terlihat buram pada layar beresolusi tinggi seperti ponsel, sangat disarankan untuk menyediakan gambar-gambar ini setidaknya dua kali ukuran yang dibutuhkan pada dashboard desktop.

Menentukan Ukuran Gambar

Data peta mencakup properti grid_size yang menunjukkan berapa milimeter satu piksel mewakili di dunia nyata. Nilai ini dapat ditemukan di bagian Informasi Peta Langsung. Sebagai contoh, sebuah grid_size sebesar 50 berarti setiap piksel sesuai dengan 50mm, atau 5cm. Dengan membagi dimensi dunia nyata dari rumah dengan grid_size ini, nilai width dan height yang tepat untuk dimasukkan dalam konfigurasi dapat dihitung secara akurat, memastikan gambar denah lantai 1:1 sesuai dengan ukuran dunia nyata rumah.

Contoh YAML

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

map_config:
  map_1:
    object_scale: 7
    width: 250
    height: 183
    opacity: 0.45
    hidden_objects:
      - customized_cleaning
      - floor
      - name
      - name_background
      - no_go
      - no_mop
      - order
      - walls
    background_image:
      url: /local/home.png
      left: 77
      top: 10.3
      width: 250
      height: 183
      opacity: 0.75
    overlay_image:
      url: /local/home_overlay.png
      opacity: 0.9
  map_2:
    left: 41
    top: -12
    width: 269
    height: 171
    background_image:
      url: /local/second_floor_bg.png