camera.getImage

Restituisce un'immagine a grandezza originale o scalata in base all'URI. I parametri di input includono la risoluzione. Questo è l'unico comando che dovrebbe restituire, Content-Type: image/jpeg. Tutti gli altri comandi restituiscono Content-Type: application/json;charset=utf-8. Questo comando è stato ritirato nel livello API 2.

Parametri

  • fileUri: URI del file di destinazione. Sono i produttori a decidere se usare URI assoluti o relativi. I clienti possono considerare questo come un identificatore opaco.
  • maxSize: (facoltativo) dimensione massima dell'immagine richiesta; max(scaledimage_width, scaleimage_height). Se maxSize viene omesso o più grande dell'immagine a grandezza originale, viene restituita l'immagine a dimensione intera.

Risultati

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

Errori

  • missingParameter: il fileUri obbligatorio non è stato specificato.
  • invalidParameterName: il nome di un parametro di input non è riconosciuto.
  • invalidParameterValue: il nome del parametro di input è stato riconosciuto, ma il relativo valore non è valido. Ad esempio, il valore fileUri non esiste, il tipo di dati non è corretto oppure maxSize presenta il tipo di dati errato.

I/O comando

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