aparat.usuń

Usuwa plik o podanym identyfikatorze URI. To polecenie zostało zmienione na poziomie interfejsu API 2.

Parametry

  • Poziom API 1
    • fileUri: identyfikator URI pliku do usunięcia. Decyzja producenta czy należy użyć bezwzględnych czy względnych identyfikatorów URI. Klienci mogą traktować tę wartość jako nieprzejrzystą.
  • Poziom 2 interfejsu API
    • fileUrls: lista bezwzględnych adresów URL plików do usunięcia. z kamery, które zostały zebrane wcześniej, np. od camera.listFiles lub camera.takePicture. Istnieją 3 wyjątkowe przypadki:
      • Lista zawiera tylko ciąg „all”: usuń wszystkie pliki z kamery.
      • Lista zawiera tylko ciąg „image”: usuń wszystkie obrazy z aparat fotograficzny.
      • Lista zawiera tylko ciąg „video”: usuń wszystkie filmy z aparat fotograficzny.

Wyniki

  • fileUrls: adresy URL plików, których nie udało się usunąć. Uwaga: dzieje się tak, gdy wszystkie adresy URL w parametrach fileUrl są prawidłowe, ale kamera nie działa aby usunąć niektóre z nich. Jeśli dowolny z adresów URL jest nieprawidłowy, kod błędu Metoda invalidParameterValue powinna zostać zwrócona bez usuwania żadnego pliku. Ta funkcja została dodana na poziomie interfejsu API 2.

Błędy

  • missingParameter (brak parametru): nie określono parametru fileUri.
  • invalidParametrName:nie udało się rozpoznać nazwy parametru wejściowego.
  • invalidParameterValue::nazwa parametru wejściowego została rozpoznana, , ale jego wartość jest nieprawidłowa; na przykład fileUri nie występują na poziomie API 1 lub żaden adres URL w polu fileUrls nie istnieje na poziomie API 2.

Polecenie I/O
Dane wejściowe polecenia (poziom interfejsu API 1) 
{
    "parameters": {
        "fileUri": "file URI"
    }
}
Dane wyjściowe polecenia (poziom interfejsu API 1) 
none
Dane wyjściowe polecenia (błąd) (poziom interfejsu API 1) 
{
    "error": {
        "code": "invalidParameterName",
        "message": "Parameter XYZ is unrecognized."
    }
}
Dane wejściowe polecenia (poziom interfejsu API 2) 
{
    "parameters": {
        "fileUrls": [
            "url1",
            "url2",
            "url3",
            ...
            "urln"
        ]
    }
}
Dane wyjściowe polecenia (poziom interfejsu API 2) 
{
    "results": {
        "fileUrls": [
            "urln"
        ]
    }
}
Dane wyjściowe polecenia (błąd) (poziom interfejsu API 2) 
{
    "error": {
        "code": "invalidParameterValue",
        "message": "Parameter url3 doesn't exist."
    }
}