Pengaturan dengan Akun Xiaomi Home

Metode ini harus digunakan jika robot vacuum saat ini dikelola melalui aplikasi Xiaomi Home. Untuk memastikan kompatibilitas, hal ini dapat diverifikasi melalui aplikasi resmi Xiaomi Home yang tersedia untuk iOS dan Android.

Persyaratan

• Kredensial: Harus berupa nama pengguna dan kata sandi yang tepat yang digunakan untuk masuk ke aplikasi seluler (bukan situs web resmi).
• Wilayah Server: Negara yang dipilih harus sesuai dengan wilayah tempat perangkat terdaftar di aplikasi. Wilayah yang tidak cocok akan mengakibatkan kesalahan "login gagal" atau "perangkat tidak ditemukan".

Masuk Pihak Ketiga

Jika akun dibuat menggunakan layanan pihak ketiga (seperti Google atau Apple), kata sandi khusus harus dibuat terlebih dahulu di pengaturan pengguna aplikasi. Kata sandi akun pihak ketiga tidak dapat digunakan untuk autentikasi.

Rekomendasi Pemilihan Aplikasi

Beberapa perangkat dapat dikonfigurasi menggunakan aplikasi Dreamehome atau Xiaomi Home. Kecuali koneksi lokal benar-benar diperlukan, sangat disarankan untuk menggunakan aplikasi Dreamehome daripada Xiaomi Home untuk perangkat yang didukung:

• Aliran Kamera: Fitur aliran kamera tidak tersedia untuk perangkat yang dikonfigurasi melalui Xiaomi Home.
• Push Updates: Koneksi Dreamehome menggunakan Cloud Push untuk pembaruan waktu nyata, sehingga tidak perlu permintaan polling secara berkala.

Pilih Opsi Cloud

Selama langkah konfigurasi, opsi tambahan Prefer Cloud tersedia dan dicentang secara default.

• Saat dicentang (Default): Memaksa semua komunikasi melalui cloud (jika didukung oleh perangkat). Ini adalah perilaku default karena pada perangkat yang lebih baru, Xiaomi telah menonaktifkan kemampuan akses lokal. Selain itu, jika perangkat dan Home Assistant berada di subnet yang berbeda, komunikasi lokal akan gagal.
• Saat tidak dicentang (Disarankan untuk konfigurasi yang didukung): Integrasi mengambil token yang diperlukan dari cloud tetapi membangun koneksi lokal langsung dengan perangkat (mirip dengan metode Koneksi Lokal). Ini memberikan keuntungan perpanjangan otomatis token dan IP sambil menjaga semua komunikasi (kecuali data peta) tetap lokal. Jika metode ini menghasilkan kesalahan "tidak dapat menghubungi perangkat" pada langkah konfigurasi terakhir, konfigurasi harus dicoba kembali dengan opsi Prefer Cloud dicentang.

  Persyaratan Subnet

  Untuk alasan keamanan, perangkat hanya merespons permintaan yang berasal dari subnet-nya sendiri. Oleh karena itu, robot vacuum dan Home Assistant harus berada di subnet yang sama persis agar komunikasi lokal berfungsi. Lihat artikel python-miio ini untuk memecahkan masalah lintas subnet.

Verifikasi Captcha

Jika server Xiaomi Home menandai upaya login atau alamat IP sebagai tidak tepercaya, langkah verifikasi captcha akan diperlukan. Ketika hal ini terjadi, gambar captcha harus diselesaikan untuk melanjutkan ke langkah berikutnya.

Autentikasi Dua Faktor (2FA)

Selain captcha, upaya login yang tidak tepercaya juga dapat memicu Autentikasi Dua Faktor (2FA). Integrasi akan secara otomatis meminta kode 2FA dari server Xiaomi Home, yang dikirim ke nomor telepon yang terdaftar (diprioritaskan) atau alamat email.

Kode ini harus diambil dan dimasukkan ke langkah konfigurasi untuk menyelesaikan login.

Batasan 2FA

• Keabsahan Kode: Jika jendela konfigurasi ditutup dan upaya login baru dilakukan, kode 2FA baru akan dihasilkan. Kode yang baru diterima harus selalu digunakan.
• Batasan Kecepatan: Xiaomi secara ketat membatasi jumlah kode 2FA yang dapat diminta per hari. Upaya login berulang dapat mengakibatkan pemblokiran sementara.

Pembaruan Status Berkala

Berbeda dengan metode koneksi cloud lain yang mendukung notifikasi push, koneksi Xiaomi Home sepenuhnya bergantung pada polling latar belakang untuk mengambil status terbaru. Untuk mengoptimalkan penggunaan jaringan, interval polling dihitung secara dinamis berdasarkan waktu yang telah berlalu sejak perubahan status terakhir; permintaan dikirim secara sering saat perangkat sedang aktif, tetapi interval secara bertahap meningkat seiring bertambahnya waktu saat perangkat tetap tidak aktif.

Re-autentikasi

Integrasi ini menyimpan token autentikasi dengan aman setelah login berhasil untuk berkomunikasi dengan server cloud. Jika token ini kedaluwarsa atau dibatalkan oleh layanan cloud karena alasan apapun, Home Assistant akan secara otomatis memicu alur re-autentikasi, meminta kredensial akun untuk dimasukkan kembali.