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

1.0 版

简介

开放式球形相机 (OSC) 制造商指南为内置 WiFi 功能的相机的制造商提供球形相机 API 实现指南。 请参阅 OSC API 规范中提供的完整命令集。

反馈

我们期望收到您为改进这些文档提供的建议。 无论您是遇到工程难题,文档解释得不清楚还是出现异常行为,都可以联系我们。

报告问题或提交反馈和建议。

发现

发现流程的工作原理如下:相机服务于一个可检测到的、受密码保护的 WiFi 网络。 手机或其他计算设备上运行的客户端软件扫描此类网络,并显示已发现的网络服务集标识符 (SSID),用户可以从中选择一个。

用户输入选定的网络密码以进行验证,并将客户端软件与相机服务器进行连接。

相机通过定义可人工读取的、唯一向客户端标识相机的 SSID 实现发现流程。 相机的服务器进行验证,并在端口 80 上通过 HTTP 与客户端进行通信。

SSID 和密码

WiFi SSID 以用户友好的名称开头(最多 20 个字符),且在前缀 OSC 前使用一个句号 (.) 进行分隔。 向名称末尾添加一个随机的唯一元素,有助于防止名称冲突。 例如,VendorCamera123.OSC;,其中 123 从同一制造商生产的同一型号的附近相机中唯一地标识出当前相机。

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

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

IP 地址和端口

相机的 IP 地址(例如 192.168.1.1)是相机的 WiFi 网络的网关 IP 地址,可以从客户端上的 WiFi 连接获取。

对于端口,请使用 HTTP 默认端口 80(从 /osc/info 中的 endpoints 获取要更新的端口;请参阅 OSC 协议 > 信息)。