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