Home Assistant (HA) で HomePod Mini を音声プレイヤーとして使うというのは、本質的には DLNA/AirPlay メディアプレイヤーとして扱うということです。
一部のネットワーク環境では、標準の Google TTS やインターネット接続が必要なクラウドサービスがたびたび使えなくなります。そこで、現在もっとも安定していて音質の良い Microsoft Edge TTS をおすすめします。特別なネットワーク設定は不要で、音声は自然、しかも完全無料です。
以下は Home Assistant 2025.12.2 バージョンに基づく詳細な操作チュートリアルです。
ステップ1：HomePod Mini を Home Assistant に接続する
Home Assistant は Apple プロトコルをネイティブにサポートしており、通常はデバイスを自動検出します。
- 自動検出：HomePod Mini と HA が同じ LAN にあることを確認します。HA の画面で 設定 ->デバイスとサービス をクリックします。
- 統合を追加：「検出済み」カードに Apple TV または HomeKit Accessory Protocol があれば、設定 をクリックします。
- 手動で追加：自動検出されない場合は、右下の 統合を追加 をクリックし、Apple を検索して Apple TV（Apple デバイスの統合されたインテグレーション）を選択します。
- ペアリング：HA は HomePod での確認コード入力を求めます。このときスマホや iPad（ホームハブ）にコードが表示されるので、それを HA に入力します。
- 確認：成功すると、「デバイス」に media_player タイプのエンティティが表示されます。たとえば media_player.homepod_mini です。
ステップ2：Edge TTS をインストールする（国内に最適な音声ソリューション）
HomePod に中国語を話させるには、「発声エンジン」が必要です。
- 設定 ->デバイスとサービス ->統合を追加 に進みます。
- Microsoft Edge TTS を検索します。
- 注：公式ストアにない場合は、まず HACS がインストールされていることを確認し、HACS 内で検索してください。
インストールすると、tts.microsoft_edge_tts_cloud サービスが提供されます。
中国語の設定：統合のオプションで、デフォルトの音声を zh-CN-XiaoxiaoNeural（暁暁、最も自然な中国語女性音声）に設定することをおすすめします。
ステップ3：基本的な TTS オプションを設定する
HA の最新バージョンでは、音声アナウンスをスムーズにするために configuration.yaml で簡単に確認する必要があります（または UI 画面で直接設定します）。
左側の 開発者ツール ->サービス をクリックします。
tts.speak を入力して動作するかテストします。
注意点
：HomePod が音声ファイルを受信するために、HA の「内部アドレス」を正しく設定する必要があります。
- 設定 ->システム ->ネットワーク に進みます。
- Home Assistant URL が LAN の IP（例：http://192.168.1.100:8123）に設定されていることを確認し、グローバルアドレスにしないでください。
ステップ4：初心者向け自動化チュートリアル ― 「おかえりなさい」アナウンス
ここで最も簡単な自動化を作ります：誰かが帰宅したら、HomePod が自動で歓迎します。
- 設定 ->オートメーションとシーン ->オートメーションを作成 に進みます。
- トリガーを追加：「状態」を選択します。
- エンティティ：person.your_name（あなたのユーザー）。
- From：not_home、To：home。
アクションを追加：「サービスを呼び出す」を選択します。
- サービス：tts.speak（注意：2025 バージョンでは古い say ではなく speak が推奨です）。
- メディアプレイヤー：media_player.homepod_mini を選択します。
- TTS エンジン：Edge TTS を選択します。
- メッセージ：おかえりなさい、今日もお疲れさま！ と入力します。
保存してテスト：アクション右上の三点をクリックし、「実行」を選択して、HomePod が発声するか確認します。
上級：音声をもっと滑らかにするには？
HomePod は音声を再生する前にわずかな遅延があるため、自動化のアクションを次の順序で設定することをおすすめします：
- アクション1：media_player.volume_set（音量を 0.5 に設定し、大きすぎて驚かせないようにします）。
- アクション2：tts.speak（音声を送信します）。
よくある問題のトラブルシューティング（失敗回避ガイド）：
- 音が出ない？
- 「ホーム」App で HomePod の AirPlay 権限が無効になっていないか確認します。「同じネットワーク上の全員」に設定します。
- HA の IP アドレスが固定されているか確認します。HA の IP が変わると、HomePod は音声ファイルを見つけられません。
音声が途切れる？
- これは Microsoft Edge サーバーへの接続が時々不安定になるためです。VPN は不要ですが、ネットワークが悪い場合は HA で Media Source キャッシュを設定してください。
男性の声に変えるには？
- Edge TTS の統合設定で zh-CN-YunxiNeural をデフォルトに設定するだけです。とても自然な男性音声です。
以上の手順で、完全にローカル化され、ネットワーク依存が極めて低く、音質も優れた HomePod 音声アナウンスシステムが完成します。
no response to SETUP rtsp://… というエラーが出る場合、核心的な意味はハンドシェイクの失敗です。ファイアウォールで UDP ポート 10000-65535 を許可するだけで解決できます。
