FAQ
이 페이지는 GitHub 이슈 트래커에서 반복적으로 발생하는 질문들을 모은 것입니다. 새 이슈를 열기 전에 여기에서 확인하면 대부분이 버그가 아닌 문서화된 원인이 있는 예상된 동작이므로 시간을 절약할 수 있습니다.
기존 이슈 검색
해당 사항이 없나요? 새 이슈를 열기 전에 반드시 GitHub에서 종료된 이슈를 검색하세요. 문제가 지속되면, 문제 보고 페이지에서 디버그 로그를 수집하고 적절한 버그 리포트나 기능 요청을 여는 방법을 설명합니다.
알림을 휴대폰으로 푸시할 수 있나요?
답변 보기
직접적으로는 불가능합니다. 기본적으로 통합은 홈 어시스턴트 대시보드 내에서만 지속 알림을 생성하며, 특정 기기별 알림 대상이 필요하므로 자동으로 모바일 기기의 Home Assistant Companion 앱으로 전달되지 않습니다.
휴대전화에서 이를 수신하려면, 통합의 이벤트(또는 생성된 지속 알림)을 듣고 모바일 장치의 notify 대상으로 전달하는 사용자 지정 자동화를 생성해야 합니다.
장애물 / AI 감지 사진이 표시되지 않음 지도 지원
답변 보기
앱에서 AI 장애물 이미지 업로드가 활성화되어 있음에도 불구하고 장애물 이미지가 비어 있고, Home Assistant에 연결된 계정이 장치를 처음 추가하고 소유한 계정이 아닌 공유/가족 계정인 경우, 제조업체의 클라우드 API가 해당 공유 계정의 장애물 이미지 접근을 조용히 차단할 수 있습니다. 실제 소유 계정을 사용하거나, 앱 내에서 공유 계정에 카메라 접근 권한이 명시적으로 부여되었는지 확인하면 대부분의 경우 문제를 해결할 수 있습니다.
지도 카메라를 HomeKit / Apple Home으로 스트리밍할 수 있나요? 지도 지원
답변 보기
라이브 뷰로는 신뢰할 수 없습니다. 지도 카메라는 실제 MJPEG로 스트리밍되며, 이는 Home Assistant 자체 카메라 플랫폼이 사용하는 동일한 방식이어서 Apple Home에서 정적 미리보기 이미지가 올바르게 표시됩니다. 지도에 실제 변화가 있을 때만 새로운 프레임이 생성되며, 진공청소기가 가만히 있을 때 스트림은 아무것도 보내지 않습니다. HomeKit의 라이브 뷰는 지속적으로 새로 고침되는 소스가 필요하며, Home Assistant는 HomeKit이 직접 MJPEG를 받아들이지 않기 때문에 MJPEG 스트림을 HomeKit에서 표시할 수 있도록 추가 계층을 통해 변환해야 합니다. 지도 스트림이 조용해지면, 그 변환 계층은 연결이 끊긴 것으로 간주하고, Home Assistant는 카메라에 스트림 소스가 없다고 보고하거나 라이브 이미지 대신 빈 피드를 보여줍니다.
이 문제는 여러 번 보고되었습니다. ffmpeg 카메라 플랫폼, go2rtc, 그리고 일반 카메라(Generic Camera) 통합을 사용한 시도 모두 동일한 결과를 보여주었습니다: 정적 미리보기는 작동하지만 HomeKit 내에서 지속적으로 업데이트되는 라이브 피드는 작동하지 않습니다. 이 통합이나 유사한 청소기 지도 스트림에 대해 완전히 작동하는 설정은 확인되지 않았습니다.
Home Assistant 충돌, 재시작 또는 많은 메모리 사용 지도 지원
답변 보기
이 통합은 공식 앱과 유사한 확대/축소가 가능한 전체 해상도 지도 이미지를 렌더링하며, 이는 상당한 양의 메모리를 사용할 수 있습니다. Raspberry Pi와 같은 RAM이 제한된 시스템, 작은 VM, 또는 약 2-3GB로 제한된 컨테이너에서는 사용 가능한 메모리가 소진되어 Home Assistant가 멈추거나 재시작되거나 아예 시작하지 못할 수 있습니다. 이는 일반적으로 지도 지원 장치를 추가한 직후 또는 해당 장치의 페이지나 지도 카메라를 열 때 발생합니다.
해결 방법
장치 설정 옵션에서 저해상도 지도 이미지를 활성화하십시오. 이는 이러한 사례의 대부분을 해결합니다.
옵션을 활성화한 후에도 계속 충돌이 발생하면, 지도 데이터 자체가 시간이 지나면서 손상되었거나 비정상적으로 커졌을 수 있으며, 이로 인해 렌더링 중 메모리 사용량이 증가할 수 있습니다. 백업 및 복구에서 이전의 정상적인 지도를 복원하면 해결될 수 있습니다. 어느 것도 도움이 되지 않는다면, 디버그 로그 수집를 수행하고 버그 보고서를 열어야 합니다. 이는 다른 근본적인 원인을 나타내기 때문입니다.
Home Assistant 업데이트 후 통합 로드 실패, py_mini_racer 언급 지도 지원
답변 보기
해당 통합은 공식 앱과 일치하도록 지도를 최적화하고 렌더링하는 데 사용되는 JavaScript 엔진인 py-mini-racer에 의존합니다. 이 의존성은 통합이 아니라 Home Assistant 자체에서 설치하며, 특히 musl 기반 시스템(일부 플랫폼의 HAOS)이나 업그레이드 직후 Home Assistant Core 업데이트 이후 가끔 설치가 실패하거나 네이티브 바이너리 로드에 실패할 수 있습니다.
환경 문제
이것은 통합 코드가 감지하거나 해결할 수 있는 문제가 아니라 환경/종속성 설치 문제입니다. 이는 관련 없는 Home Assistant 버전과 설치 유형에 걸쳐 반복적으로 나타납니다.
종속성 설치를 다시 시도하도록 Home Assistant를 재시작하면 일부 경우 해결됩니다. 문제가 계속되면, 실제 pip/종속성 설치 오류를 확인하기 위해 시작 시점의 Home Assistant 로그를 확인하세요; 해결해야 하는 것은 해당 오류입니다(플랫폼 수준 설치 실패처럼 보이면 Home Assistant Core 문제로서도 포함됩니다).
Valetudo를 실행하는 장치를 이 통합과 함께 사용할 수 있나요?
답변 보기
예와 아니오. 기술적으로는 해당 통합이 Valetudo와 함께 작동하는 것을 방해하는 제한은 없습니다. Valetudo는 로컬 miIO API를 비활성화하지 않으므로, 토큰을 획득할 수 있는 한 로컬 연결를 통해 장치를 제어할 수 있습니다. 그러나 로컬 API를 통해서는 지도 데이터를 가져올 수 없으며, Valetudo는 서비스를 통해 원시 지도 데이터를 제공하지 않습니다. 따라서 이 통합은 지도 지원 없이만 기능할 수 있습니다.
지도 지원이 없으면, 이 통합이 제공하는 기능은 대부분 중복되며, 나머지 기능은 이미 기본 기능을 통해 활용할 수 있습니다. Valetudo Home Assistant MQTT 통합.