API 级别 2 主要更改

本部分重点介绍您应了解并且应在相机或应用中考虑的所有主要更改。

主要更改

  • 已弃用的 sessionId 和已弃用/修改的相关命令。 API 级别 2 设计用于一个客户端连接，相机制造商应确保在任何时间只连接一个客户端（例如，限制只能有一个 WiFi 连接）。

  • 已弃用命令 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 的客户端将不再使用您的相机。

  • 应用开发者：请注意，这些更改会影响之前发布的应用，您应负责对两个版本进行相应的更改，并提醒相机所有者更新其固件。