API 層級 2 重要變更

本節著重於您應該了解並在您的相機或應用程式中列入考量的所有重要變更。

重要變更

• 已淘汰的 sessionId 和已淘汰/已修改的相關命令。 API 層級 2 是專為一個用戶端連線而設計，因此相機製造商應確認隨時只有一個用戶端連線（例如透過僅限一個 wifi 連線）。

  • 已淘汰命令 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 的客戶將無法使用您的相機。

• 應用程式開發人員：請注意，這些變更會影響您先前已發行的應用程式，而且您有責任做出相應的變更以處理兩個版本，並提醒相機擁有者更新其韌體。