camera.getImage

根据图片的 URI 返回完整尺寸或缩放的图片。输入参数包括分辨率。这是应返回的唯一命令,即 Content-Type: image/jpeg。所有其他命令均返回 Content-Type: application/json;charset=utf-8此命令在 API 级别 2 中已废弃。

参数

  • fileUri:目标文件的 URI。制造商决定是使用绝对 URI 还是相对 URI。客户端可将其视为不透明标识符。
  • maxSize:(可选)所请求图片的大小上限;max(scaledimage_width, zoomimage_height)。如果省略 maxSize 或大小大于完整尺寸的图片,则返回完整尺寸的图片。

成果

  • content:图片二进制数据,包括图片标头中的相应(例如缩放的)元数据。

错误数

  • missingParameter:未指定所需的 fileUri
  • invalidParameterName:输入参数名称无法识别。
  • invalidParameterValue:系统可识别输入参数名称,但其值无效;例如,fileUri 值不存在、其数据类型不正确,或 maxSize 的数据类型有误。

命令 I/O

命令输入
{
    "parameters": {
        "fileUri": "file URI",
        "maxSize": 400
    }
}
命令输出
Image binary data
命令输出(错误)
{
    "error": {
        "code": "invalidParameterValue",
        "message": "Parameter fileUri doesn't exist."
    }
}