camera.processPicture

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

处理之前已捕获但尚未处理的图片。 此命令仅在您支持 delayProcessing 时才适用,因为处理时间较长。如果您不支持 delayProcessing,则此命令的请求应失败,并显示错误代码 disabledCommand。此命令是在 API 级别 2 中添加的。

参数

  • previewFileUrls:未处理图片的网址列表。 如果您要处理相机中的所有未处理图片,则其值为“[all]”。该字段不能为空。如果相机在处理任何图片时遇到问题,相机不会返回错误作为响应,而是应忽略相应网址并继续处理其他图片,极端情况可能是 previewToFinalFileUrls 作为空 JSONObject 返回。

成效

  • previewToFinalFileUrls:JSON &key, value="> 对,其中每个键都是预览图片的绝对网址,每个键都是相应的最终处理后的图片,可用于直接从相机下载。请注意,此命令与 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."
    }
}