Cài đặt với Tài khoản Xiaomi Home

Phương pháp này nên được sử dụng nếu robot hút bụi hiện đang được quản lý qua ứng dụng Xiaomi Home. Để đảm bảo tương thích, nó có thể được kiểm tra với ứng dụng Xiaomi Home chính thức có sẵn cho iOS và Android.

Yêu cầu

• Thông tin đăng nhập: Phải là tên người dùng và mật khẩu chính xác đã sử dụng để đăng nhập vào ứng dụng di động (không phải trang web chính thức).
• Khu vực máy chủ: Quốc gia đã chọn phải khớp với khu vực nơi thiết bị được đăng ký trong ứng dụng. Khu vực không khớp sẽ dẫn đến các lỗi "đăng nhập thất bại" hoặc "không tìm thấy thiết bị".

Đăng nhập bên thứ ba

Nếu tài khoản được tạo bằng dịch vụ bên thứ ba (chẳng hạn như Google hoặc Apple), trước tiên phải tạo một mật khẩu riêng trong cài đặt người dùng của ứng dụng. Mật khẩu tài khoản bên thứ ba không thể được sử dụng để xác thực.

Gợi ý chọn ứng dụng

Một số thiết bị có thể được cấu hình sử dụng cả ứng dụng Dreamehome hoặc Xiaomi Home. Trừ khi một kết nối cục bộ là bắt buộc, khuyến nghị mạnh mẽ sử dụng ứng dụng Dreamehome thay vì Xiaomi Home cho các thiết bị được hỗ trợ:

• Truyền hình ảnh Camera: Tính năng truyền hình ảnh camera không khả dụng cho các thiết bị được cấu hình qua Xiaomi Home.
• Cập nhật Đẩy: Kết nối Dreamehome sử dụng Cloud Push để cập nhật theo thời gian thực, loại bỏ nhu cầu gửi các yêu cầu kiểm tra định kỳ.

Ưu tiên Tùy chọn Đám mây

Trong bước cấu hình, một tùy chọn Ưu tiên Đám mây bổ sung có sẵn và được chọn mặc định.

• Khi được chọn (Mặc định): Ép buộc tất cả giao tiếp thông qua đám mây (nếu thiết bị hỗ trợ). Đây là hành vi mặc định vì trên các thiết bị mới hơn, Xiaomi đã vô hiệu hóa khả năng truy cập cục bộ. Hơn nữa, nếu thiết bị và Home Assistant nằm trên các subnet khác nhau, giao tiếp cục bộ sẽ thất bại.
• Khi không được chọn (Khuyến nghị cho các thiết lập được hỗ trợ): Tích hợp sẽ lấy token cần thiết từ đám mây nhưng thiết lập kết nối trực tiếp tại chỗ với thiết bị (tương tự như phương pháp Kết nối cục bộ). Điều này cung cấp lợi ích tự động gia hạn token và IP trong khi giữ tất cả các giao tiếp (ngoại trừ dữ liệu bản đồ) ở mức cục bộ. Nếu phương pháp này dẫn đến lỗi "không thể kết nối thiết bị" ở bước cấu hình cuối cùng, cấu hình nên được thử lại với tùy chọn Ưu tiên Đám mây được chọn.

  Yêu cầu về Subnet

  Vì lý do bảo mật, thiết bị chỉ phản hồi các yêu cầu xuất phát từ cùng một mạng con của nó. Do đó, robot hút bụi và Home Assistant phải ở cùng một mạng con chính xác để giao tiếp cục bộ hoạt động. Xem bài viết python-miio này để khắc phục sự cố về giao tiếp giữa các mạng con.

Xác minh Captcha

Nếu các máy chủ Xiaomi Home đánh dấu nỗ lực đăng nhập hoặc địa chỉ IP là không đáng tin cậy, bước xác minh captcha sẽ được yêu cầu. Khi điều này xảy ra, hình ảnh captcha phải được giải quyết để tiếp tục bước tiếp theo.

Xác thực Hai Yếu tố (2FA)

Ngoài captcha, một nỗ lực đăng nhập không đáng tin cậy cũng có thể kích hoạt Xác thực Hai Yếu tố (2FA). Tích hợp sẽ tự động yêu cầu mã 2FA từ các máy chủ Xiaomi Home, mã này được gửi đến số điện thoại đã đăng ký (ưu tiên) hoặc địa chỉ email.

Mã này phải được lấy và nhập vào bước cấu hình để hoàn tất việc đăng nhập.

Hạn chế của 2FA

• Tính hợp lệ của mã: Nếu cửa sổ cấu hình bị đóng và một lần đăng nhập mới được thực hiện, một mã 2FA mới sẽ được tạo. Luôn phải sử dụng mã nhận được gần đây nhất.
• Giới hạn tốc độ: Xiaomi nghiêm ngặt hạn chế số lượng mã 2FA có thể yêu cầu mỗi ngày. Các lần thử đăng nhập lặp lại có thể dẫn đến việc tạm thời bị chặn.

Cập nhật trạng thái định kỳ

Không giống như các phương pháp kết nối đám mây khác hỗ trợ thông báo đẩy, kết nối Xiaomi Home hoàn toàn dựa vào việc truy vấn nền để lấy trạng thái mới nhất. Để tối ưu hóa việc sử dụng mạng, khoảng thời gian truy vấn được tính toán động dựa trên thời gian đã trôi qua kể từ lần thay đổi trạng thái cuối cùng; các yêu cầu được gửi thường xuyên khi thiết bị đang hoạt động, nhưng khoảng thời gian sẽ dần tăng lên khi thiết bị vẫn ở trạng thái nhàn rỗi.

Xác thực lại

Tích hợp lưu trữ an toàn một token xác thực sau khi đăng nhập thành công để giao tiếp với các máy chủ đám mây. Nếu token này hết hạn hoặc bị dịch vụ đám mây vô hiệu hóa vì bất kỳ lý do nào, Home Assistant sẽ tự động kích hoạt quy trình xác thực lại, yêu cầu nhập lại thông tin tài khoản.