camera.processPicture

处理之前拍摄但尚未处理的图片。 此命令仅在您支持 delayProcessing 时才相关,因为 处理过程需要很长时间如果你不支持 delayProcessing, 对此命令的请求应该会失败,并生成错误代码 disabledCommand。 此命令是在 API 级别 2 中添加的。

参数

  • previewFileUrls:未处理图片的网址列表。 如果您要处理相机中所有未处理的图片,则为 [“all”]。 此字段不能为空。如果相机无法处理任何图片, 并不会返回错误,而是会忽略该网址并继续 极端情况可以是 previewToFinalFileUrls, 作为空 JSONObject 返回。

结果

  • previewToFinalFileUrls: JSON <key, value=""> 的 JSONObject 键值对,其中每个键都是预览图片的绝对网址,每个键 是对应的最终处理图片,可用于下载 直接使用相机拍摄请注意,此命令类似于 Camera.takePicture,不返回 previewToFinalFileUrls (本段后面将会介绍的特殊情况除外),因为 处理(包括相机内拼接)通常需要一段时间(因 从几秒到几分钟)即可完成。系统会获取命令的进度 使用 /osc/commands/status API 定期轮询相机,并且 previewToFinalFileUrls 是执行以下命令时返回的结果: 。如果在命令完成之前与相机的连接断开, 客户端可以使用 listFiles 在重新连接到相机时获取最终图像的网址,或者 发出另一个 processPicture 命令,该命令应该返回 previewToFinalFileUrls如果图片已经 。</key,>

错误

  • disabledCommand:如果您不支持延迟处理。
  • invalidParameterName:输入参数名称为 无法识别。
  • invalidParameterValue::输入参数名称为 但其值无效;例如 previewFileUrls 无效。

命令 I/O

命令输入
{
    "parameters": {
        "previewFileUrls": [
            "previewFileUrl1",
            "previewFileUrl2",
            "previewFileUrl3",
            ...
            "previewFileUrln"
        ]
    }
}
命令输出
{
    "results": {
        "previewToFinalFileUrls":{
            "previewFileUrl1": "finalFileUrl1",
            "previewFileUrl2": "finalFileUrl2",
            "previewFileUrl3": "finalFileUrl3",
            ...
            "previewFileUrln": "finalFileUrln"
        }
    }
}
命令输出(错误)
{
    "error": {
        "code": "disabledCommand",
        "message": "Command is currently disabled."
    }
}