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

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 协议 > 信息）。