camera.listИзображения

Перечисляет все изображения в камере. Эта команда устарела на уровне API 2. Вместо нее используйте camera.listFiles .

Если камера не поддерживает запрошенные параметры, она должна вернуть максимальные возможности, доступные для оборудования. Например, редким случаем может быть запрос: {entryCount: 500, maxSize: 2000} . Вместо выдачи ошибки ответ должен основываться на максимальной возможности, поддерживаемой камерой, например: {entryCount: 100, maxSize: 200} . Пожалуйста, выкиньте ошибки для всех остальных случаев; например, когда запрос имеет вид {entryCount: 500, maxSize: -500} , он должен выдать ошибку invalidParameterValue , поскольку maxSize имеет отрицательное значение.

Параметры

  • enterCount: Желаемое количество возвращаемых записей.
  • maxSize: максимальный размер миниатюр изображений; max(ширина_миниатюры, высота_миниатюры). Требуется только тогда, когда includeThumb имеет значение true (ниже).
  • continueToken: (Необязательно) Непрозрачный токен продолжения типа string, возвращаемый предыдущим вызовом listImages , используемый для получения следующих изображений. Опустите этот параметр для первого вызова listImages . Примечание. Камера отвечает за алгоритм генерации токена.
  • includeThumb: (Необязательно) По умолчанию — true . Используйте false , чтобы исключить миниатюры изображений из результата.

Полученные результаты

  • записи: список свойств изображения. Каждая запись должна содержать следующие поля, за исключением широты и долготы, которые не являются обязательными:
    • name : Имя
    • uri : URI
    • size : Размер в байтах
    • dateTimeZone : дата, время и часовой пояс для изображения в формате: YYYY:MM:DD HH:MM:SS+(-)HH:MM . Используйте 24-часовой формат времени. Дата и время разделяются одним пробелом. Часовой пояс смещен относительно времени UTC.
    • lat : (Необязательно) Широта места захвата изображения.
    • lng : (Необязательно) Долгота места захвата изображения.
    • width : Ширина изображения
    • height : Высота изображения
    • thumbnail : строка в кодировке Base64 для миниатюры изображения (когда includeThumb == true ).
  • totalEntries: общее количество записей в хранилище.
  • continueToken: (необязательно) Устанавливается только в том случае, если результат неполный ( неполный означает любой список, который не включает последнее изображение). Чтобы получить оставшиеся записи, клиент должен снова вызвать команду listImages с токеном.

Ошибки

  • MissingParameter: не указан ни один обязательный параметр; например, entryCount не указана.
  • validParameterName: имя входного параметра не распознано.
  • validParameterValue: имя входного параметра распознано, но его значение недопустимо; например, continuationToken не существует, находится вне диапазона, его тип данных неверен, тип данных includeThumb неверен или maxSize имеет неправильный тип данных, когда includeThumb имеет значение true.

Командный ввод/вывод

Ввод команды
{
    "parameters": {
        "entryCount": 50,
        "maxSize": 100,
        "includeThumb": true
    }
}
Вывод команды
{
    "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"
    }
}
Вывод команды (ошибка)
{
    "error": {
        "code": "invalidParameterValue",
        "message": "Parameter continuationToken is out of range."
    }
}