Версия 1.0
Введение
Руководство производителя Open Spherical Camera (OSC) содержит сведения по реализации API-интерфейса сферической камеры для производителей камер со встроенным Wi-Fi. См. Спецификацию OSC API для получения полного набора команд.
Отзывы
Мы будем рады услышать ваши предложения по улучшению данных документов. Если у вас возникли трудности в процессе разработки или при работе с документацией, а также неполадки в процессе использования, сообщите об этом нам. Сообщить о проблеме или отправить отзыв и предложения.
Обнаружение
Процесс обнаружения происходит следующим образом: камера работает в доступной для обнаружения, защищенной паролем сети Wi-Fi. Программное обеспечение клиента на телефоне или другом устройстве выполняет поиск таких сетей и отображает список обнаруженных сетей в виде SSID (Service Set Identifiers), среди которых пользователь может выбрать необходимый. Пользователь вводит пароль выбранной сети для аутентификации и подключения программного обеспечения к серверу камеры.
Чтобы облегчить обнаружение камеры, для нее задается понятный SSID, который служит ее уникальным идентификатором для клиента. Сервер камеры выполняет аутентификацию и осуществляет обмен данными с клиентом по протоколу HTTP, используя порт 80.
SSID и пароль
SSID сети Wi-Fi начинается с понятного имени (не более 20 символов) и имеет
точку (.) перед суффиксом OSC. Добавление произвольного уникального элемента
в конце имени позволяет избежать конфликта имен. Например,
VendorCamera123.OSC;, где 123 является уникальным идентификатором камеры, отличающим ее от других
камер этой же модели и этого же производителя.
Для камеры с функцией Wi-Fi требуется защита WPA2-PSK. WPA2-PSK требует наличие пароля длиной не менее 8 символов. Пароль может содержать буквы, цифры и символы, но не пробелы. Пользователь может изменить пароль только при подключении камеры к клиентскому устройству. После изменения пароля камера отключается и клиент должен переподключиться, используя новый пароль.
Камера должна предоставлять способ сброса в случае если пользователь забыл пароль; например, кнопку сброса на камере для восстановления заводского пароля по умолчанию.
IP-адрес и порт
IP-адрес камеры (например, 192.168.1.1) является IP-адресом шлюза
беспроводной сети камеры, который может быть получен от беспроводного соединения на
стороне клиента. Используйте значение порта по умолчанию 80 для НТТР (значение порта для
обновлений можно получить из объекта endpoints в /osc/info; см. Протокол OSC > Информация).