camera.listFiles

Liste toutes les images/toutes les vidéos/toutes les images et vidéos de la caméra. Cela peut prendre plusieurs requêtes pour lister tous les fichiers. Cette commande a été ajoutée au niveau d'API 2.

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

  • fileType:type des fichiers à répertorier (doit correspondre à l'une des valeurs suivantes) les trois : "image", "video" et "all".
  • startPosition: : (facultatif) position du premier fichier dans dans la liste. En cas d'omission, la position de départ est 0, ce qui représente le premier fichier. Si elle est plus grande que la position du dernier fichier, la fonction renvoie une une réponse normale avec des entrées vides dans les résultats au lieu d'une réponse d'erreur.
  • entryCount::nombre d'entrées souhaité à renvoyer. Si c'est le cas plus de fichiers que le nombre de fichiers restants, renvoyez simplement une réponse normale avec les fichiers restants au lieu d'une réponse d'erreur.
  • maxThumbSize::taille maximale des vignettes max(largeur_miniature, hauteur_miniature). Il est défini sur null lorsque le client souhaite 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 du fichier.
    • fileUrl::URL absolue du fichier, qui peut être utilisée pour télécharger directement depuis l'appareil photo.
    • size:taille en octets du fichier.
    • dateTimeZone:date, heure et fuseau horaire du fichier, au format suivant: YYYY:MM:DD HH:MM:SS+(-)HH:MM Utilisez le format 24 heures pour l'heure. Date et les heures sont séparées par un caractère vide. Le fuseau horaire est décalé par rapport à l'heure UTC. Veuillez noter que représente la fin de la capture vidéo.
    • lat : (facultatif) latitude de l'emplacement au moment de la capture du fichier.
    • lng : (facultatif) longitude de l'emplacement au moment de la capture du fichier.
    • width:largeur de l'image ou de chaque image vidéo.
    • height:hauteur de l'image ou de chaque image vidéo.
    • thumbnail:chaîne encodée en base64 pour l'image miniature du fichier (si maxThumbSize != null).
    • isProcessed:valeur booléenne indiquant si le fichier est traité (cousu, par exemple) ou il s'agit seulement d'un aperçu. Cela devrait être vrai en par défaut, sauf si delayProcessing est défini sur "true". Si une image traitée existe, l'image d'aperçu correspondante ne devrait pas être listée, même si elle existe, Sinon, listez l'image d'aperçu.
    • previewUrl::chaîne vide par défaut si delayProcessing. n'est pas pris en charge, lorsque isProcessed est défini sur "false" ou lorsque l'image d'aperçu n'a jamais été générée comme résultat intermédiaire. Sinon, il s'agit de l'URL l'image d'aperçu correspondant à l'image finale. Ceci est utilisé pour construire la correspondance entre l'image d'aperçu et l'image finale.
  • totalEntries:nombre total d'entrées de fileType dans stockage (ex. : Si fileType est "image", il s'agit du nombre total d'images dans stockage.

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 reconnu. mais que sa valeur est incorrecte ; par exemple, entryCount est négatif ou son type de données est incorrect.

E/S de commande
Saisie de la commande 
{
    "parameters": {
        "entryCount": 50,
        "maxThumbSize": 100
    }
}
Résultat de la commande 
{
    "results": {
        "entries": [
            {
                "name": "abc",
                "fileUrl": "file URL",
                "size":  file size, # of bytes,
                "dateTimeZone": "2014:12:27 08:00:00+08:00",
                "lat": 50.5324,
                "lng": -120.2332,
                "width": 2000,
                "height": 1000,
                "thumbnail": "ENCODEDSTRING",
                "isProcessed": true,
                "previewUrl": ""
            }
            ...
            {
                ...
            }
        ],
        "totalEntries": 250
    }
}
Résultat de la commande (erreur) 
{
    "error": {
        "code": "invalidParameterValue",
        "message": "Parameter entryCount is negative."
    }
}