Usuwa plik o podanym identyfikatorze URI. To polecenie zostało zmodyfikowane na poziomie API 2.
Parametry
- Poziom API 1
- fileUri: identyfikator URI pliku do usunięcia. Producenci decydują, czy użyć bezwzględnych czy względnych identyfikatorów URI. Klienci mogą traktować go jako nieprzejrzysty identyfikator.
- Poziom API 2
- fileUrls: lista bezwzględnych adresów URL plików, które zostały uzyskane wcześniej, np. z poleceń
camera.listFiles
lubcamera.takePicture
, do usunięcia z aparatu. Występują 3 wyjątkowe przypadki:- Lista zawiera tylko ciąg „all”: powoduje usunięcie wszystkich plików z aparatu.
- Lista zawiera tylko ciąg „image”: usuń wszystkie zdjęcia z aparatu.
- Lista zawiera tylko ciąg „video”: usuń wszystkie filmy z kamery.
- fileUrls: lista bezwzględnych adresów URL plików, które zostały uzyskane wcześniej, np. z poleceń
Wyniki
- fileUrls: adresy URL plików, które nie zostały usunięte.
Dzieje się tak wtedy, gdy wszystkie adresy URL w pliku fileUrl są prawidłowe, ale aparat nie może usunąć niektórych z nich. Jeśli którykolwiek z adresów URL jest nieprawidłowy, kod błędu
invalidParameterValue
powinien zostać zwrócony bez usuwania pliku. Dodano tę funkcję w interfejsie API na poziomie 2.
Błędy
- missingParameter (brakujący parametr): nie określono
fileUri
. - ErrorParameterName: nie udało się rozpoznać nazwy parametru wejściowego.
- Nieprawidłowy parametr: nazwa parametru wejściowego została rozpoznana, ale jego wartość jest nieprawidłowa. Na przykład
fileUri
nie istnieje na poziomie interfejsu API 1 lub żaden adres URL z pliku fileUrls nie istnieje na poziomie 2 interfejsu API.
Command I/O | |
---|---|
Dane wejściowe (poziom interfejsu API 1) | { "parameters": { "fileUri": "file URI" } } |
Dane wyjściowe polecenia (poziom API 1) | none |
Dane wyjściowe polecenia (błąd) (poziom interfejsu API 1) | { "error": { "code": "invalidParameterName", "message": "Parameter XYZ is unrecognized." } } |
Dane wejściowe (poziom interfejsu API 2) | { "parameters": { "fileUrls": [ "url1", "url2", "url3", ... "urln" ] } } |
Dane wyjściowe polecenia (poziom API 2) | { "results": { "fileUrls": [ "urln" ] } } |
Dane wyjściowe polecenia (błąd) (poziom interfejsu API 2) | { "error": { "code": "invalidParameterValue", "message": "Parameter url3 doesn't exist." } } |