camera.delete
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
使用指定 URI 刪除檔案。這個指令是在 API 級別 2 中修改。
參數
- API 級別 1
- fileUri:要刪除的檔案的 URI。製造商決定
是否使用絕對或相對 URI用戶端可能會將其視為不透明
或 ID。
- API 級別 2
結果
- fileUrls:未成功刪除的檔案網址。
請注意，如果 fileUrls 中的所有網址都有效，但相機無法正常運作，就會發生這個問題
刪除其中一些如有任何網址無效，錯誤代碼
傳回
invalidParameterValue 時，不應刪除任何檔案。
已新增至 API 級別 2。
錯誤
- missingParameter：未指定
fileUri。
- INVALIDParameterName：無法辨識輸入參數名稱。
- invalidParameterValue:：系統會識別輸入參數名稱，
但值無效；舉例來說，
fileUri 沒有
在 API 級別 1 中，或 fileUrls 中的任何網址不存在於 API 級別 2 中。
指令 I/O |
|---|
| 指令輸入 (API 級別 1) |
{
"parameters": {
"fileUri": "file URI"
}
} |
| 指令輸出 (API 級別 1) |
none |
| 指令輸出 (錯誤) (API 級別 1) |
{
"error": {
"code": "invalidParameterName",
"message": "Parameter XYZ is unrecognized."
}
} |
| 指令輸入 (API 級別 2) |
{
"parameters": {
"fileUrls": [
"url1",
"url2",
"url3",
...
"urln"
]
}
} |
| 指令輸出 (API 級別 2) |
{
"results": {
"fileUrls": [
"urln"
]
}
} |
| 指令輸出 (錯誤) (API 級別 2) |
{
"error": {
"code": "invalidParameterValue",
"message": "Parameter url3 doesn't exist."
}
} |
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2024-08-21 (世界標準時間)。
[null,null,["上次更新時間：2024-08-21 (世界標準時間)。"],[[["\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.\" } } ``` |"]]
