camera.delete

Supprime un fichier en fonction de son URI. Cette commande a été modifiée au niveau d'API 2.

Paramètres

  • Niveau d'API 1
    • fileUri:URI d'un fichier à supprimer. Les fabricants décident d'utiliser des URI absolus ou relatifs. Les clients peuvent considérer cela comme un identifiant opaque.
  • Niveau d'API 2
    • fileUrls:liste d'URL absolues pour les fichiers à supprimer de l'appareil photo, obtenues précédemment, par exemple à partir des commandes camera.listFiles ou camera.takePicture. Il existe trois cas particuliers :
      • La liste ne contient que la chaîne "all" : supprime tous les fichiers de l'appareil photo.
      • La liste ne contient que la chaîne "image" : supprime toutes les images de l'appareil photo.
      • La liste ne contient que la chaîne "video" : supprime toutes les vidéos de la caméra.

Résultats

  • fileUrls:URL des fichiers qui n'ont pas pu être supprimés. Notez que cela se produit lorsque toutes les URL dans fileUrls sont valides, mais que l'appareil photo ne parvient pas à en supprimer certaines. Si l'une des URL n'est pas valide, le code d'erreur invalidParameterValue doit être renvoyé sans supprimer de fichier. Cet élément a été ajouté au niveau d'API 2.

Erreurs

  • missingParameter:fileUri non spécifié.
  • invalidParameterName:nom du paramètre d'entrée non reconnu.
  • invalidParameterValue:le nom du paramètre d'entrée est reconnu, mais sa valeur n'est pas valide. Par exemple, fileUri n'existe pas au niveau d'API 1 ou aucune URL spécifiée dans fileUrls n'existe au niveau d'API 2.

E/S des commandes
Entrée de commande (niveau d'API 1) 
{
    "parameters": {
        "fileUri": "file URI"
    }
}
Résultat de la commande (niveau d'API 1) 
none
Résultat de la commande (erreur) (niveau d'API 1) 
{
    "error": {
        "code": "invalidParameterName",
        "message": "Parameter XYZ is unrecognized."
    }
}
Entrée de commande (niveau d'API 2) 
{
    "parameters": {
        "fileUrls": [
            "url1",
            "url2",
            "url3",
            ...
            "urln"
        ]
    }
}
Résultat de la commande (niveau d'API 2) 
{
    "results": {
        "fileUrls": [
            "urln"
        ]
    }
}
Résultat de la commande (erreur) (niveau d'API 2) 
{
    "error": {
        "code": "invalidParameterValue",
        "message": "Parameter url3 doesn't exist."
    }
}