camera.listImages

Lista todas as imagens da câmera. Esse comando foi descontinuado no nível 2 da API. Use camera.listFiles.

Se uma câmera não oferecer suporte aos parâmetros solicitados, ela precisará retornar o à capacidade máxima 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 deve ser baseada na capacidade máxima suportada pela câmera, como: {entryCount: 100, maxSize: 200}. Gere erros para todos os outros casos de uso diferentes. 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(miniatura_largura, miniatura_altura). Obrigatório apenas quando includeThumb for verdadeiro (abaixo).
  • continuationToken:: (opcional) um token de continuação opaco do tipo string, retornado pela chamada anterior listImages, usado para recuperar as próximas imagens. Omita esse parâmetro para a primeira chamada de 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

  • entradas:uma lista de propriedades de imagem. Cada entrada deve conter os seguintes campos com exceção da latitude e da 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 a hora. Data e hora são separados por um espaço caractere. O fuso horário é diferente do UTC.
    • lat: (opcional) latitude do local da captura da imagem.
    • lng: (opcional) a longitude do local da 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:o número total de entradas no armazenamento.
  • continuationToken:: (opcional) é definido apenas se o resultado estiver incompleto. incompleto significa qualquer listagem que não inclui a última imagem. Para buscar o restante entradas, o cliente precisa chamar o comando listImages novamente com o token.

Erros

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

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."
    }
}