ローカル接続での設定 推奨されない
この方法は、クラウド接続に依存せずにロボット掃除機への直接ローカル接続を確立するために使用されます。この方法を使用するには、デバイスが少なくとも一度公式のXiaomi Homeアプリ（iOSおよびAndroidで利用可能）に正常に追加され、有効なトークンを生成している必要があります。さらに、このセットアップ手順の間、統合がクラウドから必要なIPアドレスとトークンを取得できるように、アカウントにリンクされたままである必要があります。
デバイス互換性
この接続方法は、Xiaomi Homeアプリでサポートされている2022年以前に製造されたデバイス専用です。デバイスがXiaomi Homeアプリに追加できない場合、いかなるトークンでもローカルAPIを公開することはありません。
マップサポートなし 推奨されない
ローカルAPIを通じてマップデータを取得することは技術的に不可能です。その結果、ローカル接続方法ではマップサポートがありません。これにより、清掃履歴、マップ復元、および動的な部屋エンティティなど、マップデータに依存するいくつかの主要な機能が完全に無効化されます。マップとそれに依存する機能は統合のコア機能にとって重要であるため、この接続方法は厳密に推奨されません。完全かつ完全に機能する体験を得るためには、代わりにクラウド接続方法のいずれかを使用することが強く推奨されます。
IPとトークンの取得
ローカル接続を設定するには、デバイスのIPアドレスとトークンを手動で入力する必要があります。
サブネット要件
セキュリティ上の理由から、デバイスは自身のサブネットからのリクエストにのみ応答します。そのため、ロボット掃除機とHome Assistantは、ローカル通信を機能させるためにまったく同じサブネット上にある必要があります。クロスサブネットの問題をトラブルシューティングするには、このpython-miioの記事を参照してください。
方法 1: Xiaomi Cloud Tokens Extractor 推奨
これは最も信頼性の高い方法です。Windows、macOS、またはLinuxで動作し、Xiaomiクラウドサーバーに直接接続して、アカウントにリンクされているすべてのデバイスのIPアドレスとトークンを同時に取得します。
- ツールをダウンロード: GitHubからXiaomi Cloud Tokens Extractorの適切なリリース（例:
.exeはWindows用）をダウンロードしてください。 - アプリケーションを実行: ダウンロードしたファイルを実行して、ターミナルインターフェースを開きます。
- 認証情報を入力: Xiaomi Homeアプリで使用している正確なユーザー名（メールまたはXiaomi ID）とパスワードを入力してください。
- サーバー地域を選択: Xiaomi Homeアプリに対応するサーバー地域を指定してください（例:
deはヨーロッパの場合）。地域が不明な場合は、プロンプトを空白のままEnterを押して、利用可能なすべてのサーバーをスキャンしてください。 - トークンを取得する: このツールは、アカウントに接続されているすべてのデバイスのリストを出力します。リスト内で対象の掃除機を探し、対応する32文字のトークンをコピーします。
方法 2: デスクトップGUIアプリケーション（Get_MiHome_devices_token）
コマンドラインツールよりもグラフィカルユーザーインターフェースを好むユーザー向けに、デスクトップアプリケーションが利用可能です。
- アプリケーションのダウンロード: GitHubからGet_MiHome_devices_tokenアプリケーションをダウンロードしてインストールします。
- ログイン: アプリを開き、Xiaomiアカウントの資格情報を入力し、適切なサーバー地域を選択します。
- トークンを取得する: 認証が完了すると、すべてのリンクされたデバイスと対応するIPアドレスおよびトークンが表形式で表示されます。
方法 3: Android用改造Mi Homeアプリ 推奨されない
Androidユーザーは、モバイルデバイス上のアプリインターフェースで直接トークンを表示できる改造版Mi Homeアプリを利用できます。
- オリジナルアプリのアンインストール: Androidデバイスから公式のMi Homeアプリケーションを完全にアンインストールします。（注：デバイスはクラウドアカウントに安全にリンクされたまま残ります）
- 改造アプリのインストール: オンラインで「MiHome by Vevs」の改造APKを検索し、最新バージョンをダウンロードしてデバイスにインストールします。
- ログイン: 改造アプリを開き、Xiaomiアカウントの認証情報を使用してログインします。
- トークンの取得: 対象の掃除機を選択してその制御インターフェースを開きます。右上の三点リーダーをタップして設定にアクセスし、ネットワーク情報または一般設定セクションに移動します。デバイスのIPアドレスとトークンは、この画面で直接確認できます。