camera.listImages

Enumera todas las imágenes de la cámara. Este comando dejó de estar disponible en el nivel de API 2. En su lugar, usa camera.listFiles.

Si una cámara no admite los parámetros solicitados, debe mostrar la capacidad máxima disponible para el hardware. Por ejemplo, un caso poco frecuente podría ser la solicitud: {entryCount: 500, maxSize: 2000}. En lugar de arrojar un error, la respuesta debe basarse en la capacidad máxima admitida por la cámara, por ejemplo: {entryCount: 100, maxSize: 200}. Muestra errores para todos los demás casos; por ejemplo, cuando la solicitud es {entryCount: 500, maxSize: -500}, debería arrojar el error invalidParameterValue, ya que maxSize es negativo.

Parámetros

  • entryCount: Es la cantidad deseada de entradas que se mostrarán.
  • maxSize: es el tamaño máximo de las imágenes en miniatura; max(thumbnail_width, miniaturas_height). Obligatorio solo cuando includeThumb es verdadero (a continuación).
  • continuationToken: Es un token de continuación opaco de tipo string que muestra la llamada listImages anterior y que se usa para recuperar las siguientes imágenes (opcional). Omite este parámetro para la primera llamada a listImages. Nota: La cámara es responsable del algoritmo que genera el token.
  • includeThumb: El valor predeterminado es true (opcional). Usa false para omitir las imágenes en miniatura del resultado.

Resultados

  • Entradas: Una lista de propiedades de la imagen. Cada entrada debe contener los siguientes campos, excepto los de latitud y longitud, que son opcionales:
    • name: Nombre
    • uri: URI
    • size: Tamaño en bytes
    • dateTimeZone: Es la fecha, la hora y la zona horaria de la imagen, en el formato: YYYY:MM:DD HH:MM:SS+(-)HH:MM. Usa el formato de 24 horas para la hora. La fecha y la hora están separadas por un carácter en blanco. La zona horaria se diferencia de la hora UTC.
    • lat: (Opcional) Es la latitud de la ubicación de captura de la imagen.
    • lng: Es la longitud de la ubicación en la que se capturará la imagen (opcional).
    • width: Ancho de la imagen
    • height: Altura de la imagen
    • thumbnail: Es una cadena codificada en Base64 para la imagen en miniatura (cuando includeThumb == true).
  • totalEntry: es la cantidad total de entradas almacenadas.
  • continuationToken: Opcional: Se configura solo si el resultado está incompleto (incompleto significa cualquier lista que no incluya la última imagen). Para recuperar las entradas restantes, el cliente debe volver a llamar al comando listImages con el token.

Errores

  • missingParameter: No se especifica ningún parámetro obligatorio; por ejemplo, no se especifica entryCount.
  • invalidParameterName: No se reconoce el nombre del parámetro de entrada.
  • invalidParameterValue: Se reconoce el nombre del parámetro de entrada, pero su valor no es válido; por ejemplo, continuationToken no existe, está fuera de rango, su tipo de datos es incorrecto, el tipo de datos de includeThumb es incorrecto o maxSize tiene un tipo de datos incorrecto cuando includeThumb es verdadero.

E/S de comando
Entrada del comando 
{
    "parameters": {
        "entryCount": 50,
        "maxSize": 100,
        "includeThumb": true
    }
}
Resultado del comando 
{
    "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"
    }
}
Resultado del comando (error) 
{
    "error": {
        "code": "invalidParameterValue",
        "message": "Parameter continuationToken is out of range."
    }
}