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 máy ảnh không hỗ trợ các tham số được yêu cầu, thì máy ảnh phải trả về chức năng tối đa có sẵn 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ì báo lỗi, phản hồi nên 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 gửi lỗi cho tất cả các trường hợp khác; ví dụ: khi yêu cầu là {entryCount: 500, maxSize: -500}, lỗi invalidParameterValue sẽ gửi vì maxSize là số âm.

Các tham số

  • entryCount: Số mục nhập mong muốn trả về.
  • maxSize: Kích thước tối đa của hình thu nhỏ; max(thumbnail_width, thumbnail_height). 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ờ của chuỗi loại, được lệnh gọi listImages trước đó trả về, dùng để truy xuất các hình ảnh tiếp theo. Bỏ qua tham số này trong lệnh gọi listImages đầu tiên. Lưu ý: Camera chịu trách nhiệm về thuật toán tạo 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ả

  • items: 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. Sử dụng định dạng 24 giờ cho thời gian. Ngày và giờ được phân tách bằng một ký tự trống. Múi giờ chênh lệch 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 của hình ảnh
    • height: Chiều cao của hình ảnh
    • thumbnail: Chuỗi mã hoá Base64 cho hình thu nhỏ (khi includeThumb == true).
  • totalEntries (Tổng số mục): Tổng số mục trong bộ nhớ.
  • continuationToken: (Không bắt buộc) Chỉ đặt nếu kết quả không đầy đủ (incomplete có nghĩa là bất kỳ danh sách nào không bao gồm hình ảnh cuối cùng). Để tìm nạp các mục còn lại, ứng dụng nên gọi lại lệnh listImages bằng mã thông báo.

Lỗi

  • missingParameter: (Thông số bắt buộc): Bạn chưa chỉ định tham số bắt buộc nào; ví dụ: entryCount chưa được chỉ định.
  • invalidParameterName: Không nhận dạng được tên tham 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ụ: continuationToken không tồn tại, nằm ngoài phạm vi, loại dữ liệu 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à true.

I/O lệnh
Nhập lệnh 
{
    "parameters": {
        "entryCount": 50,
        "maxSize": 100,
        "includeThumb": true
    }
}
Đầu ra của 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"
    }
}
Kết quả của lệnh (Lỗi) 
{
    "error": {
        "code": "invalidParameterValue",
        "message": "Parameter continuationToken is out of range."
    }
}