Xiaomi Home 集成中小爱音箱文本朗读功能详解

功能概述

Xiaomi Home 集成作为 Home Assistant 中控制小米智能设备的重要组件，提供了对小爱智能音箱的全面支持。其中文本朗读功能是用户高频使用的核心特性之一，允许用户通过 Home Assistant 向小爱音箱发送任意文本内容进行语音播报。

功能实现原理

该功能基于 Home Assistant 的通知服务(notify)实现，通过特定的消息格式向小爱音箱发送播放指令。与直接调用服务不同，这里采用了列表形式的参数传递方式，以支持更多扩展参数。

配置步骤详解

基础配置

1. 启用调试模式：

   • 进入 Home Assistant 设置界面
   • 选择"设备与服务"
   • 找到已配置的 Xiaomi Home 集成
   • 点击"配置"
   • 启用"Action 调试模式"选项

2. 确认服务生成：

   • 启用后系统会自动生成两个通知服务：
     • 智能音箱播放文本
     • 智能音箱执行文本指令

基本使用方法

1. 直接调用服务：

   • 在开发者工具的服务调用界面
   • 选择对应的通知服务
   • 消息内容格式为：["要朗读的文本内容"]

2. 自动化中使用：

   - alias: "小爱朗读示例"
     trigger:
       # 你的触发条件
     action:
       - service: notify.xiaomi_cn_[你的设备ID]_play_text
         data:
           message: '["欢迎回家"]'
   

高级应用方案

通过脚本实现交互式播报

对于需要频繁变更播报内容的场景，可以创建专用脚本：

alias: 小爱播放文本
sequence:
  - action: notify.send_message
    metadata: {}
    data:
      message: ' ["{{ msg }}"] '
    target:
      entity_id: notify.xiaomi_cn_[你的设备ID]_play_text
fields:
  msg:
    selector:
      text: null
    required: true
    name: 播报内容
description: ""
icon: mdi:speaker-message

结合辅助元素实现UI控制

1. 创建文本输入辅助元素：

   • 在设置中创建文本类型的辅助元素
   • 命名为"小爱播报内容"

2. 创建自动化脚本：

   alias: 小爱播放文本
   sequence:
     - action: notify.send_message
       metadata: {}
       data:
         message: ' ["{{ states(''input_text.xiao_ai_bo_bao'') }}"] '
       target:
         entity_id: notify.xiaomi_cn_*_play_text*
   

3. 创建自动化规则：

   • 当文本输入内容变化时触发播报
   • 关联上述脚本

4. 添加到仪表盘：

   • 将文本输入辅助元素添加到主页
   • 实现随时修改随时播报

使用技巧与注意事项

1. 消息格式要求：

   • 必须使用列表格式
   • 文本内容需用双引号包裹
   • 完整格式示例：["文本内容"]

2. 特殊字符处理：

   • 包含特殊字符时需要转义
   • 建议先进行简单文本测试

3. 多设备支持：

   • 可通过设备ID指定具体音箱
   • 也可使用通配符(*)批量操作

4. 性能优化：

   • 频繁播报建议间隔至少3秒
   • 长文本建议分割为多段

常见问题解决方案

1. 服务未显示：

   • 确认已启用Action调试模式
   • 检查集成配置是否正确

2. 播报无效果：

   • 检查设备网络连接
   • 确认消息格式准确
   • 验证设备ID是否正确

3. 脚本报错：

   • 检查YAML格式
   • 确认变量引用正确
   • 验证实体ID存在

通过以上方法，用户可以灵活地在Home Assistant中实现小爱音箱的文本播报功能，满足各种智能家居场景的需求。