מתחיל צילום וידאו או צילום תמונה במרווחי זמן בהתאם לערך של 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
מאוחר יותר, כשחיבור חדש בין הלקוח למצלמה יהיה זמין.
- fileUrls: רשימה של כתובות URL מוחלטות, שמפנות לקובצי תמונה לצורך צילום במרווחים. חשוב לזכור שהפקודה הזו לא מחזירה
שגיאות
- DisableCommand: הפקודה מושבתת כרגע. לדוגמה, המצלמה נמצאת באמצע צילום וידאו או צילום מרווח.
- legalParameterName: שם הפרמטר לא מזוהה, לדוגמה:
sessionId
לא מזוהה.
Command I/O | |
---|---|
קלט פקודה | none |
פלט הפקודה | { "results": { "fileUrls":[ "url1", "url2", "url3", ... "urln" ] } } |
פלט הפקודה (שגיאה) | { "error": { "code": "disabledCommand", "message": "Command is currently disabled." } } |