aparat.usuń

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 lub camera.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.

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."
    }
}