在XiaoMi Home Assistant集成中实现智能音箱动态文本播放的解决方案

背景与问题分析

在智能家居场景中，通过语音设备播放动态内容是一个常见需求。XiaoMi Home Assistant集成用户反馈了两个典型问题：

1. 直接使用模板函数now()无法在播放文本中渲染
2. 尝试使用字符串格式化时出现参数格式错误

这些问题本质上反映了设备服务对动态内容处理机制的特殊性。

技术原理剖析

智能音箱的文本播放服务通常设计为接收固定格式的文本数据，而原生模板渲染发生在服务调用之前。当直接传递包含模板语法的字符串时：

1. 服务端会将其视为普通字符串而非模板
2. 复杂的嵌套结构容易导致解析失败
3. 原始方案缺少必要的JSON序列化步骤

解决方案实现

通过实践验证，采用通知服务(notify.send_message)是更可靠的实现方式。核心要点包括：

action: notify.send_message
data:
  message: '{{["动态内容：{}".format(now())] | to_json}}'
target:
  entity_id: notify.xiaomi_device_id

关键实现细节

1. 双重处理机制：

   • 首先使用Python字符串格式化构造内容
   • 然后通过to_json过滤器确保输出格式合规

2. 时间动态显示：

   • now()函数获取当前时间
   • 通过format()方法嵌入到播放文本中

3. 服务选择：

   • 使用通知服务而非直接文本播放
   • 通知服务对动态内容支持更完善

进阶应用场景

基于此方案可扩展更多实用功能：

1. 多变量播报：

message: '{{["温度：{}℃，湿度：{}%".format(states('sensor.temperature'), states('sensor.humidity'))] | to_json}}'

2. 条件播报：

message: >-
  {{ ['系统提醒：{}'.format('门窗未关' if is_state('binary_sensor.door','on') else '一切正常')] | to_json }}

3. 多语言支持：

message: >-
  {{ ['当前时间：{}'.format(now().strftime('%H:%M' if states('input_select.language') == '中文' else '%I:%M %p'))] | to_json }}

注意事项

1. 设备ID需替换为实际的notify实体
2. 复杂表达式建议先在开发者工具中测试
3. 时间格式可通过strftime自定义
4. 数组形式的文本是多数设备的要求格式

结语

通过合理利用Home Assistant的模板引擎和通知服务，可以突破设备原生服务的限制，实现智能音箱的动态内容播放。这种方案不仅适用于时间播报，还可扩展到各类传感器数据和状态提醒，极大丰富了智能家居的语音交互场景。