구성
이 섹션에서는 Dreame Vacuum 카드를 설정하고 실행하는 기본 옵션을 다룹니다. 여기에는 진공 청소기 엔티티를 연결하고 핵심 시각 및 상호작용 설정을 사용자화하는 방법이 상세히 나와 있습니다.


최소 구성 (entity)
카드가 작동하려면 entity 매개변수만 필요하며 다른 구성은 필요하지 않습니다. 이는 진공 청소기의 주요 Home Assistant 엔티티를 정의하며, 이 엔티티는 vacuum.l10s_gen2와 같은 dreame_vacuum 통합에 속해야 합니다. 이 단일 매개변수를 기반으로 장치의 기능을 자동으로 감지합니다.
yaml
type: custom:dreame-vacuum-card
entity: vacuum.l10s_gen2기본 구성
다음 매개변수는 지도(Map)의 시각적 스타일과 상호작용 모드를 변경하는 데 사용할 수 있습니다.
yaml
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제목 (title)
카드 상단에 표시할 선택적 커스텀 제목입니다. 기본값은 Home Assistant에서 설정된 장치의 친근한 이름입니다.
제목 숨기기
원할 경우 hidden_card_objects 구성 매개변수를 사용하여 카드 제목을 완전히 비활성화할 수 있습니다. 제목이 숨겨지면 카드 상단에는 대신 진공 청소기의 현재 상태가 표시됩니다.
지도 색상 체계 (color_scheme)
방, 경로 및 벽과 같은 지도상의 다양한 요소에 적용되는 색상 팔레트를 정의합니다.
기본값
이 매개변수가 설정에 제공되지 않은 경우, 통합 설정에서 선택된 색상 체계가 기본값으로 사용됩니다.
- Dreame Light (
dreame_light): 공식 Dreame 앱의 테마. - Dreame Dark (
dreame_dark):dreame_vacuum통합 전용 다크 테마. - Dreame Auto (
dreame_auto): 시스템 테마에 따라dreame_light와dreame_dark사이를 자동 전환합니다. - Mijia Light (
mijia_light): 공식 Xiaomi Mi Home 앱의 밝은 테마. - Mijia Dark (
mijia_dark): 공식 Xiaomi Mi Home 앱의 다크 테마. - Mijia Auto (
mijia_auto): 시스템 테마에 따라mijia_light와mijia_dark사이를 자동 전환합니다. - Grayscale (
grayscale): 색상이 없는 단색 지도 테마.
색상 재정의
미리 정의된 색상 체계가 필요에 맞지 않는 경우, override_colors 구성 매개변수를 사용하여 개별 색상을 완전히 사용자 정의할 수 있습니다.
지도 아이콘 세트 (icon_set)
맵 표면에 직접 표시되는 아이콘의 미적 스타일을 제어합니다. 여기에는 충전기 아이콘과 방 아이콘이 포함됩니다.
기본값
이 매개변수가 구성에 제공되지 않은 경우, 통합 설정에서 선택한 아이콘 세트가 기본값으로 사용됩니다.
- Dreame (
dreame): 공식 Dreame 앱의 아이콘 세트입니다. - Dreame Old (
dreame_old): 이전 Dreame 앱의 아이콘 세트입니다. - Mijia (
mijia): 공식 Xiaomi Mi Home 앱의 아이콘 세트입니다. - Material (
material): HA 내장 Material Design 아이콘입니다.
아이콘 숨기기
사용 가능한 아이콘 세트가 시각적 선호에 맞지 않는 경우, 특정 아이콘의 맵 표시를 hidden_objects 구성 매개변수를 사용하여 완전히 끌 수 있습니다.
맵 표시 (map_display)
맵의 표시 스타일을 제어하며, 로봇이 스캔한 맵, 편집 가능한 물리적 벽 및 바닥 텍스처의 가시성을 결정합니다.
지원되는 기기에서만 사용 가능합니다
층 평면도 표시 모드는 공식 앱에서 3D 지도 표시 v2 이상을 지원하는 기기에서만 엄격하게 사용할 수 있습니다. 이 기능을 지원하지 않는 이전 기기에서는 이 특정 구성 속성이 비활성화되거나 효과가 없으며, 지도 데이터에 표시할 수 있는 벽 및 문 정보가 포함되지 않기 때문입니다.
지원되지 않는 기기에서는 유사한 2D 또는 3D 층 평면도 시각 효과를 얻기 위해 배경 이미지 구성 매개변수를 사용하는 것이 강력히 권장됩니다.
표준 (standard)
로봇이 스캔한 대로의 정확한 지도 뷰를 표시합니다.
층 평면도 (floor_plan)
로봇이 스캔한 지도 뷰와 편집 가능한 물리적 벽의 표시를 결합합니다.
질감 없는 층 평면도 (floor_plan_without_texture)
floor_plan와 동일하지만 벽 내부의 스캔되지 않은 영역의 질감을 숨기고 방의 전체 바닥 재질을 표시합니다.
층 평면도 전용 (floor_plan_only)
floor_plan_without_texture와 동일하지만 스캔된 지도 뷰를 완전히 숨기고 벽과 내부 바닥만 표시합니다. 이 뷰는 지도를 자동으로 자르고 중앙에 맞출 때 매우 유용합니다.
미리보기


표준


평면도


텍스처 없는 평면도


평면도만
편집 가능한 벽
평면도 모드에서 표시되는 실제 벽과 경계는 완전히 편집 가능합니다. 조정 방법에 대한 자세한 내용은 지도 관리 하위의 벽 섹션을 참조하십시오.
카드 잠금 모드 (locked)
이 설정은 카드 안에서 지도 팬 및 확대/축소를 잠그는 데 사용됩니다. 터치 또는 마우스 휠을 사용하여 대시보드를 스크롤할 때 지도가 이동하면서 페이지 스크롤을 방해하지 않도록 합니다. 초기 값은 auto입니다. 이 메커니즘은 다음 옵션에 따라 구성할 수 있습니다:
지도 재설정 및 잠금
맵이 초기 재설정 위치에 있지 않을 때는 정의된 잠금 모드와 상관없이 카드가 완전히 잠금 해제된 상태로 유지됩니다. 맵을 다시 잠그려면 더블클릭 또는 더블탭을 수행하여 맵을 초기 보기로 되돌려야 합니다.
또한 구성된 잠금 모드에 관계없이 특정 방을 더블클릭하거나 더블탭하여 확대하면 항상 맵을 잠금 해제할 수 있습니다.
자동 (auto)
카드는 자신이 스크롤 가능한 컨트롤 안에 있는지 감지하고 그에 따라 동적으로 맵을 잠급니다.
- 마우스 상호작용: 마우스가 카드 위에서 적극적으로 이동할 때까지 맵은 잠긴 상태로 유지됩니다. 페이지를 스크롤하는 동안 마우스가 맵 위에 놓이지만 이동하지 않으면 맵은 잠긴 상태를 유지합니다. 더블클릭으로 맵 뷰가 재설정되면 맵은 즉시 다시 잠기며, 마우스가 이동하지 않으면 재설정 직후 페이지를 스크롤할 수 있습니다.
- 터치 상호작용: 지도는 초기에는 잠겨 있습니다. 지도를 잠금 해제하려면 터치 앤 홀드 동작이 필요하며, 필요한 홀드 시간은
touch_lock설정에 의해 정의됩니다. 즉시 스와이프하면 대시보드 페이지가 스크롤되지만, 잠시 홀드하면 지도를 패닝할 수 있도록 잠금이 해제되고 표시기가 나타납니다. 또한, 두 손가락 패닝, 두 손가락 줌 또는 더블 탭 줌을 수행하면 지도가 즉시 잠금 해제됩니다. 이러한 터치 방법 중 어느 하나를 통해 잠금이 해제되면, 더블 탭으로 뷰를 재설정할 때까지 지도의 잠금이 유지되지 않습니다.
터치 전용 (only_touch)
이 모드에서는 한 손가락 패닝 중에만 지도가 잠기며 마우스 휠 스크롤은 제한 없이 허용됩니다. 두 손가락 패닝 또는 줌을 수행하면 지도가 잠금 해제되고, 더블 탭으로 뷰를 재설정할 때까지 유지되므로, 자주 패닝할 필요가 없는 경우에 권장됩니다.
절대 안 함 (never)
지도는 절대 잠기지 않으며 페이지 스크롤은 항상 차단됩니다.
항상 (always)
지도는 모든 곳에서 강제로 잠겨 있습니다. 처음에는 수동 확대/축소와 이동이 비활성화되어 있지만, 두 번 탭하거나 두 번 클릭하여 확대하는 기능은 여전히 사용할 수 있습니다. 두 번 탭하거나 두 번 클릭으로 확대하면, 다음 두 번 탭 또는 두 번 클릭으로 뷰가 초기화될 때까지 지도의 이동이 가능해집니다.