Pemecahan masalah

Cari gejala yang Anda alami di bawah ini. Setiap gejala menjelaskan kemungkinan penyebab dan cara memperbaikinya, dengan bahasa sehari-hari.

Mulai dari sini: penyebabnya hampir tidak pernah AI

Angka yang terlihat salah memang membuat khawatir, tetapi dari pengalaman kami penyebabnya hampir selalu hal sederhana yang mudah dibereskan:

• Kamera yang terputus hampir selalu karena masalah alamat jaringan. Alamat kamera berpindah diam-diam, atau perangkat lain mengambil alamatnya. Bukan kameranya, bukan AI-nya.
• Angka yang kurang akurat hampir selalu karena penempatan atau kualitas gambar. Pintu kedua yang belum terpantau, garis hitung di posisi yang keliru, atau gambar yang terlalu kecil dan buram. Sekali lagi, bukan AI-nya.

Jadi kalau ada yang terasa janggal, periksa jaringan lebih dulu, lalu posisi kamera. Setiap penyebab di bawah ini disertai solusinya.

Masalah kamera

Dashboard bilang kamera offline, padahal aplikasi ponsel kamera bilang online

Ini masalah yang paling sering kami bantu selesaikan, dan yang menyesatkan justru aplikasi ponselnya.

Penyebab. Aplikasi kamera di ponsel Anda (Bardi, Meari, Tapo, atau merek lain) tidak berhubungan dengan kamera lewat jaringan toko Anda, melainkan lewat cloud milik pabrikan (server milik pembuat kamera di internet). Jadi status "online" di aplikasi itu hanya membuktikan kameranya punya internet. Kebutuhan JoynVision berbeda: menjangkau kamera langsung di jaringan lokal toko, dan koneksi itulah yang sedang terputus.

Penyebab paling umum adalah bentrok alamat IP (alamat IP adalah alamat kamera di jaringan toko Anda). Kamera Anda memakai alamat tetap, tetapi alamat itu berada di dalam rentang yang dibagikan otomatis oleh router (alat pembagi internet di toko). Suatu hari router memberikan alamat yang sama ke sebuah ponsel. Akibatnya ada perangkat lain yang menjawab di alamat itu, hanya saja itu bukan kamera Anda.

Kabar baiknya: ini umum terjadi, mudah diperbaiki, dan setelah dibereskan tidak akan terulang.

Perbaikan, lakukan keduanya jika memungkinkan:

1. Reservasikan alamat kamera berdasarkan alamat MAC-nya di router. (Alamat MAC adalah nomor identitas permanen kamera, biasanya tercetak di stiker atau terlihat di aplikasinya.) Cari menu "DHCP reservation", "static lease", atau "address binding" di halaman admin router Anda. Ini perbaikan yang paling tepat.
2. Atau pindahkan alamat tetap kamera ke luar rentang yang dibagikan router. Jika router membagikan .100 sampai .200, tempatkan kamera di .50.

Lakukan hal yang sama untuk PC yang menjalankan JoynVision.

Catatan soal pengetesan. Kalau ada yang bilang "saya sudah ping kameranya dan ada jawaban" (ping adalah cara cepat mengecek ada tidaknya perangkat di sebuah alamat), itu hanya membuktikan ada sesuatu di alamat tersebut, belum tentu kamera Anda. Kami pernah menemukan sebuah ponsel menjawab di alamat kamera selama berjam-jam, sementara kameranya sendiri sudah berpindah alamat.

Setelah diperbaiki, Anda tidak perlu melakukan apa pun lagi. JoynVision terus mencoba menghubungi kamera di latar belakang dan tersambung kembali dengan sendirinya.

Kamera offline setelah listrik padam, router di-restart, atau kabel dicabut

Penyebab. Kamera menyala kembali dengan alamat yang berbeda. Ini salah satu penyebab paling umum, dan perbaikannya cepat.

Perbaikan. Biasanya JoynVision menemukan kembali kameranya sendiri. Jika belum, buka Diagnostik, lalu kamera tersebut, lalu Rediscover. Fitur ini menyisir jaringan Anda dan memastikan betul bahwa yang ditemukan memang kamera Anda: mencocokkan identitas perangkat kerasnya, atau memastikan perangkat itu menyajikan video yang sama dengan kata sandi yang sama. Fitur ini tidak akan berpindah ke perangkat lain hanya karena perangkat itu ikut menjawab.

Satu hal yang perlu diketahui: ada kamera yang menjawab di dua alamat sekaligus (kamera fisiknya sama, alamatnya dua). Kalau itu terjadi, Rediscover menemukan dua kandidat yang sama-sama cocok. Daripada menebak, ia menampilkan keduanya dan Anda tinggal memilih. Aman, hanya perlu satu klik tambahan dari Anda.

Setelah itu, pasang reservasi alamat seperti di atas supaya tidak terulang.

Pemindaian jaringan tidak menemukan kamera sama sekali

Periksa dari yang paling mungkin:

1. ONVIF masih mati di kamera. (ONVIF adalah standar yang membuat kamera bisa berkomunikasi dengan sistem seperti JoynVision.) Ini penyebab yang paling sering. Di beberapa kamera, menyalakan ONVIF lewat aplikasi kameranya sendiri adalah syarat agar kamera terlihat sama sekali. Nyalakan, lalu pindai lagi.
2. Kamera berada di jaringan yang berbeda dari PC. Wi-Fi tamu, router kedua, atau jaringan dengan "client isolation" aktif semuanya membuat kamera tersembunyi.
3. Kamera belum selesai menyala. Beri waktu sekitar satu menit setelah dinyalakan.
4. Pemindaiannya kebetulan melewatkan kamera. Di beberapa jaringan, kamera yang sama bisa muncul di satu pemindaian dan luput di pemindaian berikutnya; itu wajar. Tekan "Pindai lagi", dan kalau masih belum ketemu gunakan "Masukkan alamat sendiri". Memasukkan alamat secara manual selalu berhasil dan selalu tersedia.

Untuk daftar kamera yang cocok dengan JoynVision dan cara menyiapkannya, lihat panduan kamera.

Kamera ditemukan tetapi tidak mau tersambung, muncul "401" atau "unauthorised"

Penyebab. Kata sandinya salah, tetapi kemungkinan besar bukan kata sandi yang Anda kira.

ONVIF biasanya punya nama pengguna dan kata sandi tersendiri, yang dibuat saat Anda menyalakan ONVIF, dan sering berbeda dari kata sandi untuk masuk ke aplikasi kamera. Periksa pengaturan ONVIF di kamera untuk melihat nama pengguna dan kata sandi yang sebenarnya diminta.

Perlu diketahui juga: beberapa kamera memakai nama pengguna tetap (sering kali "admin") dan Anda hanya menentukan kode sandinya.

Kamera tersambung tetapi alamat atau port-nya terlihat aneh

Bukan kerusakan. Kamera lebih beragam daripada dugaan Anda:

• RTSP (jalur yang dipakai kamera untuk mengirim video) sering ada di port 554, tetapi ada kamera yang memakai 8554. (Port ibarat pintu bernomor di alamat kamera.)
• ONVIF biasanya di 80, 8000, atau 8080. Kami pernah menemukan 10000.
• Ada kamera yang tampil sebagai dua alamat IP, satu untuk video dan satu untuk ONVIF. Kameranya tetap satu.

JoynVision ikut memeriksa port yang tidak umum. Kalau punya Anda lebih unik lagi, masukkan alamatnya secara manual.

Masalah penghitungan

Angka lebih rendah dari kenyataan

Periksa berurutan; penyebab yang paling mungkin ada di urutan awal.

1. Apakah ada jalan masuk kedua?

Satu kamera mencakup kira-kira satu pintu. Kalau toko Anda punya dua pintu masuk dan hanya satu kamera, orang yang lewat pintu satunya tidak ikut terhitung. Di salah satu toko yang kami dampingi, pintu yang belum terpantau menyumbang 8 sampai 10% dari jumlah keluar setiap hari, sekitar 46 sampai 79 orang.

Cek: apakah dashboard menampilkan keterangan kuning "hanya satu pintu masuk yang dihitung"? Kalau ya, itulah jawabannya. Perbaiki dengan menambah kamera di pintu satunya; lihat panduan pemasangan.

2. Apakah gambarnya cukup besar dan tajam?

Kalau orang di gambar terlihat sangat kecil (sekitar 30 piksel, seukuran ibu jari di layar), perangkat lunak tidak bisa mengikutinya dari satu momen ke momen berikutnya dan orang itu luput sepenuhnya. JoynVision otomatis menghitung dari gambar terbesar kamera Anda, tetapi kalau gambar itu sendiri beresolusi rendah, atau kameranya dipasang terlalu jauh, masalahnya sama saja.

Cek: lihat gambar langsungnya. Apakah Anda bisa dengan mudah memastikan bahwa yang terlihat itu orang? Kalau Anda saja kesulitan, perangkat lunaknya juga.

3. Apakah garisnya berada di sudut yang kurang pas?

Kalau orang mendekati garis hitung dengan sudut landai (menyerempet, bukan memotong tegak lurus), penyeberangan tercatat terlambat; kami pernah mengukur keterlambatan 65 detik di satu rute. Totalnya tetap seimbang, tetapi waktunya meleset. Gambar ulang garisnya supaya sedekat mungkin dengan 90 derajat terhadap setiap rute yang dilalui orang. Panduan penempatan kamera menunjukkan contoh yang baik.

4. Apakah ada program lain yang membebani PC?

PC yang kelebihan beban melewatkan penyeberangan. Dalam pengujian kami, mesin yang senggang menghitung 10 masuk dan 10 keluar dengan hanya satu luput dari dua puluh, sedangkan mesin yang sama di bawah beban berat kehilangan sekitar 30% penyeberangan. Periksa Task Manager (daftar program yang sedang berjalan di PC). Periksa juga angka frame per detik di Pengaturan (frame per detik adalah banyaknya gambar yang sempat diperiksa perangkat lunak setiap detiknya); di bawah sekitar 3 fps, bersiaplah ada yang luput.

5. Baru setelah semuanya, pertimbangkan AI-nya. Dalam praktiknya, jawabannya selalu salah satu dari daftar di atas.

Angka lebih tinggi dari kenyataan

Penyebab. Ada dua garis hitung aktif di kamera yang sama, jadi setiap orang terhitung dua kali.

Perbaikan. Buka kalibrasi dan periksa daftar zona. Hapus garis pintu masuk yang berlebih. Satu kamera, satu garis.

Kalau memang hanya ada satu garis dan angkanya tetap tinggi, hubungi kami lewat tombol bantuan; kami akan memeriksanya bersama Anda.

Angka "orang di dalam" terus naik dan tidak pernah kembali ke nol

Penyebab. Ada jumlah keluar yang luput. Kamera pintu tidak bisa melihat berapa orang yang ada di dalam gedung, jadi angkanya murni hasil hitungan: jumlah masuk dikurangi jumlah keluar. Setiap keluar yang luput terus terbawa sampai hari berganti.

Cara mendiagnosisnya. Kalau toko Anda kosong di malam hari, angkanya semestinya kembali ke sekitar nol saat tutup:

• Meleset 1 atau 2: sehat. Abaikan saja.
• Meleset puluhan: ada jumlah keluar yang rutin luput. Periksa daftar "angka lebih rendah dari kenyataan" di atas. Penyebab yang paling umum adalah pintu kedua yang belum terpantau.

Catatan: kalau Anda punya zona okupansi di kamera yang melihat satu ruangan tertutup secara utuh, angkanya berasal dari penglihatan langsung dan bisa mengoreksi diri. Kamera pintu tidak bisa begitu, karena orang hanya lewat lalu menyebar ke luar bidikan.

Angkanya terbalik, orang masuk malah terhitung keluar

Penyebab. Dua titik garis hitung diklik dengan urutan terbalik. Urutan klik itulah yang menentukan arah.

Perbaikan. Gambar ulang garisnya dengan urutan klik yang sebaliknya. Uji dengan berjalan masuk satu kali.

Garis hitung tadinya normal, sekarang hampir tidak menghitung apa pun

Penyebab. Ada yang berpindah. Bisa kameranya tersenggol atau digeser, bisa juga ada display yang dipindahkan ke area pintu dan sekarang menghalangi jalur.

Perbaikan. Buka kalibrasi dan lihat gambar terkininya. Kalau pemandangannya bergeser, gambar ulang garis untuk tampilan yang baru. Jangan memakai kamera yang bisa berputar atau bergerak, karena garis digambar di atas gambar yang diam.

Aktivitas zona ramai, tetapi hitungan masuk dan keluar nyaris kosong

Kabar baik: ini justru menandakan perangkat lunak melihat orang dengan baik. Hanya saja jalur mereka tidak pernah memotong garis hitung Anda.

Perbaikan. Garisnya berada di tempat yang keliru. Amati satu orang berjalan masuk lewat tampilan langsung dan perhatikan ke mana ia sebenarnya melangkah. Sering kali bukan di tempat yang Anda kira pintunya berada. Gambar ulang garis melintasi jalur yang sebenarnya.

Masalah dashboard dan data

Dashboard kosong, atau menampilkan "Tidak dapat menghubungi server"

Penyebab. Browser (peramban) Anda sedang tidak bisa menghubungi JoynVision. Biasanya karena internet di tempat Anda, sesekali karena sisi kami.

Apa yang akan Anda lihat. Saat halaman tidak bisa memuat datanya, JoynVision menampilkan banner merah bahwa server tidak dapat dihubungi, lengkap dengan waktu terakhir angka diperbarui dan tombol Coba Lagi. Angka terakhir yang diketahui tetap ditampilkan, tidak diganti dengan nol.

Ini disengaja: dashboard yang kosong artinya "kami sedang tidak tahu", bukan "tidak ada pengunjung". Dashboard Anda tidak akan pernah menampilkan "0 pengunjung hari ini" dengan percaya diri padahal sebenarnya koneksinya yang gagal. Kalau Anda melihat angka tanpa banner merah, angka itu sungguhan.

Perbaikan. Periksa internet Anda. Tekan Coba Lagi. Kalau banner bertahan lebih dari beberapa menit, hubungi kami lewat tombol bantuan; biasanya selesai dalam satu sesi.

Angka harian terlihat salah, harinya seperti bergeser, atau laporan harian datang di jam yang aneh

Penyebab. Pengaturan zona waktu lokasi keliru. Zona waktu yang keliru diam-diam menyortir setiap total harian ke hari yang salah dan membuat laporan "akhir hari" datang di pagi hari, jadi ini yang paling layak dicek pertama.

Perbaikan. Pengaturan, lalu lokasi tersebut, lalu periksa zona waktunya. Periksa ini lebih dulu sebelum mencurigai hal lain setiap kali angka harian terlihat janggal.

Laporan atau ekspor bilang tidak ada kunjungan, padahal toko ramai

Begini cara kerjanya. Kalau laporan gagal memuat data, yang tampil adalah kartu "tidak dapat memuat" dengan tombol Coba Lagi, dan fitur ekspor memilih tidak menghasilkan berkas sama sekali daripada memberi Anda berkas kosong. Jadi tulisan "tidak ada kunjungan" yang sungguhan berarti sistem memang tidak menghitung apa pun pada periode itu.

Perbaikan. Kalau Anda melihat "tidak ada kunjungan" di hari yang Anda tahu ramai, periksa dulu zona waktu di atas, lalu telusuri masalah penghitungan di atas. Kalau keduanya tidak menjelaskan, hubungi kami lewat tombol bantuan; laporan seperti ini kami tangani dengan serius.

Ada hari yang tidak menampilkan tingkat konversi

Bukan kerusakan. Hari yang belum diisi angka transaksinya ditampilkan sebagai kekosongan, tidak pernah 0%. Kekosongan artinya "kami tidak tahu berapa penjualan Anda hari itu", dan itu berbeda dengan "Anda tidak menjual apa-apa".

Perbaikan. Masukkan jumlah transaksi untuk hari itu (Analitik, lalu formulir transaksi, atau unggah CSV).

Antrean menunjukkan waktu tunggu lama padahal tidak ada yang mengantre

Penyebab. Zona antrean digambar di atas jalur orang lalu-lalang, bukan di titik tempat orang benar-benar berdiri menunggu.

Diagnosis dengan satu angka. Lihat waktu diam tipikal di tile antrean (waktu diam atau dwell adalah lamanya orang berada di dalam zona). Di bawah sekitar 10 detik artinya zona itu berada di jalur lewat, bukan antrean; di salah satu toko yang kami dampingi angkanya 6,9 detik, yang ternyata memang orang berjalan lewat.

Perbaikan. Gambar ulang zona tepat di ruang tempat pelanggan berdiri diam menunggu.

Perlu diketahui juga: waktu diam yang terukur bisa dipercaya, sedangkan perkiraan waktu tunggu hanyalah taksiran kasar yang mengasumsikan waktu layanan tetap dan tidak tahu berapa kasir yang buka.

Tile kehadiran staf bilang konter kosong padahal ada orangnya

Penyebab. Zona staf tidak mencakup titik berdiri mereka yang sebenarnya, atau ambang "tak terjaga selama" terlalu pendek untuk ritme konter Anda.

Perbaikan. Gambar ulang zona di titik berdiri yang sebenarnya, dan sesuaikan ambangnya di aturan peringatan lokasi. Perubahan sampai ke lokasi dalam sekitar 30 detik.

Masalah video

Video langsung hitam atau kosong, tetapi penghitungan berjalan normal

Penyebab. Kamera mengirim videonya dalam format H.265 (format video generasi lebih baru), dan browser tidak bisa memutar H.265.

Penghitungan tidak terpengaruh sama sekali; format tidak mengubah hitungannya.

Perbaikan. Pastikan kamera mengaktifkan sub-stream H.264 di pengaturannya sendiri (H.264 adalah format yang bisa diputar semua browser; sub-stream adalah gambar kedua kamera yang berukuran lebih kecil). JoynVision memakai stream besar untuk menghitung dan stream H.264 yang lebih kecil untuk ditonton. Kalau kamera hanya menghasilkan H.265, tampilan langsung tidak akan berjalan di browser.

Perlu diketahui: kamera kadang salah melaporkan formatnya sendiri, mengaku H.264 padahal yang dikirim H.265. Kalau tampilan langsung kosong, anggap saja H.265 apa pun kata pengaturannya. Selengkapnya soal format stream ada di panduan kamera.

Video langsung jalan di toko, tetapi tidak dari rumah

Tidak ada yang rusak. Saat ini video langsung berjalan ketika Anda berada di jaringan yang sama dengan kamera; menonton dari luar toko sedang kami kembangkan.

Angka, grafik, dan peringatan Anda sudah bisa diakses dari mana saja.

Kamera menghilang setelah seseorang me-restart sesuatu di PC

Penyebab. Setelah restart tertentu pada perangkat lunak di lokasi, kamera yang ditambahkan dari dashboard bisa ikut hilang. Kasus ini sudah kami ketahui dan tangani.

Perbaikan. Hubungi kami lewat tombol bantuan; kami bisa memulihkan kameranya dengan cepat, biasanya selesai dalam satu sesi, dan perbaikan permanennya sedang disiapkan.

Pesan log yang terlihat menyeramkan padahal tidak

Kalau ada yang menunjukkan berkas log kepada Anda, semua ini normal:

• "error while decoding MB ..." artinya perangkat lunak bergabung ke stream video di tengah jalan. Tidak berbahaya.
• "RTP packets are too big, remuxing" normal untuk kamera beresolusi tinggi.
• "cannot open rtsp://... retrying in Ns" artinya koneksi sedang dicoba ulang. Akan pulih sendiri.
• "MQTT connect failed" / "MQTT disconnected" artinya saluran pembaruan cepat sedang tidak tersedia, jadi angka dikirim per kelompok. Lebih lambat, tetapi tidak ada satu pun yang hilang.

Dua pesan yang perlu ditindaklanjuti:

• "EDGE_API_KEY is EMPTY" artinya kunci lokasi belum terpasang. Lokasi tetap menghitung tetapi tidak bisa mengirim datanya ke mana pun. Hubungi kami lewat tombol bantuan; kami yang membereskannya.
• "network is unreachable" (berbeda dengan "connection refused") artinya PC-nya sendiri sedang bermasalah jaringannya. "Connection refused" berarti jaringan baik-baik saja dan perangkat lain yang menolak; "network is unreachable" berarti tidak ada jalur sama sekali.

Masalah kinerja

PC kasir jadi lambat sejak JoynVision dipasang

Penyebab. Menghitung memang memakai tenaga komputasi sungguhan, karena itu JoynVision membatasi diri ke 2 core CPU secara bawaan (CPU adalah otak PC; core adalah bagian-bagian yang mengerjakan tugasnya) dan menyisakan sisanya untuk kasir.

Perbaikan. Kalau PC masih terasa berat:

1. Periksa angka frame per detik di Pengaturan. Kalau jauh di atas 4, hubungi kami; batasnya bisa kami turunkan lagi dengan aman.
2. Kurangi menjadi satu kamera per PC. Dua kamera di PC kasir sederhana memang tuntutan yang berat.
3. Periksa apa lagi yang dikerjakan PC itu. Pemindaian antivirus, backup, dan pembaruan Windows semuanya berebut prosesor yang sama.

Jangan jalankan penghitungan di PC yang sudah mentok. Akibatnya penyeberangan luput, dan itu terlihat persis seperti perangkat lunak yang tidak akurat.

Angka frame per detik rendah

Kalau angkanya rendah: ada program lain yang memakai prosesor, atau batas CPU diatur terlalu ketat untuk mesin ini, atau perangkat kerasnya memang tidak memadai. Periksa dengan urutan itu.

Apa yang perlu dikirim saat menghubungi dukungan

Semakin lengkap daftar ini Anda sertakan, semakin cepat prosesnya:

1. Apa yang Anda harapkan dan apa yang terjadi, dengan perkiraan jam dan tanggal.
2. Lokasi mana dan kamera mana.
3. Tangkapan layar dashboard, termasuk banner merah atau kuning jika ada.
4. Apakah kamera terlihat online di dashboard, dan apakah terlihat online di aplikasi kameranya sendiri. (Kalau keduanya berbeda, itu sendiri sudah informasi yang berguna.)
5. Angka frame per detik dari Pengaturan.
6. Apakah ada yang berubah belakangan ini: router baru, listrik padam, kamera dipindah, tata letak toko berubah, perangkat lunak kasir baru.

Ada juga halaman Diagnostik di bawah Pengaturan untuk lokasi Anda, yang mengumpulkan detail teknis untuk kami.