מצלמה.עיבוד תמונה

תמונות בעיבוד שצולמו בעבר, אבל עדיין לא עובדו. הפקודה רלוונטית רק אם יש תמיכה ב-delayProcessing כי העיבוד נמשך זמן רב. אם אין תמיכה ב-delayProcessing, הבקשה לפקודה הזו אמורה להיכשל ומוצג קוד השגיאה disabledCommand. הפקודה הזו נוספה ברמת API 2.

פרמטרים

  • previewFileUrls:רשימה של כתובות URL של תמונות שלא עובדו. אם רוצים לעבד את כל התמונות שלא עובדו במצלמה, צריך להזין ['הכול']. לא ניתן להשאיר את השדה ריק. אם יש בעיה בעיבוד תמונה כלשהי, המצלמה לא תגיב עם שגיאה. במקום זאת, צריך להתעלם מכתובת ה-URL הזו ולהמשיך עם אחרות, ובמקרה הקיצוני – previewToFinalFileUrls יוחזר כ-JSONObject ריק.

תוצאות

  • previewToFinalFileUrls: JSONObject של JSON <key, value=""> מתאים שבו כל מפתח הוא כתובת ה-URL המוחלטת של תמונת התצוגה המקדימה, וכל מפתח הוא התמונה המתאימה הסופית שעברה עיבוד, ואפשר להשתמש בו כדי להוריד אותו ישירות מהמצלמה. חשוב לשים לב שהפקודה הזו דומה ל-camera.takepicture, והיא לא מחזירה previewToFinalFileUrls מיד (חוץ מאשר בתרחיש פינתי שיסביר בהמשך בפסקה זו), כי תהליך העיבוד (כולל רצף תמונות במצלמה) נמשך בדרך כלל זמן רב (מספר שניות לדקות). ההתקדמות בפקודה מתקבלת באמצעות דגימה תקופתית של המצלמה באמצעות ה-API /osc/commands/status ו-previewToFinalFileUrls היא התוצאה שמוחזרת בסיום הפקודה. אם החיבור למצלמה מתנתק לפני סיום הפקודה, הלקוח יכול להשתמש ב-listFiles כדי להשיג את כתובות ה-URL של התמונות הסופיות כשמחוברים שוב למצלמה, או להפק פקודת workImage נוספת, שאמורה להחזיר את previewToFinalFileUrls באופן מיידי אם התמונות כבר עובדו לפני החיבור מחדש.</key,>

שגיאות

  • DisableCommand: אם אתם לא תומכים בעיכוב עיבוד.
  • legalParameterName: השם של פרמטר הקלט לא מזוהה.
  • legalParameterValue: השם של פרמטר הקלט מזוהה, אבל הערך שלו לא חוקי. לדוגמה, כל כתובת URL ב-previewFileUrls לא חוקית.

Command I/O
קלט פקודה 
{
    "parameters": {
        "previewFileUrls": [
            "previewFileUrl1",
            "previewFileUrl2",
            "previewFileUrl3",
            ...
            "previewFileUrln"
        ]
    }
}
פלט הפקודה 
{
    "results": {
        "previewToFinalFileUrls":{
            "previewFileUrl1": "finalFileUrl1",
            "previewFileUrl2": "finalFileUrl2",
            "previewFileUrl3": "finalFileUrl3",
            ...
            "previewFileUrln": "finalFileUrln"
        }
    }
}
פלט הפקודה (שגיאה) 
{
    "error": {
        "code": "disabledCommand",
        "message": "Command is currently disabled."
    }
}