מצלמים תמונה מלבנית, ושומרים קואורדינטות של קווי אורך ורוחב ב-EXIF (אם במצלמה יש GPS או GPS משלה מופעלים בטלפונים ניידים מחוברים). אם צריך, אפשר להתקשר למספר camera.setOptions
לפני שיחת הפקודה הזו. הפקודה הזו שונתה ב-API ברמת 2.
פרמטרים
- sessionId: מזהה סשן ייחודי שהתקבל מהפקודה
camera.startSession
. השדה הזה הוצא משימוש ברמת API 2.
תוצאות
- API ברמה 1
- fileUri: URI של התמונה שצולמה. היצרנים מחליטים אם להשתמש ב-URI מוחלט או יחסי. לדוגמה, "http://android.com/robots.txt" הוא מזהה URI מוחלט, בעוד ש-"robots.txt" הוא URI יחסי. לקוחות עשויים להתייחס למידע הזה כמזהה אטום.
- API ברמה 2
- fileUrl: כתובת ה-URL המוחלטת של התמונה שצולמה, שניתן להשתמש בה כדי להוריד ישירות משרת ה-HTTP של המצלמה. חשוב לזכור שהפקודה הזו לא מחזירה
fileUrl
באופן מיידי, כי תהליך הצילום (כולל חיבור במצלמה) נמשך בדרך כלל זמן מה (בין שניות לדקות). כדי להתקדם בפקודה, צריך לבצע דגימה תקופתית של המצלמה באמצעות ה-API /osc/commands/status ו-fileUrl
היא התוצאה שמתקבלת בסיום הפקודה. כשהערךdelayProcessing
הוא TRUE, מדובר בכתובת ה-URL המוחלטת של תמונת התצוגה המקדימה, שאפשר להשתמש בה כקלט ב-cessImage כדי לעבד את התמונה, אחרת זו כתובת ה-URL המוחלטת של התמונה הסופית שמעובדת.
- fileUrl: כתובת ה-URL המוחלטת של התמונה שצולמה, שניתן להשתמש בה כדי להוריד ישירות משרת ה-HTTP של המצלמה. חשוב לזכור שהפקודה הזו לא מחזירה
שגיאות
- missingParameter:
sessionId
חסר. קוד השגיאה הזה הוצא משימוש ברמת API 2. - legalParameterName: שם הפרמטר לא מזוהה, למשל
sessionId
לא מזוהה ברמת API 2. - invalidParameterValue: השם של פרמטר הקלט מזוהה, אבל הערך שלו לא חוקי. לדוגמה,
sessionId
לא קיים, לא פעיל יותר או שסוג הנתונים שגוי. קוד השגיאה הזה הוצא משימוש ברמת API 2. - DisableCommand: הפקודה מושבתת כרגע. לדוגמה, המצלמה נמצאת במצב צילום וידאו. קוד השגיאה הזה התווסף ברמת API 2.
Command I/O | |
---|---|
קלט פקודה (רמת API 1) | { "parameters": { "sessionId": "12ABC3" } } |
פלט הפקודה (רמת API 1) | { "results": { "fileUri": "file URI" } } |
פלט הפקודה (שגיאה) (רמת API 1) | { "error": { "code": "invalidParameterValue", "message": "Parameter sessionId doesn't exist." } } |
קלט פקודה (רמת API 2) | none |
פלט הפקודה (רמת API 2) | { "results": { "fileUrl": "Absolute file URL" } } |
פלט הפקודה (שגיאה) (רמת API 2) | { "error": { "code": "disabledCommand", "message": "Command is currently disabled." } } |