拍摄等距柱状图像,保存纬度/经度坐标
EXIF(如果您的相机自带 GPS 或在连接时启用了 GPS
手机)。致电camera.setOptions
(如果需要的话)。此命令已在 API 级别 2 中修改。
参数
- sessionId::从
camera.startSession
命令。 此字段在 API 级别 2 中已废弃。
结果
- API 级别 1
<ph type="x-smartling-placeholder">
- </ph>
- fileUri::所拍摄图片的 URI。制造商 决定是使用绝对 URI 还是相对 URI;例如 "http://android.com/robots.txt"是 在“robots.txt”文件中指定的是相对 URI。客户端可能会 将其用作不透明标识符
- API 级别 2
<ph type="x-smartling-placeholder">
- </ph>
- fileUrl::所拍图片的绝对网址,
用于直接从相机的 HTTP 服务器下载。请
请注意,此命令不会立即返回
fileUrl
,因为 拍摄(包括相机内拼接)通常需要一段时间(具体取决于 (几秒到几分钟)即可完成。命令的进度通过 使用 /osc/commands/status API 定期轮询相机,fileUrl
是命令完成后返回的结果。时间delayProcessing
为 true,它是预览的绝对网址 图片,可用作 processPicture 中的输入, 否则,就是最终处理后图片的绝对网址。
- fileUrl::所拍图片的绝对网址,
用于直接从相机的 HTTP 服务器下载。请
请注意,此命令不会立即返回
错误
- missing 参数:缺少
sessionId
。 此错误代码在 API 级别 2 中已废弃。 - invalidParameterName:参数名称无法识别,例如API 级别 2 中无法识别
sessionId
。 - invalidParameterValue::识别输入参数名称,
但其值无效;例如,
sessionId
不存在, 不再有效,或其数据类型不正确。此错误代码在 API 级别 2 中已废弃。 - disabledCommand:命令当前已停用;例如 相机处于视频拍摄模式。此错误代码已添加到 API 级别 2 中。
命令 I/O | |
---|---|
命令输入(API 级别 1) | { "parameters": { "sessionId": "12ABC3" } } |
命令输出(API 级别 1) | { "results": { "fileUri": "file URI" } } |
命令输出(错误)(API 级别 1) | { "error": { "code": "invalidParameterValue", "message": "Parameter sessionId doesn't exist." } } |
命令输入(API 级别 2) | none |
命令输出(API 级别 2) | { "results": { "fileUrl": "Absolute file URL" } } |
命令输出(错误)(API 级别 2) | { "error": { "code": "disabledCommand", "message": "Command is currently disabled." } } |