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 的用戶端將無法使用相機。
- 應用程式開發人員:請注意,這些變更會影響先前發布的應用程式,您有責任針對這兩種版本進行對應的變更,並提醒相機擁有者更新韌體。