camera.getImage
根据 URI 返回完整尺寸或缩放后的图片。输入参数包括
分辨率。这是应返回的唯一命令,即 Content-Type: image/jpeg
。
所有其他命令都会返回 Content-Type: application/json;charset=utf-8
。
此命令已在 API 级别 2 中弃用。
参数
- fileUri::目标文件的 URI。制造商可自行决定是否使用
绝对 URI 或相对 URI。客户端可能会将其视为不透明标识符。
- maxSize:(可选)所请求图片的大小上限;
max(scaledimage_width, Scalingimage_height)。如果省略
maxSize
或返回更大的值
则会返回完整尺寸的图片。
结果
- content:图片二进制数据,包括相应的(例如经过缩放)的数据
元数据。
错误
- missing 参数:未指定所需的
fileUri
。
- invalid 参数 Name:输入参数名称无法识别。
- invalidParameterValue::输入参数名称被识别,但其值
无效;例如,
fileUri
值不存在、其数据类型不正确,
或 maxSize
的数据类型不正确。
命令 I/O |
命令输入 |
{ "parameters": { "fileUri": "file URI", "maxSize": 400 } } |
命令输出 |
Image binary data |
命令输出(错误) |
{ "error": { "code": "invalidParameterValue", "message": "Parameter fileUri doesn't exist." } } |
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2024-08-21。
[null,null,["最后更新时间 (UTC):2024-08-21。"],[[["Returns a full-size or scaled image based on its URI, with optional resizing using the `maxSize` parameter."],["This command is deprecated and was replaced in API level 2, primarily used for retrieving image data in JPEG format."],["Input requires a `fileUri` parameter, while `maxSize` is optional for scaling the output image."],["Output provides the image as binary data, including relevant metadata, or an error message in JSON format."],["Potential errors involve missing or invalid parameters, such as an incorrect `fileUri` or `maxSize` value."]]],["The command retrieves an image (full-size or scaled) via its URI, with `fileUri` being mandatory and `maxSize` (maximum dimension) being optional. If `maxSize` is omitted or exceeds the image's full size, the full-size image is provided. Output is image binary data, with `Content-Type: image/jpeg`. Errors include missing/invalid parameter or invalid value. It was deprecated in API level 2. Example input involves `fileUri` and `maxSize`. Example error is related to an invalid `fileUri`.\n"]]