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
ocamera.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.
- fileUrls: un elenco di URL assoluti relativi ai file da eliminare
dalla fotocamera, ottenuti in precedenza, ad esempio dai comandi
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." } } |