Cấu Hình Bản Đồ Tuỳ Chỉnh

Căn chỉnh, tỉ lệ và hình nền có thể được cấu hình riêng biệt cho mỗi bản đồ đã lưu trên thiết bị.

Các cài đặt này có thể được cấu hình trong trình chỉnh sửa trực quan bằng cách chọn một bản đồ từ danh sách bản đồ, hoặc bằng cách sử dụng thuộc tính map_config trong cấu hình YAML.

Tùy chọn Cấu hình Bản đồ

Các cài đặt bên trong map_config được áp dụng theo chỉ số bản đồ sử dụng các khóa như map_1, map_2, v.v. Bất kỳ tùy chọn nào sau đây có thể được định nghĩa dưới một bản đồ cụ thể:

Cảnh báo

Chỉ số bản đồ được gán dựa trên thứ tự tạo, với bản đồ cũ nhất nhận chỉ số thấp nhất, bắt đầu từ 1. Tuy nhiên, nếu tính năng bản đồ nhiều tầng bị vô hiệu hóa trên một thiết bị có nhiều bản đồ và cấu hình của chúng, bản đồ đang hoạt động sẽ tự động được gán lại thành chỉ số 1. Điều này có nghĩa là một bản đồ trước đó được cấu hình dưới một chỉ số khác sẽ đột ngột nhận cấu hình của map_1.

• rotation: Ghi đè việc xoay được cấu hình trong dữ liệu bản đồ để vẽ bản đồ theo một góc xoay tùy chỉnh dành riêng cho thẻ này, chấp nhận các giá trị 0, 90, 180, hoặc 270.
• scale: Ghi đè việc tính toán tỷ lệ tự động dựa trên sự chênh lệch giữa kích thước gốc của bản đồ và kích thước của thẻ, chấp nhận các giá trị từ 0.1 đến 20.
• object_scale: Ghi đè kích thước các đối tượng trên bản đồ được tính toán tự động, chẳng hạn như biểu tượng phòng và chướng ngại vật, cho phép chúng xuất hiện lớn hơn hoặc nhỏ hơn.
• opacity: Độ trong suốt toàn cục của bản đồ được vẽ. Giá trị ban đầu là 1 và chấp nhận các giá trị xuống đến 0.
• object_opacity: Độ trong suốt của các đối tượng được vẽ trên bản đồ, chẳng hạn như biểu tượng phòng hoặc chướng ngại vật. Giá trị ban đầu là 1 và chấp nhận các giá trị xuống đến 0.
• font_size: Kích thước phông chữ cho bong bóng văn bản hiển thị trên các đối tượng đã được kích hoạt. Nó chấp nhận các giá trị từ 0 đến 12.
• hidden_objects: Ghi đè các đối tượng bản đồ bị ẩn được định nghĩa trong Cấu hình nâng cao toàn cục cho bản đồ cụ thể này.

Canh giữa và Tỷ lệ

Các tham số dưới đây được sử dụng để ghi đè kích thước và tọa độ trung tâm mà thẻ tự động tính toán để vẽ bản đồ.

Cảnh báo

Các giá trị được cung cấp cho các tham số này là tương đối với kích thước thô, chưa được phóng đại của bản đồ, không phải là pixel tuyệt đối trên màn hình. Bởi vì việc tính toán thủ công các tọa độ tương đối này rất phức tạp, các giá trị chính xác cần thiết có thể được trích xuất bằng cách sử dụng phần Thông tin Bản đồ Trực tiếp của trình chỉnh sửa trực quan.

• left: Ghi đè trung tâm ngang của bản đồ được tính toán tự động. Ví dụ, đặt giá trị này thành 0 sẽ đặt tọa độ 0 của bản đồ trên trục X chính xác ở trung tâm ngang của thẻ. Điểm này thường nằm ngay trước bến tàu.
• top: Ghi đè trung tâm dọc của bản đồ được tính toán tự động. Ví dụ, đặt giá trị này thành 0 sẽ đặt tọa độ 0 của bản đồ trên trục Y chính xác ở trung tâm dọc của thẻ. Điểm này thường nằm ngay trước bến tàu.
• width: Ghi đè chiều rộng thực tế của bản đồ được sử dụng cho phép tính phù hợp. Vì thẻ điều chỉnh tỉ lệ bản đồ dựa trên chiều lớn nhất phù hợp, nhập giá trị lớn hơn chiều rộng thực tế của bản đồ sẽ thu nhỏ bản đồ trong thẻ, trong khi giá trị nhỏ hơn sẽ phóng to bản đồ.
• height: Ghi đè chiều cao thực tế của bản đồ được sử dụng cho phép tính phù hợp. Tương tự như thuộc tính width, nhập giá trị lớn hơn chiều cao thực tế của bản đồ sẽ thu nhỏ bản đồ trong thẻ, trong khi giá trị nhỏ hơn sẽ phóng to bản đồ.

Ví dụ 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

Hình nền và Hình chồng

Thẻ hỗ trợ hiển thị hình nền tùy chỉnh phía sau bản đồ, điều này đặc biệt hữu ích để tạo bảng điều khiển sơ đồ tầng 3D sống động. Hành vi này được cấu hình bằng thuộc tính background_image.

Để tăng cường hiệu ứng 3D, một overlay_image tùy chọn cũng có thể được cung cấp. Hình ảnh phủ được vẽ trực tiếp lên trên đường đi làm sạch của robot và mục đích chính của nó là che một cách trực quan các đường đi đi sau các bức tường hoặc đồ nội thất vật lý trong sơ đồ mặt sàn. Kết hợp cả hình nền và hình ảnh phủ được khuyến nghị cao để đạt được cảm giác chiều sâu chân thực trong các bảng điều khiển 3D.

Thiết kế sơ đồ mặt sàn 3D

Khi tạo đồ họa tùy chỉnh cho sơ đồ mặt sàn 3D, thiết kế phải được xuất dưới dạng hai hình ảnh riêng biệt với nền trong suốt: một lớp cơ sở chứa sàn và đồ nội thất thấp, và một lớp trên chỉ chứa các bức tường phía trên.

Các hình ảnh ví dụ dưới đây, được hiển thị trên nền bàn cờ để làm nổi bật các khu vực trong suốt của chúng, được tạo ra bằng ứng dụng thiết kế nội thất miễn phí Sweet Home 3D và sau đó được xử lý trong phần mềm chỉnh sửa ảnh tiêu chuẩn để loại bỏ các khu vực sàn và tạo ra các phần trong suốt cần thiết.

Ảnh nền

Ảnh phủ

background_image và overlay_image hỗ trợ các thuộc tính sau để căn chỉnh sơ đồ mặt sàn:

• url: Đường dẫn của hình ảnh, chẳng hạn như /local/first_floor_bg.
• opacity: Độ trong suốt của hình ảnh. Giá trị ban đầu là 1 và nó chấp nhận các giá trị xuống đến 0.

Căn giữa và thay đổi kích thước hình ảnh

Các thuộc tính left, top, width và height cho hình ảnh hoạt động bằng cách sử dụng cùng một logic tọa độ tương đối chính xác như cấu hình Canh giữa và Tỷ lệ của bản đồ. Những thuộc tính này hoàn toàn tùy chọn.

Ngay cả khi hình ảnh tùy chỉnh hoàn toàn khớp với kích thước bản đồ, vẫn rất khuyến nghị cung cấp ít nhất các giá trị top và left. Điều này đảm bảo rằng nếu tổng kích thước của bản đồ thay đổi trong tương lai, hình ảnh tùy chỉnh vẫn được cố định chắc chắn tại cùng vị trí tương đối.

Giá trị Mặc định

Khi những giá trị này không được cung cấp, thẻ sẽ tự động cân bằng kích thước và trung tâm của hình ảnh tùy chỉnh với dữ liệu bản đồ. Những thuộc tính này hoàn toàn tùy chọn và chỉ tồn tại để ghi đè hành vi này, ngăn hình ảnh tùy chỉnh dịch chuyển hoặc tỷ lệ của nó thay đổi trong trường hợp bản đồ mở rộng hoặc thu nhỏ theo thời gian.

• left: Xác định trung tâm ngang của hình ảnh so với trung tâm của bản đồ. Ví dụ, đặt giá trị này là 0 sẽ đặt tọa độ 0 của bản đồ trên trục X chính xác ở trung tâm ngang của hình ảnh. Điểm này thường nằm ngay trước bến cảng.
• top: Xác định trung tâm dọc của hình ảnh so với trung tâm của bản đồ. Ví dụ, đặt giá trị này là 0 sẽ đặt tọa độ 0 của bản đồ trên trục Y chính xác ở trung tâm dọc của hình ảnh. Điểm này thường nằm ngay trước bến cảng.
• width: Xác định chiều rộng của hình ảnh theo hệ tọa độ gốc, chưa phóng to của bản đồ, thay vì theo pixel tuyệt đối trên màn hình. Ví dụ, thiết lập giá trị này để khớp với chiều rộng thô của bản đồ đảm bảo hình ảnh được phóng to theo tỷ lệ để phủ đúng cùng một khu vực ngang với dữ liệu bản đồ.
• height: Xác định chiều cao của hình ảnh theo hệ tọa độ gốc, chưa phóng to của bản đồ. Ví dụ, thiết lập giá trị này để khớp với chiều cao thô của bản đồ đảm bảo hình ảnh được phóng to theo tỷ lệ để phủ đúng cùng một khu vực dọc với dữ liệu bản đồ.

Xoay gốc

Hình ảnh tùy chỉnh không có thuộc tính xoay độc lập; việc xoay của chúng vốn gắn liền với góc xoay của bản đồ. Để đảm bảo căn chỉnh trên tất cả các chế độ xem, hướng cơ bản của hình ảnh thiết kế phải hoàn toàn khớp với hướng ban đầu của bản đồ khi được đặt ở 0 độ.

Tỷ lệ pixel thiết bị (DPR)

Thẻ hiển thị bản đồ theo tỷ lệ điểm ảnh của màn hình thiết bị. Để ngăn hình nền và hình ảnh phủ xuất hiện mờ trên các màn hình có độ phân giải cao như điện thoại di động, rất khuyến nghị cung cấp những hình ảnh này với kích thước tối thiểu gấp đôi so với kích thước yêu cầu trên bảng điều khiển máy tính để bàn.

Xác định Kích thước Hình ảnh

Dữ liệu bản đồ bao gồm một thuộc tính grid_size chỉ ra bao nhiêu milimét mà một điểm ảnh đại diện trong thế giới thực. Giá trị này có thể được tìm thấy trong phần Thông tin Bản đồ Trực tiếp. Ví dụ, một grid_size là 50 có nghĩa là mỗi điểm ảnh tương ứng với 50mm, hoặc 5cm. Bằng cách chia các kích thước thực tế của ngôi nhà cho grid_size này, các giá trị width và height chính xác để nhập vào cấu hình có thể được tính toán chính xác, đảm bảo hình ảnh sơ đồ sàn 1:1 tỉ lệ hoàn hảo với kích thước thực tế của ngôi nhà.

Ví dụ 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