camera.listHình ảnh

Liệt kê tất cả hình ảnh trong máy ảnh. Lệnh này không còn được dùng trong API cấp 2. Thay vào đó, vui lòng sử dụng camera.listFiles.

Nếu camera không hỗ trợ các tham số được yêu cầu thì camera phải trả về khả năng tối đa sẵn có cho phần cứng. Ví dụ: một trường hợp hiếm gặp có thể là yêu cầu: {entryCount: 500, maxSize: 2000}. Thay vì gửi thông báo lỗi, phản hồi phải dựa trên khả năng tối đa mà máy ảnh hỗ trợ. chẳng hạn như: {entryCount: 100, maxSize: 200}. Vui lòng báo cáo lỗi cho tất cả các lỗi khác vụ việc; Ví dụ: khi yêu cầu là {entryCount: 500, maxSize: -500}, nên gửi lỗi invalidParameterValue vì maxSize mang giá trị âm.

Tham số

  • entryCount: Số mục nhập mong muốn cần trả về.
  • maxSize: Kích thước tối đa của hình ảnh thu nhỏ; max(hình thu nhỏ_chiều rộng; chiều_cao_hình_ thu nhỏ). Chỉ bắt buộc khi includeThumb là true (bên dưới).
  • continuationToken: (Không bắt buộc) Mã thông báo tiếp tục mờ thuộc loại chuỗi (do lệnh gọi listImages trước đó trả về) dùng để truy xuất hình ảnh tiếp theo. Hãy bỏ qua tham số này đối với lệnh gọi listImages đầu tiên. Lưu ý: Camera sẽ chịu trách nhiệm về thuật toán tạo ra mã thông báo.
  • includeThumb: (Không bắt buộc) Mặc định là true. Sử dụng false để loại bỏ hình thu nhỏ khỏi kết quả.

Kết quả

  • mục nhập: Danh sách các thuộc tính hình ảnh. Mỗi mục nhập phải chứa các trường sau ngoại trừ vĩ độ và kinh độ (không bắt buộc):
    • name: Tên
    • uri: URI
    • size: Kích thước tính bằng byte
    • dateTimeZone: Ngày, giờ và múi giờ cho hình ảnh, ở định dạng: YYYY:MM:DD HH:MM:SS+(-)HH:MM Hãy dùng định dạng 24 giờ cho thời gian. Ngày và thời gian được phân tách bằng một dấu trống . Múi giờ được bù trừ so với giờ UTC.
    • lat: (Không bắt buộc) Vĩ độ của vị trí chụp ảnh.
    • lng: (Không bắt buộc) Kinh độ của vị trí chụp ảnh.
    • width: Chiều rộng hình ảnh
    • height: Chiều cao của hình ảnh
    • thumbnail: Chuỗi mã hoá Base64 cho hình ảnh thu nhỏ (khi includeThumb == true).
  • totalEntries: Tổng số mục nhập trong bộ nhớ.
  • continuationToken: (Không bắt buộc) Chỉ đặt khi kết quả chưa hoàn chỉnh (chưa hoàn chỉnh có nghĩa là mọi trang thông tin không có hình ảnh cuối cùng). Để tìm nạp dữ liệu còn lại thì ứng dụng sẽ gọi lại lệnh listImages kèm theo mã thông báo.

Lỗi

  • ThiếuTham số: Mọi tham số bắt buộc chưa được chỉ định; ví dụ: entryCount không được chỉ định.
  • không hợp lệ Tham số: Tên của tham số đầu vào là không nhận dạng được.
  • invalidParameterValue: Tên của thông số đầu vào là được nhận dạng, nhưng giá trị của tham số này không hợp lệ; ví dụ: continuationToken không tồn tại, nằm ngoài phạm vi, dữ liệu loại không chính xác, loại dữ liệu của includeThumb không chính xác, hoặc maxSize có loại dữ liệu không chính xác khi includeThumb là đúng.

Lệnh I/O
Nhập lệnh 
{
    "parameters": {
        "entryCount": 50,
        "maxSize": 100,
        "includeThumb": true
    }
}
Kết quả lệnh 
{
    "results": {
        "entries": [
            {
                "name": "abc",
                "uri": "image URI",
                "size": image size in bytes,
                "dateTimeZone": "2014:12:27 08:00:00+08:00"
                "lat": 50.5324
                "lng": -120.2332
                "width": 2000
                "height": 1000
                "thumbnail": "ENCODEDSTRING"
            }
            ...
            {
                ...
            }
        ],
        "totalEntries": 250,
        "continuationToken": "50"
    }
}
Ra lệnh (Lỗi) 
{
    "error": {
        "code": "invalidParameterValue",
        "message": "Parameter continuationToken is out of range."
    }
}