设备跟踪器实体

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

扫描实体

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_connectedboolRequired设备的连接状态。
mac_addressstr | NoneNone设备的 MAC 地址。
source_typeSourceTypeSourceType.ROUTER设备的源类型。

DHCP 发现

如果设备跟踪器 source_typerouter 并且已设置 ip_addressmac_addresshostname 属性,则数据将 加快 DHCP discovery 的速度,因为系统无需等待 DHCP 发现数据包以查找现有设备。

跟踪实体

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设备的定位精度(m)。
location_namestr | NoneNone设备的位置名称。
longitudefloat | NoneNone设备的经度坐标。
source_typeSourceTypeSourceType.GPS设备的源类型。