camera.listImages

Liste toutes les images de la caméra. Cette commande est obsolète depuis le niveau d'API 2. Veuillez plutôt utiliser camera.listFiles.

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

Paramètres

  • entryCount::nombre d'entrées souhaité à renvoyer.
  • maxSize:taille maximale des vignettes ; max(largeur_miniature, hauteur_miniature). Obligatoire uniquement lorsque la valeur de includeThumb est "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:La caméra est responsable de l'algorithme qui génère le jeton.
  • includeThumb: : (facultatif) prend la valeur par défaut 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 suivants à l'exception de la latitude et de la longitude, qui sont facultatives: <ph type="x-smartling-placeholder">
      </ph>
    • name: nom
    • uri: URI
    • size: taille en octets
    • dateTimeZone: date, heure et fuseau horaire de l'image, au format suivant: YYYY:MM:DD HH:MM:SS+(-)HH:MM Utilisez le format 24 heures pour l'heure. Date et l'heure sont séparés par un champ vide . Le fuseau horaire est décalé par rapport à l'heure UTC.
    • lat: (facultatif) latitude du lieu de la capture 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 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 La mention incomplète désigne toute fiche ne contenant pas la dernière image. Pour récupérer les données restantes le client doit à nouveau appeler la commande listImages avec le jeton.

Erreurs

  • missingParameter:les paramètres obligatoires ne sont pas spécifiés. Par exemple, entryCount n'est pas spécifié.
  • invalidParameterName:le nom du paramètre d'entrée est non reconnues.
  • invalidParameterValue::le nom du paramètre d'entrée est mais sa valeur n'est pas valide. Exemple : le continuationToken n'existe pas, est hors de portée, ses données type est incorrect, le type de données includeThumb est incorrect, ou Le type de données de maxSize est incorrect lorsque includeThumb est "true".

E/S de commande
Saisie de la 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."
    }
}