camera.getImage

Restituisce un'immagine a grandezza originale o scalata dato il suo URI. I parametri di input includono risoluzione del problema. Questo è l'unico comando che deve essere restituito, Content-Type: image/jpeg. Tutti gli altri comandi restituiscono Content-Type: application/json;charset=utf-8. Questo comando è stato deprecato nel livello API 2.

Parametri

  • fileUri: URI del file di destinazione. I produttori decidono se utilizzare URI assoluti o relativi. I clienti possono considerarlo come un identificatore opaco.
  • maxSize: (facoltativo) la dimensione massima dell'immagine richiesta. max(scaledimage_width, scalidimage_height). Se maxSize viene omesso o superiore rispetto all'immagine a grandezza originale, viene restituita l'immagine a grandezza originale.

Risultati

  • content: dati binari dell'immagine, inclusi i dati corrispondenti (ad esempio in scala). i metadati nell'intestazione dell'immagine.

Errori

  • missingParameter: il valore fileUri richiesto non è specificato.
  • invalidParameterName:nome di un parametro di input non riconosciuto.
  • invalidParameterValue: il nome del parametro di input è riconosciuto, ma il relativo valore non è valido; ad esempio il valore fileUri non esiste, il tipo di dati non è corretto, oppure maxSize ha il tipo di dati errato.

I/O comando

Input comando
{
    "parameters": {
        "fileUri": "file URI",
        "maxSize": 400
    }
}
Output comando
Image binary data
Output comando (errore)
{
    "error": {
        "code": "invalidParameterValue",
        "message": "Parameter fileUri doesn't exist."
    }
}