开放式球形相机制造商指南

2.1 版

简介

开放式球形相机 (OSC) 制造商指南为内置 Wi-Fi 的相机的制造商提供了球形相机 API 实现指南。如需查看完整的命令集,请参阅 OSC API 规范

反馈

我们期待收到您对这些文档提出的改进建议。 无论您是遇到工程难题,文档令人困惑,还是出现意外行为,请告诉我们。 报告问题或提交反馈和建议

发现广告系列

发现流程的工作原理如下:相机服务于一个可检测到的、受密码保护的 Wi-Fi 网络。手机或其他计算设备上运行的客户端软件会扫描此类网络,并显示已发现的网络服务集标识符 (SSID),用户可以从中选择一个。用户输入所选网络的密码以进行身份验证,并将客户端软件与相机的服务器连接。

相机通过定义简单易懂的 SSID(用于向客户端唯一标识相机)来实现发现流程。相机的服务器进行身份验证,并在端口 80 上通过 HTTP 与客户端进行通信。

SSID 和密码

Wi-Fi SSID 以用户易于理解的名称开头(最多 20 个字符),并在后缀 OSC 前使用英文句点 (.) 作为分隔符。在名称末尾添加一个随机的唯一元素,有助于防止名称冲突。例如,VendorCamera123.OSC;,其中 123 从同一制造商生产的同一型号的附近相机中唯一标识当前相机。

相机 WLAN 需要 WPA2-PSK 保护。WPA2-PSK 要求的密码长度至少为 8 个字符。密码可以包含字母、数字和符号,但不能有空格。仅当相机连接到客户端设备时,用户才能更改此设置。更改密码后,相机会断开连接,并且客户端必须使用新密码重新连接。

相机必须提供重置方法,以防用户忘记了密码;例如,在相机上提供用于恢复出厂默认密码的重置按钮。

IP 地址和端口

相机的 IP 地址(例如 192.168.1.1)是相机 Wi-Fi 网络的网关 IP 地址,可以从客户端的 Wi-Fi 连接获取。对于端口,请使用 HTTP 的默认端口 80(从 /osc/info 中的端点获取用于更新的端口;请参阅 OSC 协议 > 信息)。