Wersja 2.1
Wstęp
Przewodnik producenta Open Spherical Camera (OSC) zawiera wskazówki implementacji interfejsu API aparatu sferycznego dla producentów aparatów z wbudowaną siecią Wi-Fi. Pełny zestaw poleceń znajdziesz w specyfikacji interfejsu OSC API.
Prześlij opinię
Czekamy na propozycje ulepszeń tych dokumentów. Daj nam znać, jeśli napotkasz problemy techniczne, mogą być niejasne w dokumentacji lub mogą działać nieoczekiwane działania. Zgłoś problem lub prześlij opinię i sugestie.
Kampanie Discovery
Proces wykrywania działa w ten sposób: kamera pełni wykrywalną, chronioną hasłem sieć Wi-Fi. Oprogramowanie klienckie działające na telefonie lub innym urządzeniu komputerowym przeprowadza skanowanie w poszukiwaniu takich sieci i wyświetla listę wykrytych identyfikatorów SSID, z których użytkownik może wybrać jeden. Użytkownik wpisuje hasło wybranej sieci, aby uwierzytelnić oprogramowanie klienta i połączyć je z serwerem kamery.
Kamera implementuje proces wykrywania, definiując zrozumiały dla człowieka identyfikator SSID, który jednoznacznie identyfikuje kamerę dla klienta. Serwer kamery uwierzytelnia się i komunikuje się z klientem przez HTTP na porcie 80.
Identyfikator SSID i hasło
Identyfikator SSID sieci Wi-Fi zaczyna się od łatwej w użyciu nazwy (maksymalnie 20 znaków) z separatorem kropki (.) przed sufiksem: OSC. Dodanie losowego, unikalnego elementu na końcu nazwy
pomaga zapobiegać konfliktom nazw. Na przykład właściwość VendorCamera123.OSC;, gdzie 123 jednoznacznie identyfikuje bieżącą kamerę spośród znajdujących się w pobliżu kamer tego samego modelu tego samego producenta.
Wi-Fi kamery wymaga ochrony WPA2-PSK. WPA2-PSK wymaga haseł zawierających co najmniej 8 znaków. Hasło może zawierać litery, cyfry i symbole, ale nie może zawierać spacji. Użytkownicy mogą to zmienić tylko wtedy, gdy kamera jest podłączona do urządzenia klienckiego. Po zmianie kamera się rozłącza i klient musi ponownie nawiązać połączenie, używając nowego hasła.
Kamera musi udostępnić metodę resetowania na wypadek, gdyby użytkownik zapomniał hasła, np. przycisk resetowania znajdujący się w kamerze, który umożliwia przywrócenie domyślnego hasła.
Adres IP i port
Adres IP kamery (np. 192.168.1.1) to adres IP bramy sieci Wi-Fi kamery i można go uzyskać z połączenia Wi-Fi po stronie klienta. W przypadku portu użyj domyślnego portu 80 na potrzeby HTTP (uzyskaj port na potrzeby aktualizacji z punktów końcowych w /osc/info; patrz Protokół OSC > Informacje).