11HomeAssistant 中如何添加使用hompodmini，用于语音播报TTS应用

admin

在 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端口请求就可以。