מצלמה.מחיקה

מוחק קובץ בהתאם ל-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."
    }
}