camera.listImages

Muestra una lista de 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, esta debe mostrar el máxima disponible para el hardware. Por ejemplo, un caso excepcional podría ser la solicitud: {entryCount: 500, maxSize: 2000}. En lugar de arrojar un error, la respuesta debe basarse en la capacidad máxima que admite la cámara. por ejemplo: {entryCount: 100, maxSize: 200}. Por favor arroja los errores para todas las 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: Cantidad deseada de entradas para mostrar.
  • maxSize: Tamaño máximo de las imágenes en miniatura. max(miniatura_ancho, altura_miniatura) Es obligatorio solo cuando includeThumb es verdadero (a continuación).
  • continuationToken: (Opcional): Es un token de continuación opaco de tipo string, que muestra la llamada anterior a listImages, que se usa para recuperar las imágenes siguientes. Omite este parámetro durante la primera llamada a listImages. Nota: La cámara es responsable del algoritmo que genera el token.
  • includeThumb: (Opcional) El valor predeterminado es true. Usa false para omitir las imágenes en miniatura del resultado.

Resultados

  • entradas: Una lista de propiedades de imagen. Cada entrada debe contener los siguientes campos excepto por la latitud y la 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 Para la hora, usa el formato de 24 horas. Fecha y la hora están separadas por un espacio en blanco carácter. La zona horaria se aleja de la hora UTC.
    • lat: Es la latitud de la ubicación de captura de la imagen (opcional).
    • lng: Es la longitud de la ubicación de captura de la imagen (opcional).
    • width: Ancho de la imagen
    • height: Altura de la imagen
    • thumbnail: String codificada en base64 para la imagen en miniatura (cuando includeThumb == true).
  • totalEntradas: Número total de entradas en el almacenamiento
  • continuationToken: (opcional): Se establece solo si el resultado está incompleto. (incompleto significa cualquier ficha que no incluya la última imagen). Para recuperar los restantes el cliente debe volver a llamar al comando listImages con el token.

Errores

  • missingParameter: No se especifican los parámetros necesarios. Por ejemplo, no se especifica entryCount.
  • invalidParameterName: El nombre del parámetro de entrada es no reconocidos.
  • invalidParameterValue: El nombre del parámetro de entrada es reconoce, pero su valor no es válido; por ejemplo, continuationToken no existe, está fuera del rango y sus datos tipo es incorrecto, el tipo de datos de includeThumb es incorrecto o maxSize tiene el tipo de datos incorrecto cuando includeThumb es true.

E/S de comando
Entrada de 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."
    }
}