камера.getImage
Возвращает полноразмерное или масштабированное изображение, учитывая его URI. Входные параметры включают разрешение. Это единственная команда, которая должна возвращать Content-Type: image/jpeg
. Все остальные команды возвращают Content-Type: application/json;charset=utf-8
. Эта команда устарела на уровне API 2.
Параметры
- fileUri: URI целевого файла. Производители решают, использовать ли абсолютные или относительные URI. Клиенты могут рассматривать это как непрозрачный идентификатор.
- maxSize: (Необязательно) Максимальный размер запрошенного изображения; max (scaledimage_width, Scaledimage_height). Если
maxSize
опущен или превышает полноразмерное изображение, возвращается полноразмерное изображение.
Результаты
- содержимое: двоичные данные изображения, включая соответствующие (например, масштабированные) метаданные в заголовке изображения.
Ошибки
- MissingParameter: не указан требуемый
fileUri
. - validParameterName: имя входного параметра не распознано.
- validParameterValue: имя входного параметра распознано, но его значение недопустимо; например, значение
fileUri
не существует, его тип данных неверен или maxSize
имеет неправильный тип данных.
Командный ввод/вывод |
---|
Ввод команды | {
"parameters": {
"fileUri": "file URI",
"maxSize": 400
}
} |
Вывод команды | Image binary data |
Вывод команды (ошибка) | {
"error": {
"code": "invalidParameterValue",
"message": "Parameter fileUri doesn't exist."
}
} |
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2024-11-09 UTC.
[null,null,["Последнее обновление: 2024-11-09 UTC."],[[["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"]]