camera.listImmagini

Elenca tutte le immagini nella fotocamera. Questo comando è stato deprecato nel livello API 2. Usa invece camera.listFiles.

Se una videocamera non supporta i parametri richiesti, deve restituire il valore la capacità massima disponibile per l'hardware. Ad esempio, un raro caso potrebbe essere la richiesta: {entryCount: 500, maxSize: 2000}. Invece di generare un errore, la risposta deve essere basata sulla capacità massima supportata dalla fotocamera, ad esempio: {entryCount: 100, maxSize: 200}. Genera errori per tutti gli altri casi; ad esempio, se la richiesta è {entryCount: 500, maxSize: -500}, dovrebbe generare l'errore invalidParameterValue poiché maxSize è negativo.

Parametri

  • entryCount::numero di voci desiderato da restituire.
  • maxSize: dimensione massima delle immagini in miniatura. max(larghezza_miniatura, altezza_miniatura). Obbligatorio solo quando includeThumb è true (sotto).
  • continuationToken: (facoltativo) un token di continuazione opaco di tipo stringa, restituito dalla chiamata listImages precedente, utilizzato per recuperare le immagini successive. Ometti questo parametro per la prima chiamata a listImages. Nota:la fotocamera è responsabile dell'algoritmo che genera il token.
  • includeThumb: (facoltativo) il valore predefinito è true. Utilizza false per omettere immagini in miniatura dal risultato.

Risultati

  • entries: un elenco di proprietà di immagini. Ogni voce deve contenere i seguenti campi ad eccezione di latitudine e longitudine, che sono facoltative:
    • name: nome
    • uri: URI
    • size: dimensione in byte
    • dateTimeZone: data, ora e fuso orario dell'immagine, nel formato: YYYY:MM:DD HH:MM:SS+(-)HH:MM. Utilizza il formato 24 ore per l'ora. Data e il tempo sono separati da uno spazio . Il fuso orario è diverso dall'ora UTC.
    • lat: (facoltativo) latitudine del punto in cui è stata acquisita l'immagine.
    • lng: (facoltativo) Longitudine del punto di acquisizione dell'immagine.
    • width: larghezza dell'immagine
    • height: altezza dell'immagine
    • thumbnail: stringa codificata in Base64 per l'immagine in miniatura (quando includeThumb == true).
  • totalEntries: numero totale di voci nello spazio di archiviazione.
  • continuationToken:: (facoltativo) impostato solo se il risultato è incompleto Per incompleta si intende una scheda che non include l'ultima immagine. Per recuperare le informazioni rimanenti il client deve richiamare di nuovo il comando listImages con il token.

Errori

  • missingParameter: non è stato specificato alcun parametro obbligatorio. ad esempio entryCount non è specificato.
  • invalidParameterName:il nome del parametro di input è non riconosciuto.
  • invalidParameterValue: il nome del parametro di input è riconosciuto, ma il relativo valore non è valido; ad esempio continuationToken non esiste, è fuori intervallo, i relativi dati il tipo non è corretto, il tipo di dati includeThumb non è corretto oppure Il tipo di dati di maxSize è errato quando includeThumb è vero.

I/O comando
Input comando 
{
    "parameters": {
        "entryCount": 50,
        "maxSize": 100,
        "includeThumb": true
    }
}
Output 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"
    }
}
Output comando (errore) 
{
    "error": {
        "code": "invalidParameterValue",
        "message": "Parameter continuationToken is out of range."
    }
}