Find My Device

Home Assistant에 기록된 Galaxy 기기의 위치, 배터리, 활동 상태, 이동 경로와 모바일 앱 센서 값을 지도 및 설정형 화면에 표시하는 개인용 나의 찾기 페이지입니다.

<meta charset="UTF-8">
<link href="/custom/common/css/findmydevice.css" rel="stylesheet" />
<script src="/custom/findmydevice/js/main.js"></script>

기능

• 현재 위치 지도 표시
• GPS 정확도 원 표시
• 최근 24시간 및 사용자 지정 기간 이동 경로 표시
• 배터리, 충전 상태, 배터리 건강, 온도, 전력, 활동 상태, 걸음 수, 이동 거리 표시
• 네트워크, 기기, 화면/오디오, 건강, 차량, 저장공간/데이터, 알림, 센서 정보를 섹션별로 표시
• 자동 위치 갱신 웹훅 제어
• 강제 업데이트 요청
• 한국어/영어 전환
• Wake Lock 지원

구조

• php/api.php: Home Assistant 상태/히스토리 조회 API
• js/main.js: 지도 렌더링, 상태 갱신, 히스토리 표시
• css/style.css: 기존 삽입 코드 호환용 공용 CSS import
• img/: 지도 마커 및 언어 아이콘

공통 모듈 연동

인증과 Home Assistant 호출은 /custom/common을 사용합니다. 브라우저 JS에는 더 이상 API Bearer 토큰이나 Home Assistant 웹훅 식별자를 직접 넣지 않습니다.

접근 확인은 JS에서 읽을 수 있는 레거시 쿠키가 아니라 /custom/launcher/api.php?session=1 서버 응답으로 처리합니다. 공통 인증 쿠키는 HttpOnly이므로 브라우저 스크립트가 직접 읽지 않습니다.

표시할 모바일 앱 센서 목록은 /custom/common/config.php의 findmydevice_sensor_sections에서 섹션 단위로 관리합니다. 화면 CSS 원본은 /custom/common/css/findmydevice.css를 사용합니다. 기존 운영 HTML이 /custom/findmydevice/css/style.css를 참조해도 호환 파일이 공용 CSS를 import합니다.

운영 메모

이 프로젝트는 위치, 주소, 배터리, 활동 기록을 포함하므로 private 저장소와 개인 접근 환경에서만 운영합니다.