Home Assistant 集成指南

通过 MQTT 将 Home Assistant 设备接入 Tracer

1步骤 1: 配置 Home Assistant

在 Home Assistant 的配置文件 configuration.yaml 中添加以下内容：

mqtt_statestream:
  base_topic: homeassistant
  publish_attributes: true
  include:
    domains:
      - device_tracker

重要提示

base_topic 必须修改为您在 Tracer 中配置的专属发现前缀（默认为 homeassistant），否则可能导致设备冲突或无法发现。

修改配置后，请务必重启 Home Assistant 以生效。

2步骤 2: 发现与导入

完成上述配置后，返回 Tracer 控制台：

打开“设备管理” -> “添加设备” -> “Home Assistant”

点击“刷新”按钮扫描网络

选中扫描到的设备并点击“导入”

3步骤 3: 验证

导入成功后，设备位置将实时同步。您可以尝试移动设备或手动触发位置更新来验证。

常见问题

扫描不到设备？

请检查 HA 日志是否有 MQTT 连接错误，确认 `mqtt_statestream` 配置正确，并确保 `base_topic` 与 Tracer 设置一致。

位置不更新？

确保 `publish_attributes: true` 已启用，且设备实体（device_tracker）有经纬度属性变化。