הגדרה עם חשבון Xiaomi Home

יש להשתמש בשיטה זו אם שואב הרובוט מנוהל כרגע דרך אפליקציית Xiaomi Home. כדי לוודא תאימות, ניתן לבדוק זאת מול אפליקציית Xiaomi Home הרשמית הזמינה עבור iOS ו-Android.

דרישות

• פרטי התחברות: חייב להיות שם המשתמש והסיסמה המדויקים המשמשים לכניסה לאפליקציה הניידת (לא לאתר הרשמי).
• אזור השרת: המדינה שנבחרה חייבת להתאים לאזור שבו המכשיר רשום באפליקציה. אזורים לא תואמים יגרמו לשגיאות של "כניסה נכשלה" או "מכשיר לא נמצא".

כניסות של צד שלישי

אם החשבון נוצר באמצעות שירות צד שלישי (כגון גוגל או אפל), יש ליצור סיסמה ייעודית בתוך הגדרות המשתמש של האפליקציה תחילה. סיסמאות של חשבונות צד שלישי אינן ניתנות לשימוש לאימות.

המלצה לבחירת אפליקציה

חלק מהמכשירים יכולים להיות מוגדרים באמצעות אפליקציית Dreamehome או Xiaomi Home. אלא אם כן נדרשת חיבור מקומי באופן מוחלט, מומלץ בחום להשתמש באפליקציית Dreamehome במקום Xiaomi Home עבור מכשירים נתמכים:

• זרם מצלמה: תכונת זרם המצלמה אינה זמינה למכשירים המוגדרים דרך Xiaomi Home.
• עדכוני Push: החיבור דרך Dreamehome משתמש ב-Cloud Push עבור עדכונים בזמן אמת, מה שמבטל את הצורך בבקשות משוב תקופתיות.

עדיפות לאפשרות ענן

במהלך שלב התצורה, ישנה אפשרות נוספת עדיף ענן והיא מסומנת כברירת מחדל.

• כאשר מסומן (ברירת מחדל): מאלץ את כל התקשורת דרך הענן (אם המכשיר תומך בכך). זה ההתנהגות הברירת מחדל מכיוון שבמכשירים חדשים יותר, Xiaomi השביתו את אפשרויות הגישה המקומית. בנוסף, אם המכשיר ו-Home Assistant נמצאים בתתי רשת שונים, התקשורת המקומית תיכשל.
• כאשר לא מסומן (מומלץ עבור התקנות נתמכות): האינטגרציה שולפת את הטוקן הנדרש מהענן אך יוצרת חיבור מקומי ישיר עם המכשיר (בדומה לשיטה חיבור מקומי). זה מספק את היתרון של חידוש אוטומטי של הטוקן וכתובת ה-IP תוך שמירה על כל התקשורת (למעט נתוני המפה) באופן מקומי. אם שיטה זו גורמת לשגיאה "לא ניתן להגיע למכשיר" בשלב הסופי של ההגדרה, יש לנסות מחדש את ההגדרה עם האפשרות העדף ענן מסומנת.

  דרישת תת-רשת

  מסיבות אבטחה, המכשיר מגיב רק לבקשות שמגיעות מרשת המשנה שלו. לכן, שואב הרובוט ו-Home Assistant חייבים להיות על אותה רשת משנה בדיוק כדי שהתקשורת המקומית תעבוד. ראה מאמר זה על python-miio כדי לפתור בעיות חציית רשת משנה.

אימות קפצ'ה

אם שרתי Xiaomi Home יסמנו את ניסיון הכניסה או את כתובת ה-IP כלא מהימנים, יהיה צורך בצעד אימות קפצ'ה. כאשר זה קורה, יש לפתור את תמונת הקפצ'ה כדי להמשיך לשלב הבא.

אימות דו-שלבי (2FA)

בנוסף לקפצ'ה, ניסיון כניסה לא מהימן עשוי גם להפעיל אימות דו-שלבי (2FA). האינטגרציה תבקש אוטומטית קוד 2FA משרתי Xiaomi Home, אשר נשלח למספר הטלפון הרשום (בעדיפות) או לכתובת המייל.

יש למשוך ולהזין קוד זה בשלב ההגדרה כדי להשלים את הכניסה.

מגבלות 2FA

• תוקף הקוד: אם חלון התצורה ייסגר ותתבצע ניסיון התחברות חדש, קוד 2FA חדש יווצר. יש להשתמש תמיד בקוד האחרון שהתקבל.
• מגבלת שיעור: Xiaomi מגבילה באופן קפדני את מספר קודי ה-2FA שניתן לבקש ביום. ניסיונות התחברות חוזרים עלולים לגרום לחסימה זמנית.

עדכוני מצב תקופתיים

בניגוד לשיטות חיבור ענן אחרות התומכות בהודעות push, החיבור ל-Xiaomi Home נשען לחלוטין על סקר ברקע כדי לקבל את המצב האחרון. כדי למטב את השימוש ברשת, מרווח הסקר מחושב בצורה דינמית בהתאם לזמן שחלף מאז שינוי המצב האחרון; בקשות נשלחות בתדירות גבוהה כאשר המכשיר פעיל, אך המרווח הולך וגדל ככל שהמכשיר נשאר לא פעיל לאורך זמן.

אימות מחדש

האינטגרציה מאחסנת במהירות סמל אימות לאחר התחברות מוצלחת כדי לתקשר עם שרתי הענן. אם סמל זה פג תוקפו או בוטל על ידי שירות הענן מכל סיבה שהיא, Home Assistant יפעיל באופן אוטומטי תהליך אימות מחדש, ויבקש להזין שוב את פרטי החשבון.