설치 및 사용법

이 가이드는 Dreame 진공 청소기 카드를 Home Assistant 대시보드에서 실행하는 방법을 설명합니다. 통합의 전제 조건, 기존 대시보드에 카드를 추가하는 단계 및 권장 패널 모드 설정 방법에 대해 다룹니다. 패널 모드는 전체 화면을 활용하여 최상의 경험을 제공하며, 특히 태블릿과 데스크탑 모니터에서 매우 강력합니다.

---

Dreame 진공 청소기 카드는 Dreame 진공 청소기 Home Assistant 통합의 핵심 부분으로 긴밀하게 통합되어 있습니다. 이 카드는 별도로 설치되는 독립형 카드가 아닙니다.

이 카드를 사용하려면 카드가 내장된 dreame_vacuum 통합 버전 v2.0.0 이상이 설치되어 있어야 합니다.

전제 조건

Dreame 진공 청소기 통합이 이미 설치되어 있다면, 이 단계는 안전하게 무시할 수 있습니다.

아직 설치되지 않았다면, 가장 쉬운 방법은 HACS를 통해 설치하는 것입니다. Dreame Vacuum 통합은 HACS > Integrations에서 검색할 수 있으며, 버전 v2.0.0 이상을 다운로드할 수 있습니다. 다운로드 후에는 Home Assistant를 재시작해야 합니다. 통합 설정이 완료되면, 카드가 대시보드에서 자동으로 사용 가능해집니다.

엔티티 최적화

이 카드는 vacuum, sensor.cleaning_history, sensor.cruising_history, camera.map 엔티티만 사용하도록 설계되었습니다. 필요한 모든 것은 이 네 가지 핵심 엔티티에서 직접 가져옵니다. 그 결과, 저장된 지도 엔티티를 포함하여 장치 페이지의 다른 모든 엔티티는 Home Assistant를 깨끗하게 유지하기 위해 안전하게 비활성화할 수 있습니다.

서버 측 이미지 생성을 끄면 Home Assistant 인스턴스의 부하를 추가로 줄일 수 있으며, camera.map 엔티티를 비활성화하고 대신 camera.map_data 엔티티를 활성화할 수 있습니다. 카드가 이를 자동으로 감지하여 모든 지도를 브라우저 내에서 직접 표시합니다. 최소한으로는 vacuum 엔티티만 활성화해도 카드 기능이 작동할 수 있습니다. 이 상태에서는 지도가 그려지지는 않지만, 청소 설정, 도크 작업 및 기본 컨트롤과 같은 지도 관련이 아닌 모든 기능은 완전히 접근 가능하고 사용할 수 있습니다.

대시보드에 카드 추가하기

Dreame Vacuum Card를 Home Assistant 대시보드에 추가하려면:

1. Home Assistant를 열고 원하는 대시보드로 이동합니다.
2. 오른쪽 상단의 대시보드 편집 () 아이콘을 클릭합니다.
3. 오른쪽 하단의 카드 추가 () 버튼을 클릭합니다.
4. 카드 선택기에서 사용자 정의: Dreame Vacuum Card를 검색하고 선택합니다.
5. 카드 편집기에서 Dreame Vacuum 엔티티, 예를 들어 vacuum.l10s_gen2, 를 선택합니다.
6. 카드 대시보드에 추가하기 위해 저장을 클릭합니다.

패널 모드 사용 (권장)

Dreame Vacuum 카드의 광범위한 지도 편집기와 기능을 고려할 때 최상의 사용자 경험을 위해 Home Assistant의 패널 모드 사용을 강력히 권장합니다. 패널 모드는 단일 카드가 대시보드 보기의 전체 화면을 차지할 수 있게 합니다.

카드가 패널 뷰에 배치되면 자동으로 배경색과 외곽선을 제거하여 대시보드 테마와 매끄럽게 어울리도록 합니다. 또한 모든 내부 UI 요소는 패널 인식이 되어 레이아웃을 확장된 화면 공간에 맞게 조정합니다.

단일 카드 패널 뷰 설정

1. 원하는 대시보드가 열리고 오른쪽 상단의 대시보드 편집 () 아이콘을 클릭합니다.
2. 대시보드 보기 탭 상단에 있는 보기 추가 () 아이콘을 클릭합니다.
3. "보기 추가" 대화 상자에서 패널, 단일 카드 옵션을 레이아웃 드롭다운에서 선택합니다.
4. 선택적으로 제목을 입력할 수 있으며, 예를 들어 "Vacuum"과 아이콘을 지정할 수 있습니다, 예: mdi:robot-vacuum.
5. 저장을 클릭합니다.
6. 오른쪽 하단의 카드 추가 () 버튼을 클릭합니다.
7. 카드 선택기에서 사용자 정의: Dreame Vacuum Card를 검색하고 선택합니다.
8. 카드 편집기에서 Dreame Vacuum 엔티티, 예를 들어 vacuum.l10s_gen2, 를 선택합니다.
9. 카드 대시보드에 추가하기 위해 저장을 클릭합니다.

네이티브 브라우저 내비게이션

패널 모드에서 사용되거나 뷰에서 유일한 카드일 경우, 카드는 브라우저 내비게이션을 기본적으로 처리합니다. 장치의 물리적 뒤로 가기 버튼 또는 스와이프 제스처를 사용하여 대화 상자를 닫거나, 메뉴를 해제하거나, 뒤로 이동할 수 있으며, 카드 자체 뒤로 가기 버튼과 동일하게 작동합니다. 이는 특히 모바일 장치에서 유용합니다. 안정적인 사용자 경험을 유지하기 위해 카드는 "뒤로" 동작만 가로채며 "앞으로" 내비게이션은 처리하지 않습니다.