Panduan pemasangan

Apa yang terjadi, secara berurutan, dari "saya punya kamera" sampai "dashboard mulai menghitung".

Baca ini dulu: cara pemasangan berjalan saat ini

JoynVision dirancang agar pemasangan cukup dengan satu kode: Anda mengunduh satu installer Windows, menjalankannya, mengetik satu kode penyambungan (kode singkat dari dashboard yang menyambungkan PC toko ke akun Anda), dan selesai. Installer itu sudah selesai dibuat dan kini menjalani pengujian akhir di mesin Windows sungguhan, karena kami hanya merilis apa yang sudah terbukti bekerja. Rinciannya ada di bagian bawah halaman ini, pada bagian "Apa yang akan datang".

Sampai installer itu dirilis, kami memasangnya bersama Anda. Tim kami menyiapkan perangkat lunak penghitung di PC Anda, baik secara langsung maupun lewat sesi jarak jauh, dan prosesnya kurang dari satu jam setelah kamera terhubung ke jaringan. Semua hal setelah itu (menambah kamera, menggambar garis, mengubah peringatan, mengundang staf Anda) Anda lakukan sendiri di dashboard, tanpa perlu bantuan kami.

Jika Anda lebih suka menunggu installer mandiri, beri tahu kami dan kami akan mengabari Anda begitu installer itu tersedia.

Yang Anda perlukan sebelum mulai

Kebutuhan sistem

Angka-angka ini diukur pada perangkat keras sungguhan, bukan perkiraan dari lembar spesifikasi, dengan satu pengecualian yang diberi tanda di bawah.

Pengukuran acuan

Lokasi pilot berjalan di sebuah laptop Intel Core i5 quad-core tahun 2018 (i5-8259U). Satu mesin itu menjalankan:

• penghitungan satu kamera, dan
• database, dan
• server, dan
• dashboard

semuanya sekaligus, pada 3 sampai 6 frame per detik (jumlah gambar dari kamera yang diperiksa perangkat lunak setiap detiknya), terus-menerus, termasuk uji dua hari penuh tanpa dijaga dan tanpa campur tangan sama sekali.

PC pelanggan biasa hanya menjalankan bagian penghitungan; database dan dashboard berjalan di tempat lain. Jadi PC kasir dengan umur serupa bebannya lebih ringan daripada mesin acuan kami.

Minimum dan yang disarankan

Angka RAM dan disk adalah pengecualian yang diberi tanda tadi: keduanya perkiraan berdasarkan pemakaian yang terukur (proses penghitungan sendiri memakai sekitar 1 GB). Angka CPU dan jumlah kamera adalah hasil pengukuran langsung.

Tentang CPU: tolong baca bagian ini

Penghitungan benar-benar memakai tenaga CPU. Pada pengujian awal, proses penghitungan mengambil setiap core yang bisa didapatnya dan membuat seluruh laptop tidak bisa dipakai. Kami sudah memperbaikinya secara tuntas: JoynVision kini membatasi dirinya ke 2 core CPU secara bawaan, sehingga program kasir Anda tetap lancar.

Ada kompromi yang perlu Anda ketahui:

Penghitungan terbukti akurat pada sekitar 4 frame per detik. Di bawah itu, orang yang berjalan cepat lebih mungkin terlewat. Jika PC Anda masih punya tenaga lebih, minta kami menaikkan batasnya.

Cara mengetahui apakah PC Anda cukup cepat

Setelah berjalan, dashboard menampilkan angka frame per detik untuk setiap kamera (Pengaturan → baris kamera tersebut).

Periksa juga Task Manager (alat bawaan Windows yang menunjukkan apa saja yang sedang memakai PC Anda). Jika satu kamera memakai 90% PC, Anda tidak bisa menambah kamera kedua, dan perangkat lunak POS (program kasir Anda) tetap butuh ruang untuk berjalan.

PC yang sibuk adalah faktor akurasi terbesar yang pernah kami ukur. Dalam uji terkontrol di mesin yang menganggur, penghitungan mencatat 10 masuk / 10 keluar dengan hanya satu terlewat dari dua puluh. Dengan program berat berjalan di mesin yang sama, kira-kira 30% lintasan hilang. Jika angka hitungan terlihat aneh, periksa dulu apa lagi yang membebani PC sebelum menyalahkan kamera.

Jaringan

• Kamera dan PC di jaringan yang sama, dengan client isolation dimatikan (client isolation adalah pengaturan router yang menyembunyikan perangkat satu sama lain).
• PC memerlukan akses internet keluar untuk mencapai dashboard. Penghitungan tetap berjalan tanpa internet; lihat bagian "Jika internet mati" di bawah.
• Beberapa port (pintu bernomor di firewall PC itu sendiri) perlu terbuka, dan installer akan membukanya untuk Anda: 8554, 8888, 8889 TCP dan 8189 UDP.

Pemasangan, langkah demi langkah

Langkah 1: Pasang kameranya

Lakukan ini paling awal, dan lakukan dengan benar, karena semua langkah berikutnya bergantung padanya.

Baca dulu panduan penempatan kamera. Dua hal yang paling merugikan Anda jika salah:

1. Satu kamera mencakup kira-kira satu pintu. Dua pintu masuk berarti dua kamera. Sebuah lokasi yang memakai satu kamera untuk dua pintu kurang hitung 8 sampai 10% setiap hari.
2. Arahkan agar orang tampak besar dan tajam di gambar. Gambar yang kecil dan buram tidak menghitung siapa pun sama sekali.

Langkah 2: Siapkan kameranya

Di aplikasi ponsel bawaan kamera itu:

1. Nyalakan ONVIF. Pada sebagian kamera, inilah yang membuat kamera bisa ditemukan sama sekali.
2. Catat username dan password ONVIF. Keduanya sering berbeda dari login aplikasi Anda.
3. Tetapkan alamat IP kamera (alamat angka kamera di jaringan lokal Anda) dengan mereservasinya berdasarkan alamat MAC (nomor identitas unik perangkat) di router Anda. Selama masa pilot, enam gangguan ternyata berasal dari langkah ini yang dilewatkan.

#### Cara mereservasi alamat IP kamera

Router Anda membagikan alamat dengan masa sewa. Saat router menyala ulang, entah karena listrik padam, pembaruan firmware, atau sesuatu dari sisi provider, kamera bisa mendapat alamat yang berbeda, dan JoynVision mencari kamera yang sudah berpindah. Ini penyebab paling umum hitungan sebuah toko mendadak berhenti, dan mencegahnya cukup sekali, sekitar lima menit.

Reservasi berarti memberi tahu router: perangkat ini selalu mendapat alamat ini. Anda hanya butuh satu hal, yaitu alamat MAC kamera (nomor identitas perangkat sepanjang dua belas karakter yang tidak pernah berubah).

Menemukan alamat MAC. JoynVision sudah mengetahuinya. Buka Kamera, pilih kamera Anda, dan alamat MAC tampil bersama detail koneksi, siap disalin. Alamat ini juga tercetak pada stiker di badan kamera, dan router Anda mencantumkannya di daftar perangkatnya sendiri.

Mengatur reservasi. Buka halaman admin router Anda di browser, biasanya 192.168.1.1 atau 192.168.0.1, dengan password yang tercetak pada stiker di bawah router. Lalu:

Istilahnya berbeda-beda tiap merek. DHCP Reservation, Static Lease, Address Binding, Static DHCP dan Bind IP to MAC semuanya berarti hal yang sama. Tambahkan satu entri yang memasangkan alamat MAC kamera dengan alamat yang dipakainya sekarang, lalu simpan. Sebagian router baru menerapkannya setelah dinyalakan ulang.

Lakukan hal yang sama untuk PC yang menjalankan JoynVision jika memungkinkan. Ini tidak sepenting kamera, karena PC yang mencari kamera dan bukan sebaliknya, tetapi sangat memudahkan saat Anda butuh bantuan karena semuanya berada di alamat yang pasti.

Kalau kamera tetap berpindah, JoynVision akan mencarinya di jaringan Anda dan menyambung ulang sendiri, tetapi hanya setelah terbukti itu perangkat yang sama, dengan mencocokkan alamat MAC yang sama atau membuka stream yang sama memakai kredensial yang sama. Ia tidak akan pernah diam-diam mengarah ke kamera toko sebelah.

Rincian lengkap ada di panduan kompatibilitas kamera.

Langkah 3: Buat akun Anda

Buka dashboard dan daftar: nama organisasi, email Anda, sebuah password. Akun baru mendapat uji coba gratis 14 hari, tanpa kartu.

Langkah 4: Buat lokasi pertama Anda

Sebuah "lokasi" adalah satu toko, cabang, atau tempat usaha. Anda akan diminta mengisi:

• Nama. Apa pun sebutan Anda sehari-hari.
• Jenis. Retail, Industri, atau Rumah. Ini hanya mengubah pilihan yang ditawarkan dan penamaan hal-hal di dalamnya. Penghitungannya bekerja persis sama untuk ketiganya.
• Zona waktu. Pastikan ini benar. Kami pernah melihat zona waktu yang salah diam-diam mengacaukan urutan tiga bulan angka harian dan mengirim laporan akhir hari pada jam sembilan pagi. Jika angka harian Anda pernah terlihat aneh, inilah hal pertama yang perlu diperiksa.

Langkah 5: Pasang perangkat lunak penghitung di PC

Ini langkah yang saat ini kami kerjakan bersama Anda (lihat catatan di bagian atas halaman ini). Langkah ini memasang dua komponen di PC kasir Anda:

• layanan penghitung, yang membaca kamera dan melakukan perhitungannya;
• sebuah layanan video kecil, yang menangani koneksi kamera dan mengalirkan gambar langsung ke browser Anda.

Keduanya menyala otomatis saat PC dinyalakan dan memulai ulang sendiri jika berhenti. Video tetap berada di tempat Anda. Hanya angka hasilnya (hitungan anonim, tanpa gambar) yang dikirim ke dashboard.

Langkah 6: Tambahkan kamera di dashboard

Bagian ini bisa Anda lakukan sendiri dan memakan waktu sekitar satu menit. Tiga langkah:

1. Cari kamera. Dashboard memindai jaringan Anda begitu Anda membuka dialognya. Ketuk kamera yang ditemukannya. Jika tidak ada yang muncul, selalu ada pilihan "Masukkan alamat sendiri": gunakan itu, jalurnya lebih andal.
2. Sambungkan. Masukkan password kamera. Tombol Sambungkan menguji kamera sebelum menyimpan apa pun, sehingga password yang salah ketahuan di sini, bukan menghasilkan kamera yang diam-diam tidak pernah bekerja.
3. Beri nama, lalu tekan Tambah & gambar garisnya.

Di balik layar, JoynVision meminta semua stream (aliran video) dari kamera lalu memilih yang terbesar untuk penghitungan dan yang lebih kecil untuk ditonton. Anda tidak perlu mengatur bagian itu.

Jika pemindaian tidak menemukan apa pun, penyebab paling umum sejauh ini adalah ONVIF yang belum dinyalakan. Penyebab kedua paling umum: kamera berada di jaringan yang berbeda dari PC.

Langkah 7: Gambar garis hitung

Di sinilah penyiapan benar-benar selesai. Kamera yang mengalirkan video tetapi belum punya garis tidak menghitung apa pun.

Anda akan melihat gambar diam dari kamera Anda. (Jika tertulis "Menunggu frame pertama", beri waktu sekitar 15 detik.) Klik dua titik untuk menggambar garis melintang di jalur yang dilewati orang.

Hal-hal pokoknya, dari panduan penempatan kamera:

• Buat garis sedekat mungkin ke sudut 90° terhadap setiap rute yang dilalui orang.
• Panjang garis tidak penting. Yang menentukan hanya posisi dan sudutnya.
• Satu garis per kamera. Dua garis membuat semua orang terhitung dua kali.

Perubahan sampai ke kamera dalam waktu sekitar 30 detik. Tanpa restart, tanpa kunjungan teknisi.

Langkah 8: Beri tahu kami jumlah pintu masuk lokasi ini

Di halaman kalibrasi, masukkan jumlah jalan yang bisa dipakai orang untuk masuk dan keluar area itu.

Jika Anda menulis dua tetapi hanya satu yang terhitung, dashboard akan menampilkan baris berwarna kuning yang menjelaskan bahwa angka pengunjung Anda kurang hitung. Itu disengaja. Kami lebih memilih memberi tahu Anda bahwa angkanya rendah daripada membiarkan Anda menyusun rencana dari angka yang diam-diam salah.

Langkah 9: Pastikan penghitungan benar-benar berjalan

Berjalanlah masuk lewat pintu. Dalam satu sampai dua detik, angka di dashboard seharusnya naik.

Berjalanlah keluar lagi. Angkanya seharusnya turun.

Jika masuknya Anda terhitung sebagai keluar, gambar ulang garisnya dengan mengeklik kedua titik dalam urutan sebaliknya.

Lalu biarkan berjalan satu hari operasional penuh dan lakukan pemeriksaan harian gratis ini: jika tempat Anda kosong pada malam hari, angka "orang di dalam" seharusnya kembali ke sekitar nol saat tutup. Selisih satu atau dua itu wajar. Selisih berpuluh-puluh berarti ada yang salah posisi; lihat panduan penempatan kamera.

Langkah 10: Tambahan opsional

• Zona. Zona antrean di kasir, cakupan staf, area terbatas. Lihat panduan penempatan kamera untuk posisi masing-masing.
• Tingkat konversi. Ketikkan jumlah transaksi kemarin (atau unggah file CSV, sebuah file tabel sederhana, dari POS Anda) dan dashboard menunjukkan berapa bagian pengunjung Anda yang benar-benar membeli sesuatu. Patokan ritel 20 sampai 40% digambar di grafik sebagai pembanding. Hari tanpa angka yang dimasukkan tampil sebagai celah, tidak pernah sebagai nol.
• Peringatan. Kamera offline, antrean terlalu panjang, area terbatas dimasuki, tidak ada orang di konter. Semua ambang batas diubah dari dashboard dan sampai ke lokasi dalam waktu sekitar 30 detik.
• Undang tim Anda. Pengaturan → Tim. Anda bisa membatasi seseorang hanya ke lokasi tertentu. Satu hal yang perlu diketahui: saat ini peran manajer, staf, dan viewer dalam praktiknya punya izin yang sama, dan hanya perbedaan pemilik/admin yang diberlakukan. Dialognya pun menjelaskan hal itu.

Jika internet mati

Penghitungan tetap berjalan. Lokasi menyimpan salinan pengaturan Anda sendiri dan mencatat setiap hitungan secara lokal. Saat koneksi kembali, semua yang terjadi selama itu diunggah. Tidak ada yang hilang.

Ini disengaja. Lokasi tidak pernah bergantung pada server kami untuk melakukan tugasnya.

Apa yang akan datang

Installer Windows native: satu file .exe, tanpa perlu mengatur apa pun.

Ia hanya meminta satu hal: kode penyambungan, kode singkat dari dashboard yang dijelaskan di bagian atas halaman ini. Anda mendapatkannya dari dashboard: buka Pengaturan, pilih lokasi yang sedang Anda pasangi, lalu klik Pasang di PC. Kodenya terlihat seperti ini:

JV-7QK4-M2NP-XRSO

Huruf besar dan tanda hubung tidak berpengaruh, jadi Anda bisa membacakannya lewat telepon kepada siapa pun yang berdiri di depan PC kasir.

Installer mengirim kode itu kepada kami dan kami mengirim balik semua hal lain yang dibutuhkannya: ke lokasi mana PC ini terdaftar, kuncinya, dan pengaturan koneksinya. Anda tidak pernah melihat atau mengetik satu pun dari itu. Sebelum selesai, installer menampilkan nama lokasi yang tersambung, sehingga kode yang tertempel dari dialog lokasi yang salah langsung ketahuan saat itu juga, bukan seminggu kemudian.

Sebuah kode hanya berlaku sekali dan kedaluwarsa setelah 24 jam. Jika Anda butuh kode lain, buat yang baru; kode lama berhenti berlaku begitu kode baru dibuat. Memperbarui pemasangan yang sudah ada tidak memerlukan kode sama sekali.

Installer juga membereskan banyak hal yang tanpanya bisa diam-diam bermasalah: folder yang bisa ditulisi di tempat yang benar, database zona waktu yang tepat, dan pengaturan persis yang membuat koneksi kamera bekerja.

Posisinya sekarang: installer sudah selesai dibuat dan berjalan di sistem build otomatis kami, dan pertukaran kode penyambungan sudah diuji ujung ke ujung terhadap server kami. Sebelum dirilis, kami menguji paket lengkapnya di PC kasir Windows sungguhan: proses pemasangannya, wizard penyiapannya, serta ukuran terpasangnya (dirancang sekitar 150 MB). Satu catatan praktis: sampai file-nya ditandatangani secara digital (tanda tangan digital yang memberi tahu Windows siapa penerbit sebuah file), Windows SmartScreen atau antivirus Anda mungkin menampilkan pesan peringatan saat pertama kali dijalankan. Itu wajar untuk penerbit baru dan akan hilang begitu penandatanganan selesai.

Kami merilisnya setelah lulus uji di PC kasir sungguhan, dan tidak sebelum itu.

Yang juga sedang disiapkan: tampilan kamera langsung dari luar toko Anda, pengecualian staf dari hitungan pengunjung, peringatan dan laporan harian lewat WhatsApp, serta antarmuka Bahasa Indonesia.

Yang perlu Anda ketahui sebelum menyiapkan

• Satu kamera mencakup satu pintu. Ini batas fisik yang berlaku untuk setiap produk di kategori ini, jadi toko dengan dua pintu masuk membutuhkan dua kamera. Siapkan satu kamera per pintu, dan angka Anda sudah benar sejak hari pertama.
• Akurasi Anda diukur otomatis, setiap malam. Alih-alih klaim di brosur, toko Anda menghasilkan angkanya sendiri saat tutup dan menampilkannya di layar Laporan. Lihat cara kami mengukur akurasi.
• Anda bisa mengeluarkan tim Anda sendiri dari angka pengunjung. Aktifkan pengecualian staf untuk sebuah lokasi, dan lalu-lalang tim Anda berhenti dihitung sebagai pelanggan. Fitur ini tidak aktif sampai Anda meminta, menunjukkan dulu seberapa besar perubahannya sebelum Anda pakai, dan tidak pernah mengubah hari-hari yang sudah Anda lihat.
• Tidak ada pengenalan usia, jenis kelamin, atau wajah, selamanya. Kami menyimpan angka anonim, bukan gambar orang. Ini keputusan produk yang disengaja, dan itulah sebabnya video Anda tidak perlu keluar dari toko.

• Pertanyaan seputar kamera → Kompatibilitas kamera
• Akurasi dan penempatan → Penempatan kamera
• Ada yang tidak beres → Pemecahan masalah