camera.listImages

Affiche la liste de toutes les images de l'appareil photo. Cette commande a été abandonnée dans le niveau d'API 2. Veuillez utiliser camera.listFiles à la place.

Si une caméra n'est pas compatible avec les paramètres demandés, elle doit renvoyer la capacité maximale disponible pour le matériel. Par exemple, la requête {entryCount: 500, maxSize: 2000} est un cas rare. Au lieu de générer une erreur, la réponse doit être basée sur la capacité maximale prise en charge par l'appareil photo, par exemple: {entryCount: 100, maxSize: 200}. Veuillez générer des erreurs pour tous les autres cas. Par exemple, lorsque la requête est {entryCount: 500, maxSize: -500}, l'erreur invalidParameterValue devrait être générée, car maxSize est négatif.

Paramètres

  • entryCount:nombre souhaité d'entrées à renvoyer.
  • maxSize:taille maximale des images de miniatures ; max(thumbnail_width, miniature_height). Obligatoire uniquement si includeThumb est vrai (ci-dessous).
  • continuationToken (facultatif) : jeton de continuation opaque de type chaîne, renvoyé par l'appel listImages précédent, utilisé pour récupérer les images suivantes. Omettez ce paramètre pour le premier appel listImages. Remarque:L'appareil photo est responsable de l'algorithme qui génère le jeton.
  • includeThumb : (facultatif) : true est la valeur par défaut. Utilisez false pour omettre les vignettes du résultat.

Résultats

  • entrées:liste des propriétés d'image. Chaque entrée doit contenir les champs suivants, à l'exception de la latitude et de la longitude, qui sont facultatifs :
    • name: nom
    • uri: URI
    • size: taille en octets
    • dateTimeZone : date, heure et fuseau horaire de l'image, au format YYYY:MM:DD HH:MM:SS+(-)HH:MM. Utilisez le format 24 heures pour l'heure. La date et l'heure sont séparées par un caractère vide. Le fuseau horaire est décalé par rapport à l'heure UTC.
    • lat (facultatif) : latitude du lieu de prise de vue de l'image.
    • lng (facultatif) : longitude du lieu de capture de l'image.
    • width: largeur de l'image
    • height: hauteur de l'image
    • thumbnail: chaîne encodée en base64 pour l'image de la vignette (lorsque la valeur est includeThumb == true).
  • totalEntries (Nombre d'entrées) : nombre total d'entrées dans l'espace de stockage.
  • continuationToken (facultatif) : à définir uniquement si le résultat est incomplet (incomplet désigne toute fiche n'incluant pas la dernière image). Pour récupérer les entrées restantes, le client doit appeler à nouveau la commande listImages avec le jeton.

Erreurs

  • missingParameter:aucun paramètre requis n'est spécifié. Par exemple, entryCount n'est pas spécifié.
  • invalidParameterName:le nom du paramètre d'entrée n'est pas reconnu.
  • invalidParameterValue:le nom du paramètre d'entrée est reconnu, mais sa valeur n'est pas valide. Par exemple, continuationToken n'existe pas, est hors plage, son type de données est incorrect, le type de données de includeThumb est incorrect ou le type de données de maxSize est incorrect lorsque includeThumb est défini sur "true".

E/S des commandes
Entrée de commande 
{
    "parameters": {
        "entryCount": 50,
        "maxSize": 100,
        "includeThumb": true
    }
}
Résultat de la commande 
{
    "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"
    }
}
Résultat de la commande (erreur) 
{
    "error": {
        "code": "invalidParameterValue",
        "message": "Parameter continuationToken is out of range."
    }
}