Español
Apariencia
Preguntas Frecuentes
Esta página recopila las preguntas que surgen repetidamente en el Rastreador de problemas de GitHub. Revisar aquí antes de abrir un nuevo problema ahorra tiempo, ya que la mayoría de estos no son errores, sino comportamientos esperados con una causa documentada.
Buscar problemas existentes
¿Ninguno de estos? Asegúrese de buscar en el problemas cerrados en GitHub antes de abrir uno nuevo. Si el problema persiste, la página Reporte de Problemas explica cómo recopilar registros de depuración y abrir un informe de error o solicitud de función adecuado.
¿Se pueden enviar notificaciones a un teléfono?
Mostrar respuesta
No directamente. Por defecto, la integración solo crea notificaciones persistentes dentro del panel de Home Assistant; ellos no se reen automáticamente a la aplicación Home Assistant Companion en un dispositivo móvil, ya que eso requiere un objetivo de notificación específico por dispositivo que la integración no posee.
Para recibirlos en un teléfono, se debe crear un automatización personalizada que escuche a eventos de la integración (o las notificaciones persistentes generadas) y los reenvíe al objetivo notify para el dispositivo móvil.
Las fotos de obstáculos / detección por IA no se muestran Soporte de Mapa
Mostrar respuesta
Si las imágenes de obstáculos permanecen vacías incluso con Subida de Imágenes de Obstáculos por IA habilitada en la aplicación, y la cuenta conectada a Home Assistant es una cuenta compartida/familiar en lugar de la cuenta que originalmente agregó y posee el dispositivo, la API en la nube del fabricante puede bloquear silenciosamente el acceso a las imágenes de obstáculos para esa cuenta compartida. Usar la cuenta propietaria real o verificar que el acceso a la cámara se haya otorgado explícitamente a la cuenta compartida dentro de la aplicación, resuelve esto en la mayoría de los casos.
¿Se puede transmitir la cámara del mapa a HomeKit / Apple Home? Soporte de Mapa
Mostrar respuesta
No de manera confiable como vista en vivo. La cámara del mapa transmite como MJPEG genuino, el mismo método que usa la propia plataforma de cámaras de Home Assistant, por lo que la imagen de vista previa estática en Apple Home se muestra correctamente. Solo se genera un nuevo fotograma cuando el mapa realmente cambia, y la transmisión no produce nada mientras la aspiradora está inactiva. La vista en vivo de HomeKit necesita una fuente que se actualice continuamente para mantenerse conectada, y Home Assistant tiene que convertir la transmisión MJPEG a través de una capa adicional antes de que HomeKit pueda mostrarla, ya que HomeKit no acepta MJPEG directamente. Cuando la transmisión del mapa se queda en silencio, esa capa de conversión trata la conexión como perdida, y Home Assistant informa que la cámara no tiene fuente de transmisión o muestra una alimentación en blanco en lugar de una imagen en vivo.
Esto se ha reportado múltiples veces. Los intentos usando la plataforma de cámara ffmpeg, go2rtc, y la integración de Cámara Genérica producen todos el mismo resultado: la vista previa estática funciona, pero una transmisión en vivo que se actualice continuamente dentro de HomeKit no. No se ha confirmado ninguna configuración totalmente funcional para esta integración ni para transmisiones de mapas de aspiradoras similares en otros lugares.
Home Assistant se bloquea, reinicia o usa mucha memoria Soporte de Mapa
Mostrar respuesta
La integración renderiza imágenes de mapas a resolución completa y con zoom, similares a la aplicación oficial, lo que puede usar una cantidad significativa de memoria. En sistemas con RAM limitada, como un Raspberry Pi, una pequeña VM o un contenedor limitado a alrededor de 2-3 GB, esto puede agotar la memoria disponible y causar que Home Assistant se congele, se reinicie o no logre iniciarse completamente, típicamente justo después de agregar un dispositivo con soporte de mapa o al abrir la página del dispositivo o la cámara de mapa.
Solución
Habilita Imagen de Mapa de Baja Resolución desde las opciones de configuración del dispositivo. Esto resuelve la gran mayoría de estos casos.
Si aún se bloquea después de habilitar esa opción, los datos del mapa en sí pueden haberse corrompido o vuelto inusualmente grandes con el tiempo, lo que también puede aumentar el uso de memoria durante el renderizado. Restaurar un mapa antiguo y saludable desde Copia de seguridad y recuperación puede resolver esto. Si ninguno de los dos ayuda, recopilar registros de depuración y abre un informe de errores, ya que eso apunta a una causa subyacente diferente.
La integración no se carga después de una actualización de Home Assistant, mencionando py_mini_racer Soporte de Mapa
Mostrar respuesta
La integración depende de py-mini-racer, un motor de JavaScript utilizado para optimizar y renderizar mapas para que coincidan con la aplicación oficial. Esta dependencia la instala Home Assistant, no la integración, y ocasionalmente falla al instalarse o falla al cargar su binario nativo después de una actualización de Home Assistant Core, particularmente en sistemas basados en musl (como HAOS en algunas plataformas) o justo después de una actualización.
Problema de entorno
Este es un problema de instalación de entorno/dependencias, no algo que el código de la integración pueda detectar o evitar. Aparece repetidamente en versiones no relacionadas de Home Assistant y en distintos tipos de instalación.
Reiniciar Home Assistant (para permitir que intente instalar las dependencias nuevamente) lo resuelve en algunos casos. Si persiste, revise el registro de Home Assistant alrededor del inicio para el error real de instalación de pip/dependencia; ese error es lo que necesita resolverse (incluyendo como un problema de Home Assistant Core, si parece un fallo de instalación a nivel de plataforma).
¿Se puede usar un dispositivo que ejecute Valetudo con esta integración?
Mostrar respuesta
Sí y no. Técnicamente, no hay ninguna restricción que impida que la integración funcione junto con Valetudo. Valetudo no desactiva la API local miIO, por lo que el dispositivo se puede controlar a través de Conexión Local siempre que se pueda obtener el token. Sin embargo, los datos del mapa no se pueden recuperar mediante la API local, y Valetudo no expone los datos de mapas sin procesar a través de un servicio. Por lo tanto, la integración solo puede funcionar sin soporte de mapas.
Sin soporte de mapas, la funcionalidad proporcionada por esta integración se vuelve en gran medida redundante, ya que todas las características restantes ya se pueden utilizar a través del sistema nativo Integración Valetudo Home Assistant MQTT.