فارسی
ظاهر
راه‌اندازی با حساب کاربری Xiaomi Home
این روش باید زمانی استفاده شود که جارو رباتیک در حال حاضر از طریق برنامه Xiaomi Home مدیریت می‌شود. برای اطمینان از سازگاری، می‌توان آن را با برنامه رسمی Xiaomi Home موجود برای iOS و Android بررسی کرد.
الزامات
- اطلاعات ورود: باید دقیقاً همان نام کاربری و رمز عبوری باشد که برای ورود به برنامه موبایل استفاده می‌کنید (نه وبسایت رسمی).
- منطقه سرور: کشور انتخاب‌شده باید با منطقه‌ای که دستگاه در برنامه ثبت شده است مطابقت داشته باشد. ناهماهنگی مناطق منجر به خطاهای "ورود ناموفق" یا "دستگاه یافت نشد" خواهد شد.
ورود با حساب شخص ثالث
اگر حساب کاربری با استفاده از یک سرویس شخص ثالث (مانند گوگل یا اپل) ایجاد شده باشد، ابتدا باید یک رمز عبور اختصاصی در تنظیمات کاربری برنامه ایجاد شود. نمی‌توان از رمز عبور حساب‌های شخص ثالث برای احراز هویت استفاده کرد.
توصیه انتخاب برنامه
برخی دستگاه‌ها می‌توانند با استفاده از برنامه Dreamehome یا Xiaomi Home پیکربندی شوند. مگر اینکه اتصال محلی به طور سختگیرانه مورد نیاز باشد، به شدت توصیه می‌شود به جای Xiaomi Home از برنامه Dreamehome برای دستگاه‌های پشتیبانی‌شده استفاده شود:
- پخش دوربین: ویژگی پخش دوربین برای دستگاه‌هایی که از طریق Xiaomi Home پیکربندی شده‌اند، در دسترس نیست.
- به‌روزرسانی‌های پوش: اتصال Dreamehome از Cloud Push برای به‌روزرسانی‌های لحظه‌ای استفاده می‌کند و نیاز به درخواست‌های دوره‌ای پیمایش را از بین می‌برد.
ترجیح گزینه ابری
در مرحله پیکربندی، گزینه اضافی ترجیح ابری موجود است و به طور پیش‌فرض انتخاب شده است.
- هنگام انتخاب (پیش‌فرض): تمامی ارتباطات را از طریق ابر انجام می‌دهد (اگر دستگاه این قابلیت را داشته باشد). این رفتار پیش‌فرض است زیرا در دستگاه‌های جدیدتر، شیائومی دسترسی محلی را غیرفعال کرده است. علاوه بر این، اگر دستگاه و Home Assistant در زیرشبکه‌های مختلف قرار داشته باشند، ارتباط محلی با شکست مواجه خواهد شد.
- هنگام عدم انتخاب (توصیه شده برای راه‌اندازی‌های پشتیبانی شده): این ادغام توکن مورد نیاز را از ابر دریافت می‌کند اما یک اتصال مستقیم محلی با دستگاه برقرار می‌کند (مشابه روش اتصال محلی). این روش مزیت تجدید خودکار توکن و IP را دارد در حالی که تمامی ارتباطات (به جز داده‌های نقشه) به صورت محلی باقی می‌مانند. اگر این روش در مرحله نهایی پیکربندی خطای «قابل دسترسی نیست» برای دستگاه ایجاد کند، باید پیکربندی مجدداً با گزینه اولویت دادن به ابر انتخاب شده انجام شود.
نیاز به زیرشبکه
به دلایل امنیتی، دستگاه فقط به درخواست‌هایی که از زیرشبکه‌ی خود آن ارسال می‌شوند پاسخ می‌دهد. بنابراین، جاروبرقی رباتیک و Home Assistant باید دقیقاً در همان زیرشبکه باشند تا ارتباط محلی برقرار شود. برای رفع مشکلات زیرشبکه‌های مختلف، این مقاله python-miio را ببینید.
تأیید CAPTCHA
اگر سرورهای Xiaomi Home تلاش ورود یا آدرس IP را غیرقابل اعتماد شناسایی کنند، مرحله تأیید کپچا لازم خواهد بود. در این صورت، تصویر کپچا باید حل شود تا به مرحله بعدی بروید.
احراز هویت دو مرحله‌ای (2FA)
علاوه بر کپچا، تلاش ورود غیرقابل اعتماد ممکن است احراز هویت دو مرحله‌ای (2FA) را نیز فعال کند. یکپارچه‌سازی به‌طور خودکار کد 2FA را از سرورهای Xiaomi Home درخواست می‌کند، که به شماره تلفن ثبت‌شده (با اولویت) یا آدرس ایمیل ارسال می‌شود.
این کد باید بازیابی و وارد مرحله پیکربندی شود تا ورود کامل شود.
محدودیت‌های 2FA
- اعتبار کد: اگر پنجره پیکربندی بسته شود و تلاش جدیدی برای ورود انجام شود، یک کد 2FA جدید تولید خواهد شد. همیشه باید از آخرین کدی که دریافت شده است استفاده شود.
- محدودیت نرخ: شیائومی به شدت تعداد کدهای 2FA که می‌توان در هر روز درخواست کرد را محدود می‌کند. تلاش‌های مکرر برای ورود ممکن است منجر به مسدودیت موقت شود.
به‌روزرسانی‌های دوره‌ای وضعیت
برخلاف سایر روش‌های اتصال ابری که از اعلان‌های فوری پشتیبانی می‌کنند، اتصال Xiaomi Home کاملاً به نظرسنجی پس‌زمینه برای دریافت وضعیت به‌روز متکی است. برای بهینه‌سازی استفاده از شبکه، فاصله نظرسنجی به‌طور پویا بر اساس زمان سپری شده از آخرین تغییر وضعیت محاسبه می‌شود؛ درخواست‌ها در حالی که دستگاه فعال است به‌طور مکرر ارسال می‌شوند، اما با گذشت زمان و در حالی که دستگاه بی‌کار است، این فاصله به تدریج افزایش می‌یابد.
احراز هویت مجدد
این ادغام پس از ورود موفق، به‌طور ایمن توکن احراز هویت را ذخیره می‌کند تا با سرورهای ابری ارتباط برقرار کند. اگر این توکن منقضی شود یا به هر دلیلی توسط سرویس ابری نامعتبر شود، Home Assistant به‌طور خودکار جریان احراز هویت مجدد را فعال می‌کند و درخواست ورود مجدد اطلاعات حساب را می‌دهد.