camera.listImages

Lista todas as imagens da câmera. Esse comando foi descontinuado na API de nível 2. Em vez disso, use camera.listFiles.

Se uma câmera não oferecer suporte aos parâmetros solicitados, ela precisará retornar o recurso máximo disponível para o hardware. Por exemplo, um caso raro pode ser a solicitação: {entryCount: 500, maxSize: 2000}. Em vez de gerar um erro, a resposta precisa ser baseada no recurso máximo com suporte da câmera, como {entryCount: 100, maxSize: 200}. Gere erros para todos os outros casos. Por exemplo, quando a solicitação é {entryCount: 500, maxSize: -500}, ela deve gerar o erro invalidParameterValue, já que maxSize é negativo.

Parâmetros

  • entryCount:o número desejado de entradas a serem retornadas.
  • maxSize:o tamanho máximo das imagens em miniatura. Max(thumbnail_width, thumbnail_height). Obrigatório apenas quando includeThumb for verdadeiro (abaixo).
  • continuaçãoToken: (opcional) um token de continuação opaco da string de tipo, retornado pela chamada listImages anterior, usado para recuperar as próximas imagens. Omita esse parâmetro na primeira chamada de listImages. Observação:a câmera é responsável pelo algoritmo que gera o token.
  • includeThumb (opcional): assume true como padrão. Use false para omitir imagens em miniatura do resultado.

Resultados

  • entradas:uma lista de propriedades de imagem. Cada entrada precisa conter os seguintes campos, exceto latitude e longitude, que são opcionais:
    • name: nome
    • uri: URI
    • size: tamanho em bytes
    • dateTimeZone: data, hora e fuso horário para a imagem, no formato: YYYY:MM:DD HH:MM:SS+(-)HH:MM. Use o formato de 24 horas para o horário. A data e a hora são separadas por um caractere em branco. O fuso horário é diferente do horário UTC.
    • lat: (opcional) latitude do local da captura da imagem.
    • lng: (opcional) longitude do local de captura da imagem.
    • width: largura da imagem
    • height: altura da imagem
    • thumbnail: string codificada em Base64 para imagem em miniatura (quando includeThumb == true).
  • totalEntries:número total de entradas no armazenamento.
  • continuationToken: (opcional) é definido apenas se o resultado estiver incompleto (incompleto significa qualquer listagem que não inclua a última imagem). Para buscar as entradas restantes, o cliente precisa chamar o comando listImages novamente com o token.

Erros

  • missingParameter: qualquer parâmetro obrigatório não é especificado. Por exemplo, entryCount não está especificado.
  • invalidParameterName:o nome do parâmetro de entrada não foi reconhecido.
  • invalidParameterValue:o nome do parâmetro de entrada é reconhecido, mas o valor dele é inválido. Por exemplo, o continuationToken não existe, está fora do intervalo, o tipo de dados está incorreto, o tipo de dados de includeThumb está incorreto ou maxSize tem o tipo de dados errado quando includeThumb é verdadeiro.

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