Versi 1.0
Pengantar
Panduan Produsen Open Spherical Camera (OSC) menyediakan panduan implementasi API kamera sferikal bagi para produsen kamera yang dilengkapi WiFi bawaan. Lihat Spesifikasi OSC API untuk perintah selengkapnya.
Umpan balik
Kami nantikan saran dari Anda untuk memperbaiki dokumen ini. Apakah Anda menemui kesulitan masalah teknis, dokumentasi yang membingungkan, atau perilaku yang tidak diharapkan, beri tahu kami. Laporkan masalah atau kirim umpan balik dan saran.
Discovery
Alur kerja Discovery sebagai berikut: kamera berfungsi sebagai perangkat yang bisa ditemukan, dilindungi kata sandi, dan jaringan WiFi. Perangkat lunak klien bekerja pada ponsel atau perangkat komputer lain memindai jaringan semacam ini dan menampilkan daftar SSID (Service Set Identifier) yang ditemukan, yang harus dipilih satu oleh pengguna. Pengguna memasukkan kata sandi jaringan yang dipilih untuk mengautentikasi dan menghubungkan perangkat lunak klien dengan server kamera.
Kamera mengimplementasikan alur pencarian dengan mendefinisikan SSID yang bisa dibaca orang dan yang secara unik mengidentifikasi kamera kepada klien. Server kamera mengautentikasi dan berkomunikasi dengan klien melalui HTTP pada porta 80.
SSID dan kata sandi
WiFi SSID diawali nama yang mudah dikenali (maksimum 20 karakter), dengan tanda
titik (.) sebagai pemisah sebelum akhiran, OSC. Menambahkan elemen acak dan unik
ke bagian akhir nama akan mencegah konflik nama. Misalnya,
VendorCamera123.OSC; di mana 123 secara unik mengidentifikasi kamera saat ini dari
kamera terdekat dengan model yang sama, dari produsen yang sama.
WiFi kamera memerlukan perlindungan WPA2-PSK. WPA2-PSK memerlukan kata sandi dengan panjang minimum 8 karakter. Kata sandi bisa berisi huruf, angka, dan simbol, namun tidak boleh berisi spasi. Pengguna bisa mengubahnya bila kamera terhubung ke perangkat klien. Setelah diubah, kamera akan terputus dan klien harus menghubungkan kembali menggunakan kata sandi yang baru.
Kamera harus menyediakan metode reset seandainya pengguna lupa kata sandinya; misalnya, tombol reset di kamera untuk mengembalikan kata sandi default dari pabrik.
Porta dan alamat IP
Alamat IP kamera (misalnya 192.168.1.1) adalah alamat IP gerbang
jaringan wifi kamera, yang bisa diperoleh dari koneksi wifi di
sisi klien. Untuk porta, gunakan porta 80 default untuk HTTP (dapatkan porta untuk
pembaruan dari endpoint di /osc/info, lihat OSC Protocol > Info).