新变化

API 级别 2.1

发布时间：2017 年 5 月

重要变更

• 添加了直接上传功能，以允许将相机直接上传到服务器。
  • 添加了新命令 switchWifi 和 uploadFile。
  • 向 OSC 选项添加了 photoStitchingSupport、photoStitching、videoStitchingSupport、videoStitching、videoGPSSupport、videoGPS 选项。
  • 向 /osc/info 输出添加了 cameraId 字段。
• 将 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 规范。
• 向 /osc/info 输出添加了 apiLevel 字段。
  • apiLevel：在 API 级别 2 中添加了字段。如果缺少此字段，则系统默认将它视为 API 级别 1。开发者应负责检索这些信息，并根据值做出不同的实现。

向后兼容性

• 摄像头制造商：如果您一直在支持 API 级别 1，强烈建议您在最终更新之前的几个月内同时支持 API 级别 1 和 API 级别 2 作为中间解决方案，并为搭载 API 级别 1 的摄像头提供固件更新，否则仅支持 API 级别 1 的客户端将不支持您的摄像头。
• 应用开发者：请注意，这些变更会影响您之前发布的应用，您有责任对这两个版本进行相应的更改，并提醒相机所有者更新其固件。