处理之前拍摄但尚未处理的图片。
此命令仅在您支持 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." } } |