处理之前拍摄但尚未处理的图片。
此命令仅在您支持 delayProcessing
时才相关,因为处理需要很长时间。如果您不支持 delayProcessing
,则此命令的请求应失败,并显示错误代码 invalidCommand。此命令是在 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." } } |