Elimina un file dato il suo URI. 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 clienti possono trattare il prodotto come un'immagine identificativo dell'utente.
- Livello API 2
- .
- fileUrls: un elenco di URL assoluti per i file da eliminare.
dalla fotocamera, ottenuti in precedenza, ad es. da
camera.listFiles
ocamera.takePicture
. Esistono tre casi speciali:- L'elenco contiene solo la stringa "all": elimina tutti i file nella fotocamera.
- L'elenco contiene solo la stringa "image": elimina tutte le immagini nell' fotocamera.
- L'elenco contiene solo la stringa "video": elimina tutti i video nella fotocamera.
- fileUrls: un elenco di URL assoluti per i file da eliminare.
dalla fotocamera, ottenuti in precedenza, ad es. da
Risultati
- fileUrls::URL dei file che non sono stati eliminati correttamente.
Questo accade quando tutti gli URL in fileUrls sono validi ma la fotocamera non funziona
per eliminarne alcune. Se uno degli URL non è valido, il codice di errore
invalidParameterValue
deve essere restituito senza eliminare alcun file. Questa opzione è stata aggiunta al livello API 2.
Errori
- missingParameter:
fileUri
non specificato. - invalidParameterName:nome del parametro di input non riconosciuto.
- invalidParameterValue: il nome del parametro di input è riconosciuto,
ma il suo valore non è valido; ad esempio,
fileUri
esistono nel livello API 1 oppure qualsiasi URL in fileUrls non esiste nel livello API 2.
I/O comando | |
---|---|
Input comando (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 comando (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." } } |