camera.getImage
Trả về hình ảnh có kích thước đầy đủ hoặc hình ảnh được điều chỉnh theo tỷ lệ dựa trên URI. Các tham số đầu vào bao gồm
độ phân giải. Đây là lệnh duy nhất sẽ trả về, Content-Type: image/jpeg
.
Tất cả các lệnh khác trả về Content-Type: application/json;charset=utf-8
.
Lệnh này không còn được dùng trong API cấp 2.
Tham số
- fileUri: URI của tệp đích. Các nhà sản xuất quyết định có nên sử dụng
URI tuyệt đối hoặc tương đối. Ứng dụng có thể coi đây là giá trị nhận dạng không rõ ràng.
- maxSize: (Không bắt buộc) Kích thước tối đa của hình ảnh được yêu cầu;
max(scaledimage_width, chiều_cao_hình_ảnh_tỷ_lệ). Nếu
maxSize
bị bỏ qua hoặc lớn hơn
hình ảnh kích thước đầy đủ sẽ được trả về.
Kết quả
- content: Dữ liệu nhị phân của hình ảnh, bao gồm cả dữ liệu tương ứng (ví dụ: được điều chỉnh theo tỷ lệ)
siêu dữ liệu trong tiêu đề hình ảnh.
Lỗi
- missingTham số:
fileUri
bắt buộc chưa được chỉ định.
- không hợp lệ Tham số: Tên tham số đầu vào không nhận dạng được.
- invalidParameterValue: Tên thông số đầu vào được nhận dạng, nhưng giá trị của tham số đó
không hợp lệ; ví dụ: giá trị
fileUri
không tồn tại, loại dữ liệu của giá trị không chính xác,
hoặc maxSize
có loại dữ liệu không chính xác.
Lệnh I/O |
Nhập lệnh |
{ "parameters": { "fileUri": "file URI", "maxSize": 400 } } |
Kết quả lệnh |
Image binary data |
Ra lệnh (Lỗi) |
{ "error": { "code": "invalidParameterValue", "message": "Parameter fileUri doesn't exist." } } |
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2024-08-21 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2024-08-21 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"]]