Open Spherical Camera 製造商指南

1.0 版

簡介

Open Spherical Camera (OSC) 製造商指南可為相機內建 WiFi 的製造商提供 Spherical Camera 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 Protocol > Info)。