camera.listImages

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

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

Se uma câmera não for compatível com os 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 na capacidade máxima aceita pela câmera, como: {entryCount: 100, maxSize: 200}. Registre erros em todos os outros casos. Por exemplo, quando a solicitação for {entryCount: 500, maxSize: -500}, o erro invalidParameterValue deverá ser gerado, 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, miniatura_height). Obrigatório apenas quando includeThumb for verdadeiro (abaixo).
  • continuationToken: (opcional) um token de continuação opaco do tipo string, retornado pela chamada listImages anterior, usado para recuperar as próximas imagens. Omita esse parâmetro para a primeira chamada listImages. Observação:a câmera é responsável pelo algoritmo que gera o token.
  • includeThumb: (opcional) o padrão é true. Use false para omitir imagens em miniatura do resultado.

Resultados

  • Entries: 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 da 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 de 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 a imagem em miniatura (quando includeThumb == true).
  • totalEntries: número total de entradas no armazenamento.
  • continuationToken: (opcional) definir 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 foi especificado. entryCount não foi 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 dado está incorreto, o tipo de dados de includeThumb está incorreto ou maxSize tem o tipo de dados errado quando includeThumb é verdadeiro.

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