Tiếng Việt
Giao diện
Tiếng Việt
Giao diện
Trang này tập hợp các câu hỏi thường gặp trên Trình theo dõi vấn đề GitHub. Kiểm tra tại đây trước khi mở vấn đề mới sẽ tiết kiệm thời gian, vì hầu hết các vấn đề này không phải là lỗi mà là các hành vi được mong đợi với nguyên nhân đã được ghi nhận.
Tìm kiếm các vấn đề hiện có
Không có vấn đề nào trong số này? Hãy đảm bảo tìm kiếm các vấn đề đã đóng trên GitHub trước khi mở vấn đề mới. Nếu vấn đề vẫn tiếp diễn, trang Báo cáo sự cố giải thích cách thu thập nhật ký gỡ lỗi và mở báo cáo lỗi hoặc yêu cầu tính năng đúng cách.
Không trực tiếp. Theo mặc định, tích hợp chỉ tạo Thông báo liên tục bên trong bảng điều khiển Home Assistant; chúng không được tự động gửi tới Ứng dụng Home Assistant Companion trên thiết bị di động, vì điều đó đòi hỏi một mục tiêu thông báo cụ thể theo thiết bị mà tích hợp không có.
Để nhận chúng trên điện thoại, một tự động hóa tùy chỉnh phải được tạo ra để lắng nghe sự kiện của tích hợp (hoặc các thông báo lâu dài đã tạo) và chuyển tiếp chúng đến mục tiêu notify cho thiết bị di động.
Nếu ảnh chướng ngại vẫn trống ngay cả khi AI Tải Lên Ảnh Chướng Ngại được bật trong ứng dụng, và tài khoản kết nối với Home Assistant là tài khoản chia sẻ/gia đình thay vì tài khoản đã thêm và sở hữu thiết bị ban đầu, API đám mây của nhà sản xuất có thể âm thầm chặn quyền truy cập ảnh chướng ngại cho tài khoản chia sẻ đó. Sử dụng tài khoản sở hữu thực sự, hoặc kiểm tra rằng quyền truy cập camera đã được cấp rõ ràng cho tài khoản chia sẻ trong ứng dụng, sẽ giải quyết vấn đề này trong hầu hết các trường hợp.
Không đáng tin cậy như một chế độ xem trực tiếp. Camera bản đồ phát trực tiếp dưới dạng MJPEG thật, cùng phương pháp mà nền tảng camera của Home Assistant sử dụng, nên hình xem trước tĩnh trong Apple Home hiển thị đúng. Một khung hình mới chỉ được tạo ra khi bản đồ thực sự thay đổi, và luồng hình ảnh không tạo ra gì khi robot hút bụi đang ngồi yên. Chế độ xem trực tiếp của HomeKit cần một nguồn liên tục làm mới để duy trì kết nối, và Home Assistant phải chuyển đổi luồng MJPEG qua một lớp bổ sung trước khi HomeKit có thể hiển thị, vì HomeKit không chấp nhận MJPEG trực tiếp. Khi luồng bản đồ im lặng, lớp chuyển đổi đó coi kết nối là mất, và Home Assistant báo rằng camera không có nguồn luồng hoặc hiển thị nguồn trống thay vì hình ảnh trực tiếp.
Điều này đã được báo cáo nhiều lần. Các thử nghiệm sử dụng nền tảng camera ffmpeg, go2rtc, và tích hợp Camera Chung đều cho kết quả giống nhau: bản xem trước tĩnh hoạt động tốt, nhưng luồng trực tiếp cập nhật liên tục bên trong HomeKit thì không. Chưa có cấu hình nào hoạt động hoàn chỉnh được xác nhận cho tích hợp này hoặc cho các luồng bản đồ máy hút bụi tương tự ở nơi khác.
Tích hợp này hiển thị hình ảnh bản đồ có thể phóng to, độ phân giải đầy đủ giống như ứng dụng chính thức, điều này có thể sử dụng một lượng đáng kể bộ nhớ. Trên các hệ thống có RAM hạn chế, như Raspberry Pi, VM nhỏ, hoặc container bị giới hạn khoảng 2-3GB, điều này có thể làm cạn kiệt bộ nhớ khả dụng và gây ra hiện tượng Home Assistant bị treo, khởi động lại hoặc không thể khởi động hoàn toàn, thường là ngay sau khi thêm thiết bị có hỗ trợ bản đồ hoặc khi mở trang thiết bị hoặc camera bản đồ của thiết bị đó.
Khắc phục
Bật Hình Ảnh Bản Đồ Độ Phân Giải Thấp từ các tùy chọn cấu hình của thiết bị. Điều này giải quyết phần lớn các trường hợp này.
Nếu nó vẫn bị treo sau khi bật tùy chọn đó, dữ liệu bản đồ có thể đã bị hỏng hoặc trở nên bất thường lớn theo thời gian, điều này cũng có thể làm tăng mức sử dụng bộ nhớ trong quá trình hiển thị. Khôi phục một bản đồ cũ, lành mạnh từ Sao lưu và Phục hồi có thể giải quyết điều này. Nếu cả hai cách đều không giúp được, thu thập nhật ký gỡ lỗi và mở báo cáo lỗi, vì điều đó chỉ ra một nguyên nhân cơ bản khác.
Tích hợp phụ thuộc vào py-mini-racer, một engine JavaScript được sử dụng để tối ưu hóa và hiển thị bản đồ sao cho khớp với ứng dụng chính thức. Phụ thuộc này được cài đặt bởi chính Home Assistant, không phải bởi tích hợp, và đôi khi thất bại khi cài đặt hoặc không tải được binary gốc sau khi cập nhật Home Assistant Core, đặc biệt trên các hệ thống dựa trên musl (như HAOS trên một số nền tảng) hoặc ngay sau khi nâng cấp.
Vấn đề Môi trường
Đây là một vấn đề về cài đặt môi trường/phụ thuộc, không phải là thứ mà mã tích hợp có thể phát hiện hoặc giải quyết. Nó xuất hiện lặp đi lặp lại trên các phiên bản Home Assistant và các loại cài đặt khác nhau.
Khởi động lại Home Assistant (để cho phép nó thử cài đặt lại các phụ thuộc) có thể giải quyết vấn đề trong một số trường hợp. Nếu vấn đề vẫn tiếp diễn, hãy kiểm tra nhật ký Home Assistant xung quanh thời điểm khởi động để tìm lỗi cài đặt pip/phụ thuộc thực sự; chính lỗi đó cần được giải quyết (bao gồm cả việc xem như là một vấn đề của Home Assistant Core, nếu nó giống như thất bại cài đặt ở cấp nền tảng).
Có và không. Về mặt kỹ thuật, không có hạn chế nào ngăn việc tích hợp hoạt động cùng với Valetudo. Valetudo không vô hiệu hóa API miIO cục bộ, vì vậy thiết bị có thể được điều khiển qua Kết nối cục bộ miễn là token có thể được lấy. Tuy nhiên, dữ liệu bản đồ không thể được truy xuất qua API cục bộ, và Valetudo không cung cấp dữ liệu bản đồ thô thông qua dịch vụ. Do đó, tích hợp này chỉ có thể hoạt động mà không có hỗ trợ bản đồ.
Khi không có hỗ trợ bản đồ, chức năng mà tích hợp này cung cấp trở nên phần lớn không cần thiết, vì tất cả các tính năng còn lại đã có thể được sử dụng qua các tính năng gốc Tích hợp Valetudo Home Assistant MQTT.