FAQ

Halaman ini mengumpulkan pertanyaan yang sering muncul di Pelacak isu GitHub. Memeriksa di sini sebelum membuka isu baru menghemat waktu, karena sebagian besar ini bukan bug tetapi perilaku yang diharapkan dengan penyebab yang terdokumentasi.

Cari Isu yang Ada

Tidak ada di antara ini? Pastikan untuk mencari di isu yang ditutup di GitHub sebelum membuka yang baru. Jika masalah tetap ada, halaman Pelaporan Masalah menjelaskan cara mengumpulkan log debug dan membuka laporan bug atau permintaan fitur yang benar.

Apakah Notifikasi Bisa Dikirim ke Ponsel?

Tampilkan Jawaban

Tidak secara langsung. Secara default, integrasi hanya membuat notifikasi persisten di dalam dashboard Home Assistant; mereka tidak otomatis diteruskan ke Aplikasi Pendamping Home Assistant di perangkat seluler, karena hal itu memerlukan target notifikasi per perangkat tertentu yang tidak dimiliki integrasi.

Untuk menerima mereka di ponsel, sebuah otomatisasi kustom harus dibuat yang mendengarkan acara integrasi (atau notifikasi persisten yang dihasilkan) dan meneruskannya ke target notify untuk perangkat seluler.

Lebih lanjut tentang mengonfigurasi notifikasi mana yang dihasilkan

Foto Hambatan / Deteksi AI Tidak Tampil Dukungan Peta

Tampilkan Jawaban

Jika gambar hambatan tetap kosong meskipun Unggah Gambar Hambatan AI diaktifkan dalam aplikasi, dan akun yang terhubung ke Home Assistant adalah akun berbagi/keluarga daripada akun yang awalnya menambahkan dan memiliki perangkat, API cloud produsen dapat secara diam-diam memblokir akses gambar hambatan untuk akun berbagi tersebut. Menggunakan akun pemilik yang sebenarnya, atau memeriksa bahwa akses kamera telah diberikan secara eksplisit kepada akun berbagi dalam aplikasi, menyelesaikan masalah ini dalam sebagian besar kasus.

Dapatkah Kamera Peta Disiarkan ke HomeKit / Apple Home? Dukungan Peta

Tampilkan Jawaban

Tidak dapat diandalkan sebagai tampilan langsung. Kamera peta melakukan streaming sebagai MJPEG asli, metode yang sama yang digunakan oleh platform kamera Home Assistant sendiri, sehingga gambar pratinjau statis di Apple Home ditampilkan dengan benar. Bingkai baru hanya dihasilkan ketika peta benar-benar berubah, dan streaming tidak menghasilkan apa-apa saat vacuum diam. Tampilan langsung HomeKit membutuhkan sumber yang terus diperbarui agar tetap terhubung, dan Home Assistant harus mengonversi aliran MJPEG melalui lapisan tambahan sebelum HomeKit dapat menampilkannya sama sekali, karena HomeKit tidak menerima MJPEG secara langsung. Ketika aliran peta diam, lapisan konversi itu menganggap koneksi hilang, dan Home Assistant melaporkan bahwa kamera tidak memiliki sumber aliran atau menampilkan feed kosong alih-alih gambar langsung.

Hal ini telah dilaporkan berkali-kali. Upaya menggunakan platform kamera ffmpeg, go2rtc, dan integrasi Kamera Generik semuanya menghasilkan hasil yang sama: preview statis berfungsi, tetapi feed langsung yang terus diperbarui di dalam HomeKit tidak berfungsi. Tidak ada pengaturan yang benar-benar bekerja yang telah dikonfirmasi untuk integrasi ini atau untuk aliran peta vakum serupa di tempat lain.

Home Assistant Crash, Restart, atau Menggunakan Banyak Memori Dukungan Peta

Tampilkan Jawaban

Integrasi ini menampilkan gambar peta dengan resolusi penuh yang dapat diperbesar mirip dengan aplikasi resmi, yang dapat menggunakan jumlah memori yang signifikan. Pada sistem dengan RAM terbatas, seperti Raspberry Pi, VM kecil, atau container yang dibatasi sekitar 2-3GB, hal ini dapat menghabiskan memori yang tersedia dan menyebabkan Home Assistant membeku, restart, atau gagal untuk memulai sepenuhnya, biasanya tepat setelah menambahkan perangkat dengan dukungan peta atau saat membuka halaman perangkat atau kamera peta.

Perbaikan

Aktifkan Gambar Peta Resolusi Rendah dari opsi konfigurasi perangkat. Ini menyelesaikan sebagian besar kasus tersebut.

Jika masih mengalami crash setelah mengaktifkan opsi itu, data peta sendiri mungkin sudah rusak atau menjadi sangat besar seiring waktu, yang juga dapat meningkatkan penggunaan memori selama rendering. Memulihkan peta lama yang sehat dari Cadangan dan Pemulihan bisa menyelesaikan masalah ini. Jika keduanya tidak membantu, kumpulkan log debug dan buka laporan bug, karena itu menunjukkan penyebab mendasar yang berbeda.

Integrasi Gagal Dimuat Setelah Pembaruan Home Assistant, Menyebutkan py_mini_racer Dukungan Peta

Tampilkan Jawaban

Integrasi bergantung pada py-mini-racer, sebuah mesin JavaScript yang digunakan untuk mengoptimalkan dan merender peta agar sesuai dengan aplikasi resmi. Ketergantungan ini diinstal oleh Home Assistant sendiri, bukan oleh integrasi, dan kadang-kadang gagal diinstal atau gagal memuat binary asli setelah pembaruan Home Assistant Core, terutama pada sistem berbasis musl (seperti HAOS pada beberapa platform) atau tepat setelah pembaruan.

Masalah Lingkungan

Ini adalah masalah instalasi lingkungan/dependensi, bukan sesuatu yang bisa dideteksi atau diatasi oleh kode integrasi. Masalah ini muncul berulang kali di berbagai versi Home Assistant dan jenis instalasi yang tidak terkait.

Memulai ulang Home Assistant (untuk membiarkannya mencoba kembali menginstal dependensi) dapat menyelesaikannya dalam beberapa kasus. Jika masalah tetap ada, periksa log Home Assistant sekitar saat startup untuk melihat kesalahan instalasi pip/dependensi yang sebenarnya; kesalahan itulah yang perlu diselesaikan (termasuk sebagai masalah Home Assistant Core, jika terlihat seperti gagal instalasi di tingkat platform).

Apakah Perangkat yang Menjalankan Valetudo Bisa Digunakan dengan Integrasi Ini?

Tampilkan Jawaban

Ya dan tidak. Secara teknis, tidak ada batasan yang mencegah integrasi beroperasi bersamaan dengan Valetudo. Valetudo tidak menonaktifkan API miIO lokal, sehingga perangkat dapat dikontrol melalui Koneksi Lokal selama token dapat diperoleh. Namun, data peta tidak dapat diambil melalui API lokal, dan Valetudo tidak menampilkan data peta mentah melalui layanan. Oleh karena itu, integrasi ini hanya dapat berfungsi tanpa dukungan peta.

Tanpa dukungan peta, fungsionalitas yang diberikan oleh integrasi ini sebagian besar menjadi redundan, karena semua fitur yang tersisa sudah dapat digunakan melalui native Integrasi Valetudo Home Assistant MQTT.