CANNOT TRANSLATE

Elimina un file in base all'URI corrispondente. Questo comando è stato modificato nel livello API 2.

Parametri

  • Livello API 1
    • fileUri: URI di un file da eliminare. Sono i produttori a decidere se utilizzare URI assoluti o relativi. I client possono considerarlo come un identificatore opaco.
  • Livello API 2
    • fileUrls: un elenco di URL assoluti relativi ai file da eliminare dalla fotocamera, ottenuti in precedenza, ad esempio dai comandi camera.listFiles o camera.takePicture. Esistono tre casi particolari:
      • L'elenco contiene solo la stringa "all": elimina tutti i file nella fotocamera.
      • L'elenco contiene solo la stringa "immagine": elimina tutte le immagini nella fotocamera.
      • L'elenco contiene solo la stringa "video": elimina tutti i video presenti nella videocamera.

Risultati

  • fileUrls: URL dei file che non sono stati eliminati correttamente. Tieni presente che questo accade quando tutti gli URL in fileUrl sono validi ma la fotocamera non riesce a eliminarli. Se uno qualsiasi degli URL non è valido, dovrebbe essere restituito il codice di errore invalidParameterValue senza eliminare alcun file. Questa funzionalità è stata aggiunta al livello API 2.

Errori

  • missingParameter: il valore fileUri non è stato specificato.
  • invalidParameterName: il nome del parametro di input non è riconosciuto.
  • invalidParameterValue: il nome del parametro di input è stato riconosciuto, ma il relativo valore non è valido. Ad esempio, fileUri non esiste nel livello API 1 oppure qualsiasi URL in fileUrls non esiste nel livello API 2.

I/O comando

Input dei comandi (livello API 1)
{
    "parameters": {
        "fileUri": "file URI"
    }
}
Output comando (livello API 1)
none
Output comando (errore) (livello API 1)
{
    "error": {
        "code": "invalidParameterName",
        "message": "Parameter XYZ is unrecognized."
    }
}
Input dei comandi (livello API 2)
{
    "parameters": {
        "fileUrls": [
            "url1",
            "url2",
            "url3",
            ...
            "urln"
        ]
    }
}
Output comando (livello API 2)
{
    "results": {
        "fileUrls": [
            "urln"
        ]
    }
}
Output comando (errore) (livello API 2)
{
    "error": {
        "code": "invalidParameterValue",
        "message": "Parameter url3 doesn't exist."
    }
}