2025.3.4
首页 ▸ Integrations ▸

MQTT 房间存在

mqtt_room 传感器 integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more] 允许您使用 MQTT 客户端检测设备的室内位置。

配置

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

# 示例 configuration.yaml 项
sensor:
  - platform: mqtt_room
    device_id: 123testid
    state_topic: "espresense/devices/123testid"

Configuration Variables

Looking for your configuration file?
away_timeout integer (Optional, default: 0)

如果没有更新，状态将在多少秒后设置为 not_home。0 禁用检查。

device_id string Required

此传感器要跟踪的设备 ID。

name string (Optional, default: 房间传感器)

传感器的名称。

state_topic string Required

包含房间所有子主题的主题。

timeout integer (Optional, default: 5)

被认为是过时的房间存在状态的时间（以秒为单位）。例如：设备 device1 在扫描仪 scanner1 上报告，距离为 1。之后，scanner1 不再发送进一步的更新。5 秒后，scanner2 报告 device1，距离为 2。旧的位置信息被丢弃，取而代之的是新的 scanner2 信息，因为超时已经过去。

unique_id string (Optional)

一个唯一标识此房间传感器的 ID。如果两个传感器具有相同的唯一 ID，Home Assistant 将引发异常。

用法

应发布到房间主题的示例 JSON：

{
  "id": "123testid",
  "name": "测试设备",
  "distance": 5.678
}

设置客户端

此集成与任何发送数据的给定格式的软件兼容。每个客户端应在配置主题的自己的子主题中发布发现的设备。 除了开发自己的应用程序外，您还可以使用以下现有客户端：

  • ESPresense：基于 C++/Platformio 的 ESP32-MQTT-room 的分支，具有指纹识别、瓷砖支持、卡尔曼滤波器
  • ESP-32-BLE-Scanner for Home Assistant：基于 ESP32 的 Home Assistant BLE 存在检测，带有 Web GUI
  • room-assistant：查找 Bluetooth LE 信标，基于 Node.js
  • Happy Bubbles Presence Server：为 Happy Bubbles BLE 扫描设备提供存在检测服务器，基于 Go
  • ESP32-MQTT-room：在 ESP32 上运行，查找 Bluetooth LE 设备，基于 C++/Arduino
  • OpenMQTTGateway：使用 ESP32 蓝牙低能耗扫描 BLE 广播设备，如智能手表/手环等，以获取传感器值

相关主题