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)。