מצלמה.מחיקה

מוחק קובץ שניתן לו ה-URI שלו. הפקודה הזו שונתה ב-API ברמת 2.

פרמטרים

  • API ברמה 1
    • fileUri: URI של קובץ למחיקה. היצרנים מחליטים אם להשתמש במזהי URI מוחלטים או יחסיים. לקוחות עשויים להתייחס למזהה הזה כמזהה אטום.
  • API ברמה 2
    • fileUrls: רשימה של כתובות URL מוחלטות שבהן יימחקו מהמצלמה, הושגו בעבר, למשל מהפקודות camera.listFiles או מהפקודות camera.takePicture. יש שלושה מקרים מיוחדים:
      • הרשימה מכילה רק את המחרוזת "הכול": מוחקים את כל הקבצים מהמצלמה.
      • הרשימה מכילה רק את המחרוזת "image": מחיקת כל התמונות במצלמה.
      • הרשימה מכילה רק את המחרוזת "video": מחיקת כל הסרטונים במצלמה.

תוצאות

  • fileUrls: כתובות URL של קבצים שלא נמחקו בהצלחה. שימו לב שזה קורה כשכל כתובות ה-URL תקינות, אבל המצלמה לא מצליחה למחוק חלק מהן. אם אחת מכתובות ה-URL לא תקינה, צריך להחזיר את קוד השגיאה invalidParameterValue בלי למחוק אף קובץ. ההוספה הזו נוספה ברמת API 2.

שגיאות

  • missingParameter: fileUri לא צוין.
  • legalParameterName: השם של פרמטר הקלט לא מזוהה.
  • invalidParameterValue: השם של פרמטר הקלט מזוהה, אבל הערך שלו לא חוקי. לדוגמה, ה-fileUri לא קיים ברמת API 1, או שכתובת URL כלשהי ב-fileUrls לא קיימת ברמת 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."
    }
}