開啟球面相機製造商指南

2.1 版

簡介

Open Spherical Camera (OSC) 製造商指南為內建 Wi-Fi 的相機製造商提供球面相機 API 實作指南。如需完整指令集,請參閱 OSC API 規格

意見回饋

期待收到這些文件的建議改善措施。 無論您是否遇到工程問題點、令人混淆的文件,或是非預期的行為,歡迎與我們聯絡。回報問題或提交意見回饋和建議。

探索廣告活動

探索流程的運作方式如下:相機提供可偵測且受密碼保護的 Wi-Fi 網路。在手機或其他運算裝置上執行的用戶端軟體會掃描這類網路,並顯示已探索的網路服務設定 ID (SSID),讓使用者從中選取。使用者輸入所選網路的密碼來驗證用戶端軟體,並將用戶端軟體與相機伺服器連線。

相機會定義人類可讀的 SSID,明確為用戶端識別相機,藉此實作探索流程。攝影機的伺服器會 透過通訊埠 80 的 HTTP 驗證並 與用戶端通訊

SSID 和密碼

Wi-Fi SSID 會以容易使用的名稱 (最多 20 個半形字元) 開頭,並在後置字元 OSC 之前加上半形句號 (.) 分隔符號。在名稱結尾隨機加入不重複的元素,有助於避免名稱衝突。舉例來說,VendorCamera123.OSC;123 專門用於識別相同製造商提供的同一型號鄰近相機中的目前相機。

攝影機 Wi-Fi 需要 WPA2-PSK 防護。WPA2-PSK 要求密碼至少要有 8 個字元。密碼可以包含字母、數字和符號,但不能有空格。使用者只能在攝影機連線至用戶端裝置時變更該設定。變更之後,攝影機會中斷連線,用戶端必須使用新密碼重新連線。

攝影機必須提供重設方法,以免使用者忘記密碼;舉例來說,相機上的重設按鈕可還原原廠預設密碼。

IP 位址和通訊埠

相機的 IP 位址 (例如 192.168.1.1) 是相機 Wi-Fi 網路的閘道 IP 位址,可透過用戶端的 Wi-Fi 連線取得。針對通訊埠,請使用 HTTP 的預設通訊埠 80 (從 /osc/info 中的端點取得更新的通訊埠;請參閱 OSC 通訊協定 > 資訊)。