常见问题
本页面收集了在 GitHub 问题跟踪器 上反复出现的问题。在提出新问题之前先在这里查看，可以节省时间，因为大多数问题不是漏洞，而是有文档记录原因的预期行为。
搜索现有问题
都没有？在提出新问题之前，请确保搜索 GitHub 上已关闭的问题。如果问题仍然存在，问题报告 页面说明了如何收集调试日志并提交正确的错误报告或功能请求。
通知可以推送到手机吗？
显示答案
不能直接推送。默认情况下，集成仅在 Home Assistant 仪表板内创建 持久通知；它们不会 自动 转发到移动设备上的 Home Assistant Companion 应用，因为这需要集成没有的特定每个设备的通知目标。
要在手机上接收它们， 自定义自动化 必须创建一个监听该集成的 事件 （或生成的持久通知）并将它们转发到 notify 移动设备的目标。
障碍物 / AI 检测照片未显示 地图支持
显示答案
如果即使在应用中启用了 AI 障碍物图像上传，障碍物图像仍然为空，并且连接到 Home Assistant 的账户是 共享/家庭账户，而不是最初添加并拥有该设备的账户，制造商的云 API 可能会默默阻止该共享账户访问障碍物图像。使用实际拥有的账户，或者检查摄像头访问权限是否在应用中明确授予共享账户，在大多数情况下可以解决此问题。
地图摄像头可以直播到 HomeKit / Apple Home 吗？ 地图支持
显示答案
作为实时视图，它不可靠。地图摄像头以真正的 MJPEG 流方式传输，这与 Home Assistant 自带的摄像头平台使用的方法相同，因此 Apple Home 中的静态预览图像显示正确。只有当地图实际发生变化时，才会生成新帧，而当吸尘器闲置时，流不会产生任何内容。HomeKit 的实时视图需要一个持续刷新的源才能保持连接，而 Home Assistant 必须通过额外的一层将 MJPEG 流转换后，HomeKit 才能显示，因为 HomeKit 不直接接受 MJPEG。当地图流静止时，该转换层会将连接视为丢失，Home Assistant 则报告摄像头没有流源，或显示空白画面而不是实时图像。
这已经被多次报告过。使用 ffmpeg 摄像头平台、go2rtc 以及通用摄像头集成的尝试都产生相同的结果：静态预览可以正常工作，但在 HomeKit 中的持续更新实时视频无法显示。尚未确认此集成或其他类似的吸尘器地图流在任何地方有完全可用的设置。
Home Assistant 崩溃、重启或占用大量内存 地图支持
显示答案
该集成渲染可缩放的全分辨率地图图像，类似于官方应用，这可能会使用大量内存。在 RAM 有限的系统上，例如 Raspberry Pi、较小的虚拟机或内存约限制在 2-3GB 的容器，这可能会耗尽可用内存并导致 Home Assistant 冻结、重启或完全无法启动，通常发生在添加带地图支持的设备或打开其设备页面或地图摄像头时。
解决方法
从设备的配置选项中启用 低分辨率地图图像。这解决了绝大多数此类问题。
如果启用该选项后仍然崩溃，地图数据本身可能随时间而损坏或异常增大，这也会在渲染时增加内存使用。恢复来自 备份与恢复 的较旧且健康的地图可以解决此问题。如果都无效，请 收集调试日志 并提交错误报告，因为这可能指向不同的根本原因。
Home Assistant 更新后集成加载失败，提示 py_mini_racer 地图支持
显示答案
该集成依赖于 py-mini-racer，这是一种用于优化和渲染地图使其与官方应用匹配的 JavaScript 引擎。此依赖由 Home Assistant 本身安装，而非集成安装，且在 Home Assistant Core 更新后偶尔会安装失败或无法加载其本地二进制文件，尤其是在基于 musl 的系统（如某些平台上的 HAOS）或刚升级后。
环境问题
这是一个环境/依赖安装问题，而不是集成的代码可以检测或解决的。它在无关的 Home Assistant 版本和安装类型中反复出现。
重启 Home Assistant（以便让它重新尝试安装依赖）在某些情况下可以解决问题。如果问题仍然存在，请检查 Home Assistant 启动时的日志，查找实际的 pip/依赖安装错误；需要解决的就是该错误（如果看起来像平台级安装失败，也可能涉及 Home Assistant Core 问题）。
支持运行 Valetudo 的设备与此集成兼容吗？
显示答案
是也不是。从技术上讲，没有限制阻止该集成与 Valetudo 一起运行。Valetudo 并不会禁用本地 miIO API，因此只要可以获取 token，就可以通过 本地连接 控制设备。然而，本地 API 无法获取地图数据，Valetudo 也没有通过任何服务公开原始地图数据。因此，该集成只能在没有地图支持的情况下运行。
在没有地图支持的情况下，该集成提供的功能在很大程度上变得多余，因为所有剩余的功能已经可以通过原生方式使用。 Valetudo Home Assistant MQTT 集成.