Налаштування користувацької карти

Вирівнювання, масштаб і фонове зображення можна налаштовувати окремо для кожної збереженої карти на пристрої.

Ці налаштування можна конфігурувати у візуальному редакторі, обравши карту зі списку карт, або використавши властивість map_config у конфігурації YAML.

Параметри конфігурації карти

Налаштування всередині map_config застосовуються за індексом карти, використовуючи ключі на кшталт map_1, map_2 тощо. Будь-який із наступних параметрів можна визначити для конкретної карти:

Попередження

Індекси карт призначаються на основі порядку їх створення, причому найстаріша карта отримує найнижчий індекс, починаючи з 1. Проте, якщо функцію багаторівневої карти вимкнено на пристрої, який має кілька карт і їх конфігурацій, поточна активна карта автоматично переназначається на індекс 1. Це означає, що карта, яка раніше була налаштована під іншим індексом, раптово набуде конфігурації map_1.

• rotation: Перевизначає обертання, налаштоване в даних карти, щоб намалювати карту з користувацьким обертанням, специфічним для цієї карти, приймаючи значення 0, 90, 180 або 270.
• scale: Перевизначає автоматичний розрахунок масштабу на основі різниці між оригінальним розміром карти та розміром карти, приймаючи значення від 0.1 до 20.
• object_scale: Перевизначає автоматично розрахований розмір об'єктів карти, таких як іконки кімнат та перешкод, дозволяючи їм виглядати більшими або меншими.
• opacity: Глобальна прозорість намальованої карти. Початкове значення 1 і приймає значення до 0.
• object_opacity: Прозорість об'єктів, намальованих на карті, таких як іконки кімнат або перешкод. Початкове значення 1 і приймає значення до 0.
• font_size: Розмір шрифту для текстових бульбашок, що відображаються поверх активовані об'єкти. Приймає значення від 0 до 12.
• hidden_objects: Перевизначає приховані об'єкти карти, визначені у глобальному Розширена конфігурація для цієї конкретної карти.

Центрування та масштабування

Наведені нижче параметри використовуються для перебивки розміру та координат центру, які карта автоматично обчислює для відтворення карти.

Попередження

Значення для цих параметрів наведені відносно сирих, не масштабованих розмірів карти, а не абсолютних пікселів на екрані. Оскільки ручний розрахунок цих відносних координат дуже складний, точні необхідні значення можна отримати, використовуючи розділ Інформація на живій карті візуального редактора.

• left: Перезаписує автоматично обчислений горизонтальний центр карти. Наприклад, встановлення цього значення на 0 розміщує координату 0 карти по осі X точно в горизонтальному центрі картки. Ця точка зазвичай розташована безпосередньо перед причалом.
• top: Перезаписує автоматично обчислений вертикальний центр карти. Наприклад, встановлення цього значення на 0 розміщує координату 0 карти по осі Y точно в вертикальному центрі картки. Ця точка зазвичай розташована безпосередньо перед причалом.
• width: Перевизначає фактичну ширину карти, що використовується для розрахунку підгонки. Оскільки карта масштабується відповідно до найбільшої підходящої виміру, введення значення більше за фактичну ширину карти зменшить карту всередині картки, тоді як менше значення збільшить її.
• height: Перевизначає фактичну висоту карти, що використовується для розрахунку підгонки. Подібно до властивості width, введення значення більше за фактичну висоту карти зменшить карту всередині картки, тоді як менше значення збільшить її.

Приклад 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

Фонові та накладні зображення

Картка підтримує відображення спеціального фонового зображення за картою, що особливо корисно для створення захопливих 3D-планів поверхів на інформаційних панелях. Ця поведінка налаштовується за допомогою властивості background_image.

Щоб ще більше покращити 3D-ефект, також може бути надано необов'язковий overlay_image. Накладене зображення малюється безпосередньо поверх траєкторії прибирання робота, і його основна мета — візуально приховати шляхи, що проходять за фізичними стінами або меблями на плані поверху. Рекомендується поєднувати як фонове, так і накладене зображення для досягнення реалістичного відчуття глибини на 3D-панелях керування.

Розробка 3D-плану поверху

Під час створення користувацької графіки для 3D-плану поверху, дизайн повинен бути експортований як два окремі зображення з прозорими фонами: базовий шар, що містить підлоги та низькі меблі, і верхній шар, що містить лише верхні стіни.

Приклад зображень нижче, показаних на шаховому фоні для виділення прозорих ділянок, було створено за допомогою безкоштовного додатка для дизайну інтер’єру Sweet Home 3D і потім оброблено в стандартному програмному забезпеченні для редагування зображень, щоб видалити ділянки підлоги та створити необхідні прозорі частини.

Фонове зображення

Накладене зображення

background_image і overlay_image підтримують наступні властивості для вирівнювання плану підлоги:

• url: Шлях до зображення, наприклад /local/first_floor_bg.
• opacity: Прозорість зображення. Початкове значення 1 і приймає значення до 0.

Центрування та масштабування зображень

Властивості left, top, width і height для зображень працюють з точно такою ж логікою відносних координат, як і власна конфігурація Центрування та масштабування карти. Ці властивості є повністю необов’язковими.

Навіть якщо користувальницьке зображення ідеально збігається за розміром з картою, настійно рекомендується вказати принаймні значення top і left. Це гарантує, що якщо загальний розмір карти зміниться в майбутньому, користувальницьке зображення залишатиметься на тому ж відносному місці.

Значення за замовчуванням

Коли ці значення не надано, карта автоматично вирівнює розмір і центр користувацького зображення з даними карти. Ці властивості є повністю необов'язковими і існують виключно для того, щоб перевизначити цю поведінку, запобігаючи зміщенню користувацького зображення або зміні його масштабу у разі розширення або звуження карти з часом.

• left: Визначає горизонтальний центр зображення відносно центру карти. Наприклад, встановлення цього значення на 0 розташовує координату 0 карти по осі X точно в горизонтальному центрі зображення. Ця точка зазвичай знаходиться прямо перед причалом.
• top: Визначає вертикальний центр зображення відносно центру карти. Наприклад, встановлення цього значення на 0 розташовує координату 0 карти по осі Y точно у вертикальному центрі зображення. Ця точка зазвичай знаходиться прямо перед причалом.
• width: Визначає ширину зображення щодо оригінальної, не масштабованої системи координат карти, а не абсолютних пікселів екрану. Наприклад, встановлення цього значення для відповідності сирій ширині карти гарантує пропорційне масштабування зображення, щоб покрити точно ту ж горизонтальну область, що й дані карти.
• height: Визначає висоту зображення щодо оригінальної, не масштабованої системи координат карти. Наприклад, встановлення цього значення для відповідності сирій висоті карти гарантує пропорційне масштабування зображення, щоб покрити точно ту ж вертикальну область, що й дані карти.

Рідний поворот

Користувацькі зображення не мають власного незалежного властивості повороту; їх поворот невіддільно пов'язаний з поворотом карти. Щоб забезпечити вирівнювання у всіх переглядах, базова орієнтація спроектованого зображення повинна точно збігатися з початковою орієнтацією карти при встановленні на 0 градусів.

Співвідношення пікселів пристрою (DPR)

Карта відображає карту відповідно до співвідношення пікселів екрану пристрою. Щоб запобігти розмиттю фонових та накладних зображень на дисплеях високої роздільної здатності, таких як мобільні телефони, настійно рекомендується надавати ці зображення щонайменше вдвічі більшого розміру, ніж необхідно для панелі керування на десктопі.

Визначення розміру зображення

Дані карти включають властивість grid_size, яка вказує, скільки міліметрів відповідає одному пікселю в реальному світі. Це значення можна знайти в розділі Інформація на живій карті. Наприклад, grid_size зі значенням 50 означає, що кожен піксель відповідає 50 мм, або 5 см. Поділивши реальні розміри будинку на це grid_size, можна точно розрахувати значення width і height, які слід ввести в конфігурацію, забезпечуючи ідеальне масштабування зображення плану поверху 1:1 з реальним розміром будинку.

Приклад 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