מצלמה.מחיקה
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
מוחק קובץ בהתאם ל-URI שלו. הפקודה הזו שונתה ברמת API 2.
פרמטרים
- רמת API 1
- fileUri: ה-URI של הקובץ שרוצים למחוק. היצרן מחליטים
האם להשתמש ב-URI מוחלטים או יחסיים. הלקוחות עשויים להתייחס לתוכן הזה כאל אטום
למזהה נתון.
- רמת API 2
- fileUrls: רשימה של כתובות URL מוחלטות שהקבצים יימחקו
מהמצלמה, שהושגו קודם לכן, מתוך
camera.listFiles
או פקודות camera.takePicture. יש שלושה מקרים מיוחדים:
- הרשימה מכילה רק את המחרוזת 'הכול': מחיקת כל הקבצים במצלמה.
- הרשימה מכילה רק את המחרוזת "image": יש למחוק את כל התמונות
מצלמה.
- הרשימה מכילה רק את המחרוזת "video": מחיקת כל הסרטונים ב
מצלמה.
תוצאות
- fileUrls: כתובות ה-URL של קבצים שלא נמחקו בהצלחה.
חשוב לזכור: הפעולה הזו מתרחשת כשכל כתובות ה-URL ב-fileUrl תקינות אבל המצלמה לא פועלת.
למחוק חלק מהם. אם אחת מכתובות ה-URL לא תקינה, קוד שגיאה
צריך להחזיר
invalidParameterValue בלי למחוק אף קובץ.
התוסף נוסף ברמת API 2.
שגיאות
- missingParameter:
fileUri לא צוין.
- INVALIDParameterName: השם של פרמטר הקלט לא מזוהה.
- invalidParameterValue: השם של פרמטר הקלט מזוהה,
אבל הערך שלו לא חוקי. לדוגמה,
fileUri
קיימות ברמת API 1, או שאחת מכתובות ה-URL בכתובות ה-URL של קובצי fileUrl לא קיימת ברמת API 2.
Command 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."
}
} |
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2024-08-21 (שעון UTC).
[null,null,["עדכון אחרון: 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.\" } } ``` |"]]
