Skip to main content

设备跟踪器实体

设备跟踪器是一个只读实体,提供存在信息。设备跟踪器实体有两种类型,ScannerEntity和TrackerEntity。

ScannerEntity

ScannerEntity报告本地网络上设备的连接状态。如果设备已连接,ScannerEntity的状态将为home,如果设备未连接,状态将为not_home

homeassistant.components.device_tracker.config_entry.ScannerEntity 派生一个平台实体。

属性

tip

属性应始终仅从内存中返回信息,而不执行I/O(如网络请求)。实现update()async_update()来获取数据。

名称类型默认值描述
battery_levelint | NoneNone设备的电池电量。
hostnamestr | NoneNone设备的主机名。
ip_addressstr | NoneNone设备的IP地址。
is_connectedbool必需设备的连接状态。
mac_addressstr | NoneNone设备的MAC地址。
source_typeSourceTypeSourceType.ROUTER设备的源类型。

DHCP 发现

如果设备跟踪器的source_typerouter并且ip_addressmac_addresshostname属性已设置,数据将 加速DHCP 发现,因为系统将不必等待 DHCP发现数据包来查找现有设备。

TrackerEntity

TrackerEntity跟踪设备的位置,并将其报告为位置名称、区域名称或homenot_home状态。TrackerEntity通常接收GPS坐标以确定其状态。要报告状态,location_namelatitudelongitude应该被设置。

homeassistant.components.device_tracker.config_entry.TrackerEntity 派生一个平台实体。

属性

tip

属性应始终仅从内存中返回信息,而不执行I/O(如网络请求)。实现update()async_update()来获取数据。

名称类型默认值描述
battery_levelint | NoneNone设备的电池电量。
latitudefloat | NoneNone设备的纬度坐标。
location_accuracyfloat0设备的位置信息准确度(米)。
location_namestr | NoneNone设备的位置名称。
longitudefloat | NoneNone设备的经度坐标。
source_typeSourceTypeSourceType.GPS设备的源类型。