Alarmo智能家居告警系统通知格式迁移指南

背景介绍

随着Home Assistant核心平台的持续演进，其通知服务机制在2024年4月进行了重大架构调整。Alarmo作为深度集成HA的告警系统，需要同步适配新的通知服务格式。本文将详细解析新旧通知格式的区别，并提供完整的迁移方案。

新旧通知格式对比

传统通知格式（旧版）

service: notify.device_name
data:
  message: "告警触发！原因：{{open_sensors}}"

实体化通知格式（新版）

service: notify.send_message
target:
  entity_id: notify.device_name 
data:
  message: "告警触发！原因：{{open_sensors}}"

关键变更点解析

1. 服务端点变更：从直接调用特定通知服务改为统一使用notify.send_message入口
2. 目标指定方式：新增target层级结构，支持多目标选择
3. 实体化架构：通知服务现在作为独立实体存在，支持更精细的控制

迁移实践步骤

方案一：通过Alarmo UI界面迁移

1. 确保Alarmo版本≥v1.10.6
2. 进入通知配置界面
3. 从下拉菜单中选择已注册的通知实体
4. 系统会自动生成符合新规范的YAML配置

方案二：手动YAML编辑

1. 在YAML编辑模式下直接修改为：

service: notify.send_message
data:
  entity_id: notify.your_device
  message: "告警消息内容"

常见问题解决方案

模板渲染异常

若出现{% if %}等模板语句被直接输出：

• 改用{{open_sensors|format=short}}等内置过滤器
• 确保模板语法符合Jinja2规范

服务调用失败

错误提示"must contain at least one target"时：

• 确认entity_id已正确指定
• 检查通知实体是否已在HA中注册

最佳实践建议

1. 多目标通知：新版格式支持同时指定多个通知目标
2. 消息格式化：利用format=short等过滤器优化输出
3. 回退机制：建议保留旧版配置直至验证新版完全可用

技术展望

虽然当前过渡期存在双格式并存的情况，但实体化通知架构将为未来带来更多可能性：

• 基于区域的定向通知
• 设备状态感知的智能推送
• 更丰富的消息内容类型支持

建议用户及时完成迁移以适应Home Assistant平台的长期发展方向。