camera.listImages

Répertorie 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} peut être très rare. Au lieu de générer une erreur, la réponse doit être basée sur la capacité maximale acceptée par la caméra, 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}, elle doit renvoyer l'erreur invalidParameterValue, car la valeur de maxSize est négative.

Paramètres

  • entryCount:le nombre souhaité d'entrées à afficher.
  • maxSize : taille maximale des images miniatures ; max(thumbnail_width, miniatures_height). Obligatoire uniquement lorsque includeThumb est défini sur "true" (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) la valeur par défaut est true. Utilisez false pour omettre les vignettes du résultat.

Résultats

  • entrées : liste des propriétés de l'image. Chaque entrée doit contenir les champs facultatifs, à 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. Indiquez le format 24 heures. 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 la prise de vue.
    • lng : (facultatif) longitude de l'emplacement de la capture d'image.
    • width: largeur de l'image
    • height: hauteur de l'image
    • thumbnail : chaîne encodée en base64 pour l'image miniature (lorsque includeThumb == true).
  • totalEntries:nombre total d'entrées dans l'espace de stockage.
  • continuationToken : (facultatif) défini uniquement si le résultat est incomplet (incomplete pour les fiches qui n'incluent pas la dernière image). Pour récupérer les entrées restantes, le client doit à nouveau appeler la commande listImages avec le jeton.

Erreurs

  • missingParameter : aucun paramètre obligatoire 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, la valeur continuationToken n'existe pas, elle 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 de commande

Saisie 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."
    }
}