Konfiguracja z kontem Xiaomi Home

Metoda ta powinna być używana, jeśli odkurzacz robot obecnie jest zarządzany za pomocą aplikacji Xiaomi Home. Aby zapewnić kompatybilność, można to zweryfikować w oficjalnej aplikacji Xiaomi Home dostępnej dla iOS i Android.

Wymagania

• Dane logowania: Muszą to być dokładnie te same nazwa użytkownika i hasło, które są używane do logowania się w aplikacji mobilnej (nie na oficjalnej stronie internetowej).
• Region serwera: Wybrany kraj musi odpowiadać regionowi, w którym urządzenie jest zarejestrowane w aplikacji. Niezgodność regionów spowoduje błędy „logowanie nieudane” lub „urządzenie nie znalezione”.

Logowanie przez strony trzecie

Jeżeli konto zostało utworzone przy użyciu usługi zewnętrznej (takiej jak Google lub Apple), najpierw należy wygenerować dedykowane hasło w ustawieniach użytkownika aplikacji. Hasła kont z usług zewnętrznych nie mogą być używane do uwierzytelniania.

Zalecenie wyboru aplikacji

Niektóre urządzenia można konfigurować zarówno za pomocą aplikacji Dreamehome, jak i Xiaomi Home. Chyba że wymagana jest wyłącznie lokalna łączność, zdecydowanie zaleca się użycie aplikacji Dreamehome zamiast Xiaomi Home dla obsługiwanych urządzeń:

• Transmisja z kamery: Funkcja transmisji z kamery nie jest dostępna dla urządzeń skonfigurowanych przez Xiaomi Home.
• Aktualizacje push: Połączenie Dreamehome korzysta z Cloud Push do aktualizacji w czasie rzeczywistym, eliminuje potrzebę okresowych żądań polling.

Preferuj opcję w chmurze

Podczas kroku konfiguracji dostępna jest dodatkowa opcja Preferuj chmurę, która jest domyślnie zaznaczona.

• Gdy zaznaczone (Domyślne): Wymusza całą komunikację przez chmurę (jeśli urządzenie to obsługuje). Jest to domyślne zachowanie, ponieważ na nowszych urządzeniach Xiaomi wyłączyło możliwości dostępu lokalnego. Ponadto, jeśli urządzenie i Home Assistant znajdują się w różnych podsieciach, komunikacja lokalna nie powiedzie się.
• Gdy odznaczone (Zalecane dla obsługiwanych konfiguracji): Integracja pobiera wymagany token z chmury, ale ustanawia bezpośrednie połączenie lokalne z urządzeniem (podobnie do metody Połączenie lokalne). Zapewnia to korzyść automatycznego odnawiania tokena i adresu IP, przy jednoczesnym utrzymaniu całej komunikacji (oprócz danych mapy) lokalnie. Jeśli ta metoda skutkuje błędem „nie można osiągnąć urządzenia” na końcowym etapie konfiguracji, konfigurację należy powtórzyć z zaznaczoną opcją Preferuj Chmurę.

  Wymóg podsieci

  Ze względów bezpieczeństwa urządzenie odpowiada tylko na żądania pochodzące z tej samej podsieci. Dlatego robot odkurzający i Home Assistant muszą znajdować się w dokładnie tej samej podsieci, aby lokalna komunikacja działała. Zobacz ten artykuł python-miio w celu rozwiązywania problemów z komunikacją między podsieciami.

Weryfikacja Captcha

Jeśli serwery Xiaomi Home oznaczą próbę logowania lub adres IP jako nieznany, wymagany będzie krok weryfikacji Captcha. W takim przypadku należy rozwiązać obraz Captcha, aby przejść do następnego kroku.

Uwierzytelnianie Dwuskładnikowe (2FA)

Oprócz Captcha, nieznana próba logowania może również wywołać Uwierzytelnianie Dwuskładnikowe (2FA). Integracja automatycznie poprosi o kod 2FA z serwerów Xiaomi Home, który zostanie wysłany na zarejestrowany numer telefonu (priorytetowo) lub adres e-mail.

Kod ten należy pobrać i wprowadzić w kroku konfiguracji, aby zakończyć logowanie.

Ograniczenia 2FA

• Ważność kodu: Jeśli okno konfiguracji zostanie zamknięte, a następnie zostanie podjęta nowa próba logowania, zostanie wygenerowany nowy kod 2FA. Zawsze należy używać najnowszego otrzymanego kodu.
• Ograniczenie częstości: Xiaomi ściśle ogranicza liczbę kodów 2FA, które można zażądać w ciągu dnia. Powtarzające się próby logowania mogą skutkować tymczasową blokadą.

Okresowe aktualizacje stanu

W przeciwieństwie do innych metod połączeń w chmurze, które obsługują powiadomienia push, połączenie Xiaomi Home opiera się całkowicie na okresowym odpytywaniu w tle w celu pobrania najnowszego stanu. Aby zoptymalizować wykorzystanie sieci, interwał odpytywania jest dynamicznie obliczany na podstawie czasu, jaki upłynął od ostatniej zmiany stanu; żądania są wysyłane często, gdy urządzenie jest aktywnie uruchomione, ale interwał stopniowo się zwiększa, gdy urządzenie pozostaje bezczynne przez dłuższy czas.

Ponowne uwierzytelnianie

Integracja bezpiecznie przechowuje token uwierzytelniający po pomyślnym zalogowaniu, aby komunikować się z serwerami w chmurze. Jeśli token wygaśnie lub zostanie unieważniony przez usługę w chmurze z jakiegokolwiek powodu, Home Assistant automatycznie uruchomi proces ponownego uwierzytelniania, prosząc ponownie o wprowadzenie danych konta.