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 appellistImages
. Remarque:L'appareil photo est responsable de l'algorithme qui génère le jeton. - includeThumb : (facultatif) :
true
est la valeur par défaut. Utilisezfalse
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
: nomuri
: URIsize
: taille en octetsdateTimeZone
: date, heure et fuseau horaire de l'image, au formatYYYY: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'imageheight
: hauteur de l'imagethumbnail
: chaîne encodée en base64 pour l'image de la vignette (lorsque la valeur estincludeThumb == 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 deincludeThumb
est incorrect ou le type de données demaxSize
est incorrect lorsqueincludeThumb
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." } } |