API 級別 2.1
發布日期:2017 年 5 月
主要異動
- 新增直接上傳功能,讓相機直接將資料上傳至伺服器。
- 包含新指令
switchWifi和uploadFile。 - 已將
photoStitchingSupport、photoStitching、videoStitchingSupport、videoStitching、videoGPSSupport、videoGPS選項新增至 OSC 選項。 - 已將
cameraId欄位新增至/osc/info輸出內容。
- 包含新指令
- 將 360 度影片 XMP 規格替換為新的開放標準。
- 新增了在 360 影片 MP4 中指定相機 make/model 的建議。
API 級別 2
2016 年 7 月推出
主要異動
- 淘汰了
sessionId和淘汰/修改的相關指令。API 級別 2 是專為一個用戶端連線而設計,相機製造商應確保一次都只連結一個用戶端 (例如限制一個 Wi-Fi 連線)。- 已淘汰的指令
startSession/updateSession/closeSession。 - 已從
takePicture/getOptions/setOptions指令的輸入內容淘汰sessionId。
- 已淘汰的指令
- 已淘汰的指令
getImage/getMetadata。- 檔案的絕對網址會直接從相機的 HTTP 伺服器下載。
- 新增/修改用於錄影、間隔圖片拍攝和即時預覽的選項。
- 新增指令
startCapture/stopCapture/getLivePreview/processPicture/reset。 - 將
listImages重新命名為listFiles,並修改輸入內容/輸出內容,以處理影片類型和圖片類型。 - 已新增選項
previewFormat、previewFormatSupport、captureInterval、captureIntervalSupport、captureNumber、captureNumberSupport、remainingVideoSeconds、pollingDelay、delayProcessing、delayProcessingSupport和clientVersion。 - 已修改選項
captureModeSupport、isoSupport、shutterSpeedSupport、fileFormatSupport、hdr、hdrSupport、exposureBracket和exposureBracketSupport。
- 新增指令
- 新增 360 度影片 XMP 規格。
- 已將
apiLevel欄位新增至/osc/info輸出內容。- apiLevel:在 API 級別 2 中新增欄位。根據預設,如未提供這個欄位,系統會將此視為 API 級別 1。開發人員有責任擷取這項資訊,並根據值以不同方式實作。
回溯相容性
- 相機製造商:如果您一直都支援 API 級別 1,強烈建議您同時支援 API 級別 1 和 API 級別 2,做為最終更新前幾個月的中繼解決方案,並為搭載 API 級別 1 的相機提供韌體更新,否則僅支援 API 級別 1 的用戶端將無法使用相機。
- 應用程式開發人員:請注意,這些變更會影響先前發布的應用程式,您有責任針對這兩種版本進行對應的變更,並提醒相機擁有者更新韌體。