로컬 연결 설정 비추천
이 방법은 지속적인 클라우드 연결에 의존하지 않고 로봇 청소기에 직접 로컬 연결을 설정할 때 사용해야 합니다. 이 방법을 사용하려면, 장치가 공식 Xiaomi Home 애플리케이션(iOS 및 Android용)에서 최소 한 번 성공적으로 추가되어 유효한 토큰을 생성해야 합니다. 또한, 통합 과정에서 필요한 IP 주소와 토큰을 클라우드에서 가져올 수 있도록 이 설정 단계 동안 계정에 연결된 상태를 유지해야 합니다.
장치 호환성
이 연결 방법은 Xiaomi Home 애플리케이션으로 지원되는 2022년 이전 제조 장치에서만 지원됩니다. 장치를 Xiaomi Home 앱에 추가할 수 없는 경우, 어떠한 토큰으로도 로컬 API를 제공하지 않습니다.
지도 지원 없음 비추천
기술적으로 로컬 API를 통해 지도 데이터를 가져오는 것은 불가능합니다. 결과적으로 로컬 연결 방법은 지도 지원을 제공하지 않음을 의미하며, 청소 히스토리, 지도 복구, 그리고 동적 방 엔티티과 같이 지도 데이터에 의존하는 여러 핵심 기능을 완전히 사용할 수 없게 됩니다. 지도와 그에 의존하는 기능은 통합의 핵심 기능에 중심이 되기 때문에, 이 연결 방법은 엄격히 권장되지 않습니다. 완전하고 모든 기능을 사용할 수 있는 경험을 위해서는 대신 클라우드 연결 방법 중 하나를 사용하는 것이 강력히 권장됩니다.
IP 및 토큰 가져오기
로컬 연결을 구성하려면 기기의 IP 주소와 토큰을 수동으로 제공해야 합니다.
서브넷 요구 사항
보안상의 이유로, 기기는 자신의 서브넷에서 시작된 요청에만 응답합니다. 따라서 로봇 청소기와 Home Assistant가 로컬 통신을 위해 정확히 동일한 서브넷에 있어야 합니다. 이 python-miio 문서를 참조하여 서브넷 간 문제를 해결하십시오.
방법 1: Xiaomi Cloud Tokens 추출기 추천
이 방법이 가장 신뢰할 수 있습니다. Windows, macOS 또는 Linux에서 실행되며, Xiaomi 클라우드 서버에 직접 연결하여 계정에 연결된 모든 장치의 IP 주소와 토큰을 동시에 가져옵니다.
- 도구 다운로드: GitHub에서 Xiaomi Cloud Tokens 추출기의 적절한 릴리스(예: Windows용
.exe)를 다운로드하세요. - 애플리케이션 실행: 다운로드한 파일을 실행하여 터미널 인터페이스를 엽니다.
- 자격 증명 입력: Xiaomi Home 애플리케이션에 사용된 정확한 사용자 이름(이메일 또는 Xiaomi ID)과 비밀번호를 입력하세요.
- 서버 지역 선택: Xiaomi Home 앱과 일치하는 서버 지역을 지정하세요(예: 유럽용
de). 지역을 모를 경우, 프롬프트를 비워두고 Enter를 눌러 사용 가능한 모든 서버를 스캔합니다. - 토큰 가져오기: 도구는 계정에 연결된 모든 장치의 목록을 출력합니다. 목록에서 목표 진공청소기를 찾아 해당 32자리 토큰을 복사합니다.
방법 2: 데스크탑 GUI 애플리케이션 (Get_MiHome_devices_token)
명령줄 도구 대신 그래픽 사용자 인터페이스를 선호하는 사용자를 위해 데스크탑 애플리케이션이 제공됩니다.
- 애플리케이션 다운로드: GitHub에서 Get_MiHome_devices_token 애플리케이션을 다운로드하고 설치합니다.
- 로그인: 애플리케이션을 열고 Xiaomi 계정 자격증명을 입력한 후 적절한 서버 지역을 선택합니다.
- 토큰 가져오기: 인증되면, 모든 연결된 장치와 각 장치의 IP 주소 및 토큰이 표 형식으로 표시됩니다.
방법 3: Android용 Modded Mi Home 앱 비추천
Android 사용자는 수정된 Mi Home 애플리케이션을 사용하여 모바일 기기에서 앱 인터페이스 내에서 직접 토큰을 확인할 수 있습니다.
- 원래 앱 제거: 안드로이드 기기에서 공식 Mi Home 애플리케이션을 완전히 제거합니다. (참고: 기기는 클라우드 계정에 안전하게 연결된 상태로 유지됩니다.)
- 모드 앱 설치: 온라인에서 "MiHome by Vevs" 수정 APK를 검색하고 최신 버전을 다운로드하여 기기에 설치합니다.
- 로그인: 수정된 애플리케이션을 열고 Xiaomi 계정 자격 증명을 사용하여 로그인합니다.
- 토큰 가져오기: 대상 진공청소기를 선택하여 제어 인터페이스를 엽니다. 오른쪽 상단의 세 점을 눌러 설정에 접근한 다음, 네트워크 정보 또는 일반 설정 섹션으로 이동합니다. 기기의 IP 주소와 토큰이 이 화면에 직접 표시됩니다.