Tetapan dengan Akaun Xiaomi Home

Kaedah ini perlu digunakan jika vakum robot kini diuruskan melalui aplikasi Xiaomi Home. Untuk memastikan keserasian, ia boleh disahkan menggunakan aplikasi rasmi Xiaomi Home yang tersedia untuk iOS dan Android.

Keperluan

• Maklumat Akaun: Mesti menggunakan nama pengguna dan kata laluan yang tepat yang digunakan untuk log masuk ke aplikasi mudah alih (bukan laman web rasmi).
• Wilayah Pelayan: Negara yang dipilih mesti sepadan dengan wilayah di mana peranti didaftarkan dalam aplikasi. Wilayah yang tidak sepadan akan mengakibatkan ralat "gagal log masuk" atau "peranti tidak ditemui".

Log Masuk Pihak Ketiga

Jika akaun dibuat menggunakan perkhidmatan pihak ketiga (seperti Google atau Apple), kata laluan khusus mesti dijana terlebih dahulu dalam tetapan pengguna aplikasi. Kata laluan akaun pihak ketiga tidak boleh digunakan untuk pengesahan.

Saranan Pemilihan Aplikasi

Sesetengah peranti boleh dikonfigurasi menggunakan sama ada aplikasi Dreamehome atau Xiaomi Home. Kecuali sambungan tempatan benar-benar diperlukan, sangat disarankan untuk menggunakan aplikasi Dreamehome dan bukannya Xiaomi Home untuk peranti yang disokong:

• Aliran Kamera: Ciri aliran kamera tidak tersedia untuk peranti yang dikonfigurasi melalui Xiaomi Home.
• Kemaskini Tolak: Sambungan Dreamehome menggunakan Cloud Push untuk kemaskini masa nyata, menghapuskan keperluan permintaan pengambilan berkala.

Pilih Pilihan Awan

Semasa langkah konfigurasi, satu pilihan tambahan Pilih Awan tersedia dan diperiksa secara lalai.

• Apabila dicentang (Lalai): Memaksa semua komunikasi melalui awan (jika disokong oleh peranti). Ini adalah tingkah laku lalai kerana pada peranti baru, Xiaomi telah mematikan keupayaan akses tempatan. Tambahan pula, jika peranti dan Home Assistant berada pada subnet yang berbeza, komunikasi tempatan akan gagal.
• Apabila tidak dicentang (Disyorkan untuk tetapan yang disokong): Integrasi mengambil token yang diperlukan dari awan tetapi mewujudkan sambungan tempatan langsung dengan peranti (serupa dengan kaedah Sambungan Tempatan). Ini memberikan manfaat pembaharuan token dan IP secara automatik sambil mengekalkan semua komunikasi (kecuali data peta) secara tempatan. Jika kaedah ini mengakibatkan ralat "tidak dapat menghubungi peranti" pada langkah konfigurasi akhir, konfigurasi harus dicuba semula dengan pilihan Prefer Cloud dicentang.

  Keperluan Subnet

  Atas alasan keselamatan, peranti hanya akan bertindak balas kepada permintaan yang datang dari subnetnya sendiri. Oleh itu, robot vakum dan Home Assistant mesti berada dalam subnet yang sama untuk komunikasi tempatan berfungsi. Lihat artikel python-miio ini untuk menyelesaikan isu merentas subnet.

Pengesahan Captcha

Jika pelayan Xiaomi Home menandakan percubaan log masuk atau alamat IP sebagai tidak dipercayai, langkah pengesahan captcha akan diperlukan. Apabila ini berlaku, imej captcha mesti diselesaikan untuk meneruskan ke langkah seterusnya.

Pengesahan Dua Faktor (2FA)

Selain captcha, percubaan log masuk yang tidak dipercayai juga mungkin mencetuskan Pengesahan Dua Faktor (2FA). Integrasi akan secara automatik meminta kod 2FA daripada pelayan Xiaomi Home, yang dihantar ke nombor telefon berdaftar (diutamakan) atau alamat e-mel.

Kod ini mesti diperoleh dan dimasukkan ke dalam langkah konfigurasi untuk melengkapkan log masuk.

Had 2FA

• Kesahan Kod: Jika tetingkap konfigurasi ditutup dan cubaan log masuk baru dibuat, kod 2FA baharu akan dijana. Kod yang diterima yang terbaru mesti sentiasa digunakan.
• Had Kekerapan: Xiaomi mengehadkan dengan tegas bilangan kod 2FA yang boleh diminta setiap hari. Cubaan log masuk berulang mungkin mengakibatkan sekatan sementara.

Kemas Kini Status Berkala

Berbeza dengan kaedah sambungan awan lain yang menyokong pemberitahuan push, sambungan Xiaomi Home sepenuhnya bergantung pada polling latar belakang untuk mendapatkan status terkini. Untuk mengoptimumkan penggunaan rangkaian, selang polling dikira secara dinamik berdasarkan masa yang telah berlalu sejak perubahan status terakhir; permintaan dihantar dengan kerap ketika peranti sedang berfungsi, tetapi selang itu secara beransur-ansur meningkat apabila lebih banyak masa berlalu sementara peranti kekal tidak aktif.

Pengesahan Semula

Integrasi menyimpan token pengesahan dengan selamat selepas log masuk berjaya untuk berkomunikasi dengan pelayan awan. Jika token ini tamat tempoh atau dibatalkan oleh perkhidmatan awan atas sebarang sebab, Home Assistant akan secara automatik memulakan aliran pengesahan semula, meminta kelayakan akaun dimasukkan semula.