מצלמה.startCapture

מתחיל צילום וידאו או צילום תמונה במרווחי זמן בהתאם לערך של captureMode באפשרויות. הפקודה הזו נוספה ברמת API 2.

פרמטרים

  • פקודה זו לא מכילה פרמטר בגוף הבקשה. צילום תמונות במרווחים או צילום וידאו נקבעים באמצעות האפשרות captureMode. בצילום במרווחים, צילום במרווחי זמן יכול להיות תלוי בשאלה אם captureNumber שווה ל-0 או גדול מ-0. יש להגדיר את captureMode, captureInterval ו-captureNumber לפני צילום במרווחי זמן. יש להגדיר רק את captureMode כ-"video" לפני צילום הווידאו. ניתן לעצור את זה רק באמצעות הפקודה camera.stopCapture.

תוצאות

  • צילום במצב פתוח (כאשר captureMode == "video" או captureNumber == 0)
    • אין תוצאות.
  • צילום במרווחים לא פתוחים:
    • fileUrls: רשימה של כתובות URL מוחלטות, שמפנות לקובצי תמונה לצורך צילום במרווחים. חשוב לזכור שהפקודה הזו לא מחזירה fileUrls באופן מיידי, כי השלמת הצילום נמשכת captureNumber. כדי לעקוב אחרי התקדמות הפקודה, צריך לבצע דגימה תקופתית של המצלמה. לדוגמה, סקר לאחר משך זמן משוער (time = captureInterval * (captureNumber - 1)) באמצעות ה-API /osc/commands/status ו-fileUrls הוא התוצאה שמתקבלת בסיום הפקודה. אם הפקודה לא הסתיימה בהצלחה (למשל, רק 3 מתוך התמונות צולמו לפני שהסוללה התרוקנה) או שהמצלמה נותקה מהטלפון של הלקוח באמצע אבל הפקודה הסתיימה בהצלחה, הלקוח יוכל לקבל את התמונות באמצעות camera.listFiles מאוחר יותר, כשחיבור חדש בין הלקוח למצלמה יהיה זמין.

שגיאות

  • DisableCommand: הפקודה מושבתת כרגע. לדוגמה, המצלמה נמצאת באמצע צילום וידאו או צילום מרווח.
  • legalParameterName: שם הפרמטר לא מזוהה, לדוגמה: sessionId לא מזוהה.

Command I/O
קלט פקודה 
none
פלט הפקודה 
{
    "results": {
        "fileUrls":[
            "url1",
            "url2",
            "url3",
            ...
            "urln"
        ]
    }
}
פלט הפקודה (שגיאה) 
{
    "error": {
        "code": "disabledCommand",
        "message": "Command is currently disabled."
    }
}