Releases: lambilly/ha_traccar
Releases · lambilly/ha_traccar
Release list
v1.0.2
v1.0.1
v1.0.1 (2026-04-11)
🚀 新特性
- 智能轮询后备机制:当 Traccar 服务器不支持 WebSocket 时,自动切换为 REST API 定时拉取(默认 30 秒),确保数据持续更新,无需手动重载集成。
- 实体动态加载:优化实体创建逻辑,即使首次加载时服务器响应较慢,实体也会在数据就绪后自动出现,不再需要用户手动重载。
🐛 修复
- 修复登录认证问题:修正了原版集成中用户名/密码登录失败的错误,现可正常连接 Traccar 5.x 及以上版本。
- 修复实时更新失效:解决了 WebSocket 断开或不可用时,设备位置及传感器状态停止更新的问题(通过轮询后备彻底解决)。
- 修复设备跟踪器坐标转换:增强了 GCJ-02 到 WGS84 坐标转换的防御性检查,避免因空值导致的异常。
- 信号名称统一:修复实体无法收到实时更新信号的问题,确保数据变化后 UI 立即刷新。
⚙️ 改进
- 日志体验优化:WebSocket 连接失败仅警告一次,避免刷屏;添加轮询状态调试日志,便于排查问题。
- 代码健壮性增强:添加更多数据有效性检查,防止因 Traccar 返回异常数据导致集成崩溃。
📝 文档
- 更新
README.md,明确登录方式为用户名/密码,删除误导性的 Token 说明。
⚠️ 已知兼容性说明
- 某些定制版 Traccar 镜像(如
bg6rsh/traccar-amap:latest)可能未编译 WebSocket 支持,集成会自动降级为轮询模式,不影响正常使用(延迟最多 30 秒)。如需实时推送,请使用官方traccar/traccar或经验证的bg6rsh/traccar-amap:5.8镜像。
Full Changelog: v1.0.0...v1.0.1