在 HomeAssistant (HA) 中使用 HomePod Mini 作为语音播放器，本质上是将其作为一个 DLNA/AirPlay 媒体播放机。
由于国内网络环境下，自带的 Google TTS 或需联网的云端服务经常失效，我推荐使用目前国内最稳定、效果最好的方案：Microsoft Edge TTS。它无需特殊网络，音质自然，且完全免费。
以下是基于 HomeAssistant 2025.12.2 版本的详细操作教程。
第一步：将 HomePod Mini 接入 HomeAssistant
HomeAssistant 拥有原生 Apple 协议支持，通常会自动发现设备。
- 自动发现：确保 HomePod Mini 与 HA 在同一局域网下。进入 HA 界面，点击 配置 ->设备与服务。
- 添加集成：如果看到“已发现”卡片里有 Apple TV 或 HomeKit Accessory Protocol，点击 配置。
- 手动添加：如果没有自动发现，点击右下角 添加集成，搜索 Apple，选择 Apple TV（这是苹果设备的统一集成）。
- 配对：HA 会要求在 HomePod 上输入验证码。此时你的手机或 iPad（作为家庭中枢）会弹出验证码，将其输入 HA 即可。
- 确认：成功后，你会在“设备”中看到一个类型为 media_player 的实体，例如 media_player.homepod_mini。
第二步：安装 Edge TTS（最适合国内的语音方案）
为了让 HomePod 说中文，我们需要一个“发声引擎”。
- 进入 配置 ->设备与服务 ->添加集成。
- 搜索 Microsoft Edge TTS。
- 注：如果官方商店没有，请先确保安装了 HACS，在 HACS 中搜索
安装后，它会提供一个 tts.microsoft_edge_tts_cloud 服务。
设置中文：在集成选项里，建议将默认声音设置为 zh-CN-XiaoxiaoNeural（晓晓，最自然的中文女声）。
第三步：配置基础 TTS 选项
在 HA 最新版本中，为了让语音播报更顺畅，我们需要在 configuration.yaml 中简单确认一下（或者直接在 UI 界面配置）。
点击左侧 开发者工具 ->服务。
输入 tts.speak 测试是否工作。
注意点
：为了让 HomePod 接收到音频文件，HA 的“内部地址”必须配置正确。
- 进入 配置 ->系统 ->网络。
- 确保 Home Assistant URL 设置为你的局域网 IP（例如 http://192.168.1.100:8123），不要设为公网地址。
第四步：小白自动化教程——“欢迎回家”播报
现在我们做一个最简单的自动化：当某人回到家，HomePod 自动欢迎。
- 进入 配置 ->自动化与场景 ->创建自动化。
- 添加触发字：选择“状态”。
- 实体：person.your_name（你的用户）。
- 从：not_home 到：home。
添加动作：选择“调用服务”。
- 服务：tts.speak（注意：2025版本推荐用 speak 而不是旧的 say）。
- 媒体源（Media Player）：选择你的 media_player.homepod_mini。
- TTS 引擎：选择 Edge TTS。
- 消息：输入 欢迎回家，今天辛苦了！
保存并测试：点击动作右上角的三个点，选择“运行”，看看你的 HomePod 是否发声。
进阶：如何让语音更丝滑？
由于 HomePod 播放音频前会有微小的延迟，建议在自动化动作中按以下顺序配置：
- 动作 1：media_player.volume_set（设置音量到 0.5，防止音量太大吓到人）。
- 动作 2：tts.speak（发送语音）。
常见问题排查（避坑指南）：
- 没有声音？
- 检查 HomePod 是否在“家庭” App 中被禁用了 AirPlay 权限。设置为“同一局域网下的任何人”。
- 确认 HA 的 IP 地址是否固定。如果 HA 的 IP 变了，HomePod 就找不到音频文件。
声音断断续续？
- 这是因为国内连接微软 Edge 服务器偶尔抖动。虽然不需要翻墙，但如果网络太差，建议在 HA 中配置 Media Source 缓存。
怎么换成男声？
- 在 Edge TTS 集成设置里，将 zh-CN-YunxiNeural 设为默认即可，这是很自然的男声。
通过以上步骤，你就拥有了一个完全本地化、网络依赖极低且音质出众的 HomePod 语音播报系统。
如果出现这个报错 no response to SETUP rtsp://… 的核心含义是：握手失败。你只需要在你的防火墙放行10000-65535的udp端口请求就可以。
