camera.delete

Löscht eine Datei anhand ihrer URI. Dieser Befehl wurde in API-Level 2 geändert.

Parameter

  • API-Level 1
    • fileUri:URI einer zu löschenden Datei. Hersteller entscheiden, ob sie absolute oder relative URIs verwenden. Clients können dies als intransparente Kennzeichnung behandeln.
  • API-Level 2
    • fileUrls:Liste absoluter URLs für von der Kamera zu löschende Dateien, die zuvor z.B. über die Befehle camera.listFiles oder camera.takePicture abgerufen wurden. Es gibt drei Sonderfälle:
      • Die Liste enthält nur die Zeichenfolge „all“: Löscht alle Dateien in der Kamera.
      • Die Liste enthält nur den String „image“: Löscht alle Bilder in der Kamera.
      • Die Liste enthält nur den String „video“: Löscht alle Videos in der Kamera.

Ergebnisse

  • fileUrls:URLs von Dateien, die nicht gelöscht werden konnten. Das passiert, wenn alle URLs in „fileUrls“ gültig sind, die Kamera aber einige davon nicht löscht. Wenn eine der URLs ungültig ist, sollte der Fehlercode invalidParameterValue zurückgegeben werden, ohne die Datei zu löschen. Dies wurde in API-Level 2 hinzugefügt.

Fehler

  • missingParameter: fileUri nicht angegeben.
  • invalidParameterName:Der Name des Eingabeparameters wurde nicht erkannt.
  • invalidParameterValue:Der Name des Eingabeparameters wird erkannt, aber sein Wert ist ungültig. So ist beispielsweise fileUri in API-Ebene 1 nicht vorhanden oder keine URL in „fileUrls“ in API-Ebene 2.

Befehls-E/A
Befehlseingabe (API-Level 1) 
{
    "parameters": {
        "fileUri": "file URI"
    }
}
Befehlsausgabe (API-Level 1) 
none
Befehlsausgabe (Fehler) (API-Ebene 1) 
{
    "error": {
        "code": "invalidParameterName",
        "message": "Parameter XYZ is unrecognized."
    }
}
Befehlseingabe (API-Level 2) 
{
    "parameters": {
        "fileUrls": [
            "url1",
            "url2",
            "url3",
            ...
            "urln"
        ]
    }
}
Befehlsausgabe (API-Level 2) 
{
    "results": {
        "fileUrls": [
            "urln"
        ]
    }
}
Befehlsausgabe (Fehler) (API-Ebene 2) 
{
    "error": {
        "code": "invalidParameterValue",
        "message": "Parameter url3 doesn't exist."
    }
}