camera.getImage

Renvoie une image en taille réelle ou mise à l'échelle en fonction de son URI. Les paramètres d'entrée incluent la résolution. Il s'agit de la seule commande qui doit renvoyer Content-Type: image/jpeg. Toutes les autres commandes renvoient Content-Type: application/json;charset=utf-8. Cette commande a été abandonnée au niveau d'API 2.

Paramètres

  • fileUri:URI du fichier cible. Les fabricants décident d'utiliser des URI absolus ou relatifs. Les clients peuvent considérer cela comme un identifiant opaque.
  • maxSize : (facultatif) taille maximale de l'image demandée ; max(scaledimage_width, scalingimage_height). Si maxSize est omis ou supérieur à l'image en taille réelle, celle-ci est renvoyée.

Résultats

  • content:données binaires d'image, y compris les métadonnées correspondantes (par exemple, mises à l'échelle) dans l'en-tête de l'image.

Erreurs

  • missingParameter:l'attribut fileUri obligatoire n'est pas spécifié.
  • invalidParameterName:nom d'un paramètre d'entrée non reconnu.
  • invalidParameterValue:le nom du paramètre d'entrée est reconnu, mais sa valeur n'est pas valide. Par exemple, la valeur fileUri n'existe pas, son type de données est incorrect ou le type de maxSize est incorrect.

E/S des commandes

Entrée de commande
{
    "parameters": {
        "fileUri": "file URI",
        "maxSize": 400
    }
}
Résultat de la commande
Image binary data
Résultat de la commande (erreur)
{
    "error": {
        "code": "invalidParameterValue",
        "message": "Parameter fileUri doesn't exist."
    }
}