camera.getImage

Trả về hình ảnh có kích thước đầy đủ hoặc được điều chỉnh theo tỷ lệ dựa vào URI của hình ảnh đó. Các tham số đầu vào bao gồm độ phân giải. Đây là lệnh duy nhất cần trả về, Content-Type: image/jpeg. Mọi lệnh khác đều 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.

Các tham số

  • fileUri: URI của tệp đích. Các nhà sản xuất quyết định sử dụng URI tuyệt đối hay 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, ofimage_height). Nếu maxSize bị bỏ qua hoặc lớn hơn hình ảnh có kích thước đầy đủ, thì hình ảnh có 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ả siêu dữ liệu tương ứng (ví dụ: được điều chỉnh theo tỷ lệ) trong tiêu đề hình ảnh.

Lỗi

  • missingParameter: fileUri bắt buộc chưa được chỉ định.
  • invalidParameterName: Không nhận dạng được tên của thông số đầu vào.
  • invalidParameterValue: Tên tham 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 tham số đó không chính xác hoặc maxSize có loại dữ liệu không chính xác.

I/O lệnh

Nhập lệnh
{
    "parameters": {
        "fileUri": "file URI",
        "maxSize": 400
    }
}
Đầu ra của lệnh
Image binary data
Kết quả của lệnh (Lỗi)
{
    "error": {
        "code": "invalidParameterValue",
        "message": "Parameter fileUri doesn't exist."
    }
}