camera.listFiles

Elenca tutte le immagini/tutti i video/tutte le immagini e i video nella fotocamera. L'operazione potrebbe diverse richieste per elencare tutti i file. Questo comando è stato aggiunto nel livello API 2.

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

  • fileType: il tipo di file da elencare deve essere uno di i tre: "immagine", "video", "tutti".
  • startPosition: (facoltativo) la posizione del primo file da da restituire nell'elenco. Se omesso, la posizione iniziale è 0, che rappresenta il primo file. Se è più grande della posizione dell'ultimo file, restituisci risposta normale con voci vuote nei risultati anziché una risposta di errore.
  • entryCount::numero di voci desiderato da restituire. Se è rispetto al numero di file rimanenti, restituisci una risposta normale i file effettivi rimanenti invece di una risposta di errore.
  • maxThumbSize: la dimensione massima delle immagini in miniatura; max(larghezza_miniatura, altezza_miniatura). È impostato su null quando il client vuole omettere dal risultato delle miniature.

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: il nome del file.
    • fileUrl: l'URL assoluto del file, che può essere utilizzato per scaricarlo direttamente dalla fotocamera.
    • size: le dimensioni in byte del file.
    • dateTimeZone:data, ora e fuso orario del file nel formato: YYYY:MM:DD HH:MM:SS+(-)HH:MM. Utilizza il formato 24 ore per l'ora. Data e sono separate da un carattere vuoto. Il fuso orario è diverso dall'ora UTC. Tieni presente che rappresenta la fine dell'acquisizione video.
    • lat: (facoltativo) la latitudine della posizione al momento dell'acquisizione del file.
    • lng: (facoltativo) longitudine della posizione al momento dell'acquisizione del file.
    • width: la larghezza dell'immagine o di ogni frame video.
    • height: l'altezza dell'immagine o di ogni frame video.
    • thumbnail: stringa codificata in Base64 per l'immagine in miniatura del file (quando maxThumbSize != null).
    • isProcessed: un valore booleano che indica se il file è elaborati (ad es. con unione) o sono solo un'anteprima. Questo dovrebbe essere vero valore predefinito a meno che delayProcessing non sia impostato su true. Se esiste un'immagine elaborata, l'immagine di anteprima corrispondente non deve essere elencata anche se esiste, altrimenti, elenca l'immagine di anteprima.
    • previewUrl: la stringa predefinita è vuota se delayProcessing. non è supportato o quando isProcessed è uguale a false o quando l'immagine di anteprima non è mai stato generato come risultato intermedio, altrimenti è l'URL di l'immagine di anteprima corrispondente all'immagine finale. Viene utilizzato per creare la corrispondenza tra l'immagine di anteprima e l'immagine finale.
  • totalEntries: numero totale di voci di fileType in spazio di archiviazione, ad es. se il tipo di file è "image", rappresenta il numero totale di immagini in archiviazione.

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 suo valore non è valido; ad esempio, entryCount è negativo o il tipo di dati non è corretto.

I/O comando
Input comando 
{
    "parameters": {
        "entryCount": 50,
        "maxThumbSize": 100
    }
}
Output comando 
{
    "results": {
        "entries": [
            {
                "name": "abc",
                "fileUrl": "file URL",
                "size":  file size, # of bytes,
                "dateTimeZone": "2014:12:27 08:00:00+08:00",
                "lat": 50.5324,
                "lng": -120.2332,
                "width": 2000,
                "height": 1000,
                "thumbnail": "ENCODEDSTRING",
                "isProcessed": true,
                "previewUrl": ""
            }
            ...
            {
                ...
            }
        ],
        "totalEntries": 250
    }
}
Output comando (errore) 
{
    "error": {
        "code": "invalidParameterValue",
        "message": "Parameter entryCount is negative."
    }
}