2025.3.4
首页 ▸ Integrations ▸

Bluetooth Low Energy Tracker

此跟踪器在启动时和定期间隔中发现新设备，并根据 interval_seconds 值定期跟踪蓝牙低能量设备。设备之间不需要配对。

发现的设备的 mac 地址会存储在 known_devices.yaml 中，前缀为 ‘BLE_’。

设置

此 integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more] 需要启用和正常工作的 Bluetooth 集成。

配置

要在您的安装中使用蓝牙跟踪器，请将以下内容添加到您的 configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] 文件中。 在更改了configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] 文件后，重启 Home Assistant 以应用更改。 该集成现在显示在集成页面的 设置 > 设备与服务 下。其实体在集成卡片上以及实体标签上列出。

# 配置示例 configuration.yaml 条目
device_tracker:
  - platform: bluetooth_le_tracker

Configuration Variables

Looking for your configuration file?
track_new_devices boolean (Optional, default: false)

如果新发现的设备默认被跟踪。

track_battery boolean (Optional, default: false)

集成是否应尝试读取被跟踪设备的电池状态。

track_battery_interval time (Optional, default: 1 day)

请求设备电池状态的最小间隔。电池状态最多每个间隔检查一次。如果 track_battery 为 false，则忽略此项。

interval_seconds integer (Optional, default: 12)

每次扫描新设备之间的秒数。

由于一些蓝牙低能量设备定期更改其 MAC 地址，因此只有在设备被看到 5 次时才会发现新设备。 一些 BTLE 设备（例如，健身追踪器）仅对其配对的设备可见。在这种情况下，BTLE 跟踪器将无法看到该设备。

启用电池跟踪可能会稍微缩短电池的使用时间，但由于这最多每天只执行一次，因此不应引起注意。并非所有设备都提供电池状态信息；如果信息不可用，集成将在启动时仅尝试一次。

有关其他配置变量，请查看 设备跟踪器页面。

相关主题