新功能'

API 級別 2.1

發布日期:2017 年 5 月

主要異動

API 級別 2

2016 年 7 月推出

主要異動

  • 淘汰了 sessionId 和淘汰/修改的相關指令。API 級別 2 是專為一個用戶端連線而設計,相機製造商應確保一次都只連結一個用戶端 (例如限制一個 Wi-Fi 連線)。
  • 已淘汰的指令 getImage/getMetadata
    • 檔案的絕對網址會直接從相機的 HTTP 伺服器下載。
  • 新增/修改用於錄影、間隔圖片拍攝和即時預覽的選項
    • 新增指令 startCapture/stopCapture/getLivePreview/processPicture/reset
    • listImages 重新命名為 listFiles,並修改輸入內容/輸出內容,以處理影片類型和圖片類型。
    • 已新增選項 previewFormatpreviewFormatSupportcaptureIntervalcaptureIntervalSupportcaptureNumbercaptureNumberSupportremainingVideoSecondspollingDelaydelayProcessingdelayProcessingSupportclientVersion
    • 已修改選項 captureModeSupportisoSupportshutterSpeedSupportfileFormatSupporthdrhdrSupportexposureBracketexposureBracketSupport
  • 新增 360 度影片 XMP 規格。
  • 已將 apiLevel 欄位新增至 /osc/info 輸出內容。
    • apiLevel:在 API 級別 2 中新增欄位。根據預設,如未提供這個欄位,系統會將此視為 API 級別 1。開發人員有責任擷取這項資訊,並根據值以不同方式實作。

回溯相容性

  • 相機製造商:如果您一直都支援 API 級別 1,強烈建議您同時支援 API 級別 1 和 API 級別 2,做為最終更新前幾個月的中繼解決方案,並為搭載 API 級別 1 的相機提供韌體更新,否則僅支援 API 級別 1 的用戶端將無法使用相機。
  • 應用程式開發人員:請注意,這些變更會影響先前發布的應用程式,您有責任針對這兩種版本進行對應的變更,並提醒相機擁有者更新韌體。