camera.listImmagini

Elenca tutte le immagini contenute nella fotocamera. Questo comando è stato ritirato nel livello API 2. Usa invece il criterio camera.listFiles.

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

Parametri

  • entryCount: il numero desiderato di voci da restituire.
  • maxSize: dimensione massima delle immagini in miniatura; max(thumbnail_width, thumbnail_height). 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 listImages. Nota:la videocamera è responsabile dell'algoritmo che genera il token.
  • includeThumb: (facoltativo) il valore predefinito è true. Usa false per omettere le miniature dal risultato.

Risultati

  • entries:un elenco di proprietà delle immagini. Ogni voce deve contenere i seguenti campi, ad eccezione di latitudine e longitudine, che sono facoltativi:
    • 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 ora sono separate da un carattere vuoto. Il fuso orario è offset dall'ora UTC.
    • lat: (facoltativo) latitudine della posizione di acquisizione delle immagini.
    • (Facoltativo) lng: longitudine del luogo di acquisizione dell'immagine.
    • width: larghezza immagine
    • height: altezza immagine
    • thumbnail: stringa codificata Base64 per l'immagine in miniatura (quando includeThumb == true).
  • totalEntries: il numero totale di voci nello spazio di archiviazione.
  • continuationToken: (facoltativo) da impostare solo se il risultato è incompleto (incompleto indica qualsiasi scheda che non include l'ultima immagine). Per recuperare le voci rimanenti, il client deve chiamare di nuovo il comando listImages con il token.

Errori

  • missingParameter: qualsiasi parametro richiesto non è specificato; ad esempio, entryCount non è specificato.
  • invalidParameterName: il nome del parametro di input non è riconosciuto.
  • invalidParameterValue: il nome del parametro di input viene riconosciuto, ma il relativo valore non è valido; ad esempio, continuationToken non esiste, è fuori intervallo, il tipo di dati non è corretto, il tipo di dati includeThumb è errato oppure maxSize contiene il tipo di dati errato quando includeThumb è true.

I/O comando
Input dei comandi 
{
    "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."
    }
}