aparat.usuń
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
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."
}
} |
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2024-08-21 UTC.
[null,null,["Ostatnia aktualizacja: 2024-08-21 UTC."],[[["\u003cp\u003eThe \u003ccode\u003edeleteFile\u003c/code\u003e command removes one or more files from the camera's storage.\u003c/p\u003e\n"],["\u003cp\u003eAPI level 1 uses \u003ccode\u003efileUri\u003c/code\u003e to specify a single file for deletion, while API level 2 uses \u003ccode\u003efileUrls\u003c/code\u003e to specify one or more files, or uses special values to delete all files, all images, or all videos.\u003c/p\u003e\n"],["\u003cp\u003eErrors are returned if parameters are missing, invalid, or if the specified files cannot be deleted.\u003c/p\u003e\n"],["\u003cp\u003eAPI level 2 introduced the \u003ccode\u003efileUrls\u003c/code\u003e parameter and the ability to return a list of unsuccessfully deleted files in the results.\u003c/p\u003e\n"]]],["This describes a command to delete files from a camera. In API level 1, it accepts a `fileUri` to delete a single file, where the URI's format is determined by the manufacturer. API level 2 was introduced to use the `fileUrls` parameter for multiple files, specified by absolute URLs. Special strings like \"all\", \"image\", or \"video\" delete all files, all images, or all videos. A list of `fileUrls` will return any files that did not delete correctly. Errors include invalid parameters or missing data.\n"],null,["# camera.delete\n\nDeletes a file given its URI. **This command was modified in API level 2.**\n\nParameters\n----------\n\n- **API level 1**\n - **fileUri:** URI of a file to delete. Manufacturers decide whether to use absolute or relative URIs. Clients may treat this as an opaque identifier.\n- **API level 2**\n - **fileUrls:** A list of absolute URLs for files to be deleted from the camera, which were obtained previously, e.g. from [camera.listFiles](/streetview/open-spherical-camera/reference/camera/listfiles) or [camera.takePicture](/streetview/open-spherical-camera/reference/camera/takepicture) commands. There are three special cases:\n - The list only contains string \"all\": delete all files in the camera.\n - The list only contains string \"image\": delete all images in the camera.\n - The list only contains string \"video\": delete all videos in the camera.\n\nResults\n-------\n\n- **fileUrls:** URLs of files that are not successfully deleted. Please note this happens when all the URLs in fileUrls are valid but camera fails to delete some of them. If any of the URLs is invalid, error code `invalidParameterValue` should be returned without deleting any file. **This was added in API level 2.**\n\nErrors\n------\n\n- **missingParameter:** `fileUri` not specified.\n- **invalidParameterName:** The input parameter name is unrecognized.\n- **invalidParameterValue:** The input parameter name is recognized, but its value is invalid; for example, the `fileUri` doesn't exist in API level 1 or any URL in fileUrls doesn't exist in API level 2.\n\n| Command I/O ----------- ||\n|------------------------------------------|----------------------------------------------------------------------------------------------------------|\n| **Command Input (API level 1)** | ```text { \"parameters\": { \"fileUri\": \"file URI\" } } ``` |\n| **Command Output (API level 1)** | ```text none ``` |\n| **Command Output (Error) (API level 1)** | ```text { \"error\": { \"code\": \"invalidParameterName\", \"message\": \"Parameter XYZ is unrecognized.\" } } ``` |\n| **Command Input (API level 2)** | ```text { \"parameters\": { \"fileUrls\": [ \"url1\", \"url2\", \"url3\", ... \"urln\" ] } } ``` |\n| **Command Output (API level 2)** | ```text { \"results\": { \"fileUrls\": [ \"urln\" ] } } ``` |\n| **Command Output (Error) (API level 2)** | ```text { \"error\": { \"code\": \"invalidParameterValue\", \"message\": \"Parameter url3 doesn't exist.\" } } ``` |"]]
