Xiaomi Homeアカウントでのセットアップ
この方法は、ロボット掃除機が現在Xiaomi Homeアプリ経由で管理されている場合に使用してください。互換性を確認するために、iOSおよびAndroidで利用可能な公式Xiaomi Homeアプリで確認することができます。
要件
- 資格情報: モバイルアプリにログインする際に使用する正確なユーザー名とパスワードである必要があります（公式ウェブサイト用ではありません）。
- サーバー地域: 選択した国は、アプリでデバイスが登録されている地域と一致しなければなりません。地域が一致しないと「ログイン失敗」や「デバイスが見つかりません」のエラーが発生します。
サードパーティログイン
アカウントがサードパーティのサービス（GoogleやAppleなど）を使用して作成された場合、まずアプリケーションのユーザー設定内で専用のパスワードを生成する必要があります。サードパーティのアカウントパスワードは認証に使用できません。
アプリ選択の推奨
一部のデバイスは、DreamehomeまたはXiaomi Homeアプリのいずれかで構成できます。ローカル接続が厳密に必要でない限り、サポートされているデバイスにはXiaomi Homeの代わりにDreamehomeアプリを使用することが強く推奨されます:
- カメラストリーム: Xiaomi Home経由で構成されたデバイスでは、カメラストリーム機能は利用できません。
- プッシュ更新: Dreamehome接続ではクラウドプッシュを利用してリアルタイム更新を行うため、定期的なポーリング要求は不要です。
クラウドオプションを推奨
構成ステップ中に、追加のクラウドを優先オプションがあり、デフォルトでチェックされています。
- チェック時（デフォルト）: すべての通信をクラウド経由で行います（デバイスでサポートされている場合）。これはデフォルトの動作です。新しいデバイスでは、Xiaomiがローカルアクセス機能を無効にしているためです。さらに、デバイスとHome Assistantが異なるサブネット上にある場合、ローカル通信は失敗します。
- チェック解除時（サポートされている設定の場合に推奨）: インテグレーションはクラウドから必要なトークンを取得しますが、デバイスとの直接ローカル接続を確立します（ローカル接続の方法と同様）。これにより、トークンとIPの自動更新の利点を得ながら、マップデータを除くすべての通信をローカルで保持できます。この方法で最終設定ステップで「デバイスに到達できません」というエラーが発生した場合は、クラウド優先オプションをチェックした状態で再設定してください。
サブネット要件
セキュリティ上の理由から、デバイスは自分自身のサブネットからのリクエストにのみ応答します。したがって、ロボット掃除機とHome Assistantは、ローカル通信を行うために正確に同じサブネット上にある必要があります。このpython-miioの記事を参照して、サブネット間の問題をトラブルシューティングしてください。
キャプチャの確認
Xiaomi Homeサーバーがログイン試行またはIPアドレスを信頼できないものとしてフラグを立てた場合、キャプチャ確認が必要になります。この場合、次のステップに進むにはキャプチャ画像を解く必要があります。
二要素認証（2FA）
キャプチャに加えて、信頼されていないログイン試行は二要素認証（2FA）をトリガーする場合があります。統合機能は自動的にXiaomi Homeサーバーから2FAコードを要求します。このコードは登録済みの電話番号（優先）またはメールアドレスに送信されます。
このコードを取得し、設定ステップに入力することでログインを完了します。
2FAの制限
- コードの有効性: 設定ウィンドウが閉じられ、新しいログイン試行が行われた場合、新しい2FAコードが生成されます。常に最新に受信したコードを使用する必要があります。
- レート制限: Xiaomiは、1日にリクエストできる2FAコードの数を厳密に制限しています。繰り返しのログイン試行は、一時的なブロックにつながる可能性があります。
定期的な状態更新
プッシュ通知をサポートする他のクラウド接続方法とは異なり、Xiaomi Homeの接続は、最新の状態を取得するために完全にバックグラウンドポーリングに依存しています。ネットワーク使用量を最適化するために、ポーリング間隔は最後の状態変化から経過した時間に基づいて動的に計算されます。デバイスがアクティブに稼働している間はリクエストが頻繁に送信されますが、デバイスがアイドル状態のまま時間が経過すると間隔は徐々に長くなります。
再認証
統合は、クラウドサーバーと通信するために、ログイン成功後に認証トークンを安全に保存します。このトークンが期限切れになる、またはクラウドサービスによって何らかの理由で無効化された場合、Home Assistantは自動的に再認証フローを開始し、アカウントの認証情報を再入力するよう求めます。