Home Assistant（HA）2025.12.2 では、Midea（美的）デバイスを接続する際にもっとも安定し機能も最も充実した方法は、依然としてコミュニティ統合のローカル LAN 制御方式です。美的は 2024〜2025 年に Matter 対応の新デバイス（Midea U エアコンなど）をいくつか発表しましたが、公式の Matter 統合は機能が限られることが多く（通常はオン／オフと温度調整のみ）、風量やスイングの制御、詳細なセンサーデータの取得はできません。
以下は Home Assistant 2025.12.2 環境で検証済みの詳細なステップバイステップのチュートリアルで、現在もっとも評価の高い Midea AC LAN 統合方式を採用しています。
🟢 中心となる方式の選択
- 推奨方式：HACS を使って Midea AC LAN をインストール（作者：wuwentao）。
- メリット：
- 完全ローカル制御：設定完了後はネットワークが切れても使え、応答速度も非常に高速です。
- 機能が充実：エアコン、除湿機、扇風機、給湯器など多様なデバイスに対応し、スイング、ドライ、ECO などの高度なモードもサポートします。
- Token の自動取得：新しいバージョンの統合はアカウントログインでデバイスの Key/Token を自動取得でき、面倒なパケットキャプチャは不要です。
🔧 事前準備
- 美的デバイスがネットワーク設定済み：美的デバイスが自宅の Wi-Fi に接続されていることを確認してください。
- 強く推奨：「美的美居」（Meiju）または「NetHome Plus」アプリでネットワーク設定を行ってください。新しく購入したデバイスの場合は、まず NetHome Plus アプリ（国際版）を試すことをおすすめします。サードパーティによる Token 取得に寛容だからです。ただし中国国内向けデバイスは通常、美的美居しか使えません。
Home Assistant に HACS がインストール済み：
- HACS（Home Assistant Community Store）をまだインストールしていない場合は、まず公式ドキュメントを参照してインストールしてください。非公式デバイスを接続するために欠かせないストアです。
📝 詳細なステップ別チュートリアル
ステップ1：HACS で統合をダウンロードする
- Home Assistant を開き、左サイドバーの HACS をクリックします。
- Integrations（統合）をクリックします。
- 右下の + Explore & Download Repositories（リポジトリを探してダウンロード）をクリックします。
- 検索ボックスに Midea AC LAN と入力します。
- wuwentao が開発した Midea AC LAN を見つけ、クリックして開きます。
- 注意：作者が wuwentao であることを確認してください。現在もっとも活発にメンテナンスされているバージョンです。
右下の Download をクリックします。ダウンロードが完了すると、システムが Home Assistant の再起動を促します。
設定 -> システム -> 右上の電源ボタン -> Home Assistant を再起動 に進みます。
ステップ2：統合を追加して設定する
再起動が完了したら、デバイスの追加を始めます。
- 左サイドバーの 設定（Settings）-> デバイスとサービス（Devices & Services）をクリックします。
- 右下の + 統合を追加（Add Integration）をクリックします。
- Midea AC LAN を検索してクリックします。
- 設定モードを選択します：
- いくつかの選択肢が表示されます。通常は “Auto”（自動スキャン）または “Add device by account”（アカウントでデバイスを追加）を選びます。
- 初心者におすすめの方法：”Add device by account”（アカウントで追加）を選択します。2025 年でもっとも簡単な Token 取得方法で、手動でのパケットキャプチャは不要です。
ステップ3：Token の自動取得とデバイスの追加
美的デバイスはローカル LAN 制御に Token と Key が必要で、このステップが鍵となります。
- 表示されたアカウントログイン画面で：
- Account Type（アカウント種別）：「美的美居」を使っている場合は Meiju を、”NetHome Plus” を使っている場合は NetHome Plus を選択します。
- Username/Password：アプリのアカウントとパスワードを入力します。
Submit（送信）をクリックします。
統合は自動的に美的クラウドに接続し、アカウントに紐づくすべてのデバイスの IP アドレス、ID、Token、Key を取得します。
取得に成功すると、リストに検出されたデバイスが表示されます。追加したいデバイスにチェックを入れ、送信をクリックします。
重要：追加に成功すると、統合はローカル LAN モードでの制御に切り替わります。この時点で、たとえアプリのパスワードを変更したり自宅の外部ネットワークが切れたとしても、HA とエアコンが同じルーター配下にあれば制御できます。
💡 応用設定とよくある質問（FAQ）
1. エンティティの命名とカード
追加に成功すると、「概要」ページに標準的なエアコンカード（Climate Entity）が表示されます。
- 機能テスト：スイッチをクリックしたり温度を調整してみてください。応答はほぼ「秒単位」で、アプリよりも速いことがわかります。
- 高度な属性：カード右上の三点メニュー（またはエンティティアイコン）をクリックすると、Swing（スイング）、Fan Mode（風量）、Preset（ECO/Boost などのプリセットモード）といったより多くの制御項目が表示されます。
2. 自動検索に失敗した場合は？（手動 IP 方式）
アカウント経由でもデバイスを検出できない場合、デバイスが別セグメント（VLAN）にあるか、UDP ブロードキャストがルーターに遮断されている可能性があります。
- ルーターの管理画面で美的デバイスの IP アドレスを確認します（IP の変化による接続断を防ぐため、ルーターで美的デバイスに固定 IP を割り当てることをおすすめします）。
- 統合を追加する際に “Add device manually”（手動で追加）を選択します。
- IP アドレスを入力します。このとき Token と Key を手動で入力する必要がある場合があります。
- Token 取得の代替案：統合が自動取得できない場合は、PC 用の Python ツール msmart-ng を使用します。
- PC のターミナルで実行：pip install msmart-ng の後に msmart-ng discover を実行すると、ローカルネットワークをスキャンして Token の計算を試みます。
3. 一部のセンサーが表示されないのはなぜ？
デフォルトでは、パフォーマンスのために一部の非コアセンサー（外気温、電力統計など）が無効になっている場合があります。
- 設定 -> デバイスとサービス -> Midea AC LAN をクリック -> 該当するデバイスをクリック に進みます。
- 「エンティティ」リストで、グレー表示のエンティティをクリックし、設定で Enable（有効化）すると、しばらくしてデータが表示されます。
4. Matter について（新型デバイス限定）
お使いのデバイスが 2024 年以降に生産された上位モデル（Midea U 型窓用エアコンの新型など）で、パッケージに Matter ロゴが印刷されている場合。
- HA の Matter (BETA) 統合から、本体の QR コードを直接スキャンして接続できます。
- デメリット：現在 Matter プロトコルのエアコン対応は基本的なもので、「防直吹」や「セルフクリーニング」などの特有機能は制御できない可能性があります。これらの機能が必要な場合は、上記の LAN 方式を使い続けてください。
✅ まとめ
2025.12.2 バージョンの HA ユーザーにとって、HACS + Midea AC LAN（wuwentao 版）は依然として最良の解です。美的クラウドの不安定さを回避し、完全なローカル制御を実現しており、現在もっとも「完璧な」接続方法です。
