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

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

פרמטרים

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

תוצאות

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

שגיאות

  • הפקודה מושבתת: אם לא תומכים בעיבוד מושהה.
  • falseParameterName: השם של פרמטר הקלט הוא לא מזוהה.
  • invalidParameterValue: שם פרמטר הקלט הוא מזוהה, אבל הערך שלו לא חוקי. לדוגמה, כל כתובת 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."
    }
}