מצלמה.startCapture

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

פרמטרים

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

תוצאות

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

שגיאות

  • DisabledCommand: הפקודה מושבתת כרגע. לדוגמה, המצלמה נמצא באמצע צילום סרטון או צילום במרווח זמן.
  • INVALIDParameterName: שם הפרמטר לא מזוהה; לדוגמה, המערכת לא מזהה את sessionId.

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